`wrap_module` has limitations with relative imports about configzen

[bswck]

Thanks for reporting the issue.

tl;dr: You cannot perform relative imports directly from the __main__ module. Relative imports are only relative in a package. This is not a limitation nor a bug from configzen, but a natural and correct behavior of Python.

The provided example would not work even if the package argument was not None, because the conf.py module is not in the same directory as the my_config.py module. You would have to import ..my_config instead of .my_config.
I am guessing you meant Test.wrap_module("..my_config") and the further explanation is based on this claim.

When executing repro/module/conf.py directly, it is impossible to relatively import repro/my_config.py and that's just fine, because there is no parent package known to __main__. You could probably, however, absolutely-import it:
Please cd /home/zero/Desktop/Projects/Python/.

1. Change the 8th line in repro/module/conf.py to Test.wrap_module("repro.my_config").
   Execute PYTHONPATH=. && python3 repro/module/conf.py. There should be no error.
2. Change the 8th line in repro/module/conf.py to Test.wrap_module("my_config").
   Execute PYTHONPATH=repo && python3 repro/module/conf.py. There should be no error, too.

(See PYTHONPATH documentation here. I change its value to influence sys.path, the reference list to resolving any imports in Python; usually people would think it's just the current working directory, but it doesn't have to be, that's why sometimes they might stumble across a seemingly impossible path-related issue which can be fixed the fastest way by adjusting PYTHONPATH.)

If you want to wrap my_config.py using a relative import in the described case, you must apply the rule that relative imports are only relative in a package. Hence, you cannot run repro/module/conf.py directly, but you need to import it instead.

Follow these steps:

1. Change the 8th line in repro/module/conf.py to the desired Test.wrap_module("..my_config").
2. Add main.py (or any other name) module in the parent package (parent-parent to repro/module/conf.py), i.e. repro/. Your tree should look like this now:

   .
   ├── module
   │   └── conf.py
   ├── main.py
   └── my_config.py
   

3. In main.py, place

   from repro.module import conf
   
   from repro import my_config  # Enjoy your wrapped module!

4. cd /home/zero/Desktop/Projects/Python/ && export PYTHONPATH=. && python3 repro/main.py.

Of course, that's not all. This structure could be contained inside thousands of directories, where the __main__ package is on top of it. And it would still work, though more readable with relative imports inside the innermost modules then.

I hope that helps. If you have any questions, let me know.

[bswck]

I'm closing this issue for now, but we may still chat here.