envwrap 0.2.0__tar.gz → 0.3.0__tar.gz

{envwrap-0.2.0 → envwrap-0.3.0}/.github/workflows/test.yml

@@ -69,6 +69,6 @@ jobs:
       run: |
         changelog=$(git log --pretty='format:%d%n- %s%n%b---' $(git tag --sort=v:refname | tail -n2 | head -n1)..HEAD)
         tag="${GITHUB_REF#refs/tags/}"
-        gh release create --title "tqdm $tag stable" --draft --notes "$changelog" "$tag" dist/${{ steps.dist.outputs.whl }} dist/${{ steps.dist.outputs.whl_asc }}
+        gh release create --title "envwrap $tag beta" --draft --notes "$changelog" "$tag" dist/${{ steps.dist.outputs.whl }}
       env:
         GH_TOKEN: ${{ secrets.GH_TOKEN }}

{envwrap-0.2.0 → envwrap-0.3.0}/.pre-commit-config.yaml

@@ -30,7 +30,7 @@ repos:
     name: pytest
     language: python
     entry: env PYTHONPATH=. pytest
-    args: [--cov=envwrap]
+    args: [--cov=envwrap, -vv]
     types: [python]
     pass_filenames: false
     additional_dependencies:

{envwrap-0.2.0 → envwrap-0.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: envwrap
-Version: 0.2.0
+Version: 0.3.0
 Summary: Override parameter defaults via environment variables & config files
 Maintainer-email: tqdm developers <devs@tqdm.ml>
 License: MPL-2.0
@@ -39,6 +39,10 @@ Dynamic: license-file
 [![codecov](https://codecov.io/gh/tqdm/envwrap/graph/badge.svg?token=PEWICBIPVW)](https://codecov.io/gh/tqdm/envwrap)
 [![codacy](https://app.codacy.com/project/badge/Grade/6ca7a441560444489fd5c5b1548ab0de)](https://app.codacy.com/gh/tqdm/envwrap/dashboard)
 
+[![releases](https://img.shields.io/pypi/v/envwrap.svg?label=changelog)](https://github.com/tqdm/envwrap/releases)
+[![pypi/envwrap](https://img.shields.io/pypi/pyversions/envwrap.svg?logo=python&logoColor=white)](https://pypi.org/project/envwrap)
+[![conda-forge::envwrap](https://img.shields.io/conda/v/conda-forge/envwrap.svg?label=conda-forge&logo=conda-forge)](https://anaconda.org/conda-forge/envwrap)
+
 Override parameter defaults via environment variables & config files.
 
 ```py
@@ -60,10 +64,61 @@ Precedence (descending):
   - [platformdirs](https://platformdirs.readthedocs.io/en/latest/parameters.html).{user,site}_config_path(name, False)/
     - `{app}.{toml,yaml,yml,json,ini,cfg}::{func.a,a}`
     - `{name}.{toml,yaml,yml,json,ini,cfg}::{app.func.a,func.a,app.a,a}`
+  - ./`pyproject.toml::tool.name.{app.func.a,func.a,app.a,a}`
 - signature (`def foo(a=1)`)
 
+## Installation
+
+Any one of:
+
+- `pip install envwrap`
+- `conda install -c conda-forge envwrap`
+- `pip install "git+https://github.com/tqdm/envwrap@main"`
+
+> [!TIP]
+> Note that [`tqdm`](https://github.com/tqdm/tqdm) ships with a basic [`tqdm.utils.envwrap`](https://tqdm.github.io/docs/tqdm.utils/#envwrap), which falls back to the original env-var-only (no config file support) implementation if `import envwrap` fails.
+
 ## Advanced Usage
 
+### CLI integration
+
+```py
+"""CLI example program using envwrap for configuration management.
+
+Usage:
+  myapp.py [options] <arg1> [<arg2>]
+
+Options:
+  -h, --help    Show this help message and exit.
+  -o=<value>, --option=<value>  An option [default: foo].
+
+Arguments:
+  <arg1>         An argument.
+  <arg2>         An integer argument [default: 2:int].
+
+Defaults above may be overridden by environment variables or config files:
+- `MYAPP[_CLI]_*`
+- `{.,~/.config/myapp,/etc/xdg/myapp}/myapp[/cli].{toml,yml,json,ini}::[cli.]*`
+- `pyproject.toml::tool.myapp[.cli]*`
+"""
+import argopt, shtab, envwrap
+
+ONLY_PASS_VALID = True # trim envwrap defaults based on parser's valid actions
+
+if __name__ == "__main__":
+    parser = argopt.argopt(__doc__)
+    shtab.add_argument_to(parser)
+
+    defaults = envwrap.get_defaults("myapp", "", "cli")
+    if ONLY_PASS_VALID:
+        valid = {i.dest for i in parser._actions}
+        defaults = {k: defaults[k] for k in defaults.keys() & valid}
+
+    parser.set_defaults(**defaults)
+    args = parser.parse_args()
+    print(args)
+```
+
 ### Live-reload
 
 To force re-reading config files & environment variables without restarting the process:

envwrap-0.3.0/README.md

@@ -0,0 +1,120 @@
+# envwrap
+
+[![CI](https://github.com/tqdm/envwrap/actions/workflows/test.yml/badge.svg)](https://github.com/tqdm/envwrap/actions/workflows/test.yml)
+[![coveralls](https://img.shields.io/coveralls/github/tqdm/envwrap/main?logo=coveralls)](https://coveralls.io/github/tqdm/envwrap)
+[![codecov](https://codecov.io/gh/tqdm/envwrap/graph/badge.svg?token=PEWICBIPVW)](https://codecov.io/gh/tqdm/envwrap)
+[![codacy](https://app.codacy.com/project/badge/Grade/6ca7a441560444489fd5c5b1548ab0de)](https://app.codacy.com/gh/tqdm/envwrap/dashboard)
+
+[![releases](https://img.shields.io/pypi/v/envwrap.svg?label=changelog)](https://github.com/tqdm/envwrap/releases)
+[![pypi/envwrap](https://img.shields.io/pypi/pyversions/envwrap.svg?logo=python&logoColor=white)](https://pypi.org/project/envwrap)
+[![conda-forge::envwrap](https://img.shields.io/conda/v/conda-forge/envwrap.svg?label=conda-forge&logo=conda-forge)](https://anaconda.org/conda-forge/envwrap)
+
+Override parameter defaults via environment variables & config files.
+
+```py
+import envwrap
+
+@envwrap.envwrap("name", "app")
+def func(a=1):
+    ...
+```
+
+Precedence (descending):
+
+- call (`func(a=3)`)
+- environment (`NAME_APP_FUNC_A=2`, `NAME_FUNC_A=2`, `NAME_APP_A=2`, `NAME_A=2`)
+  - `UPPER_CASE` env vars -> `lower_case` param names
+  - other cases aren't supported because Windows ignores case
+- config file:
+  - ./`{name}.{toml,yaml,yml,json,ini,cfg}::{app.func.a,func.a,app.a,a}`
+  - [platformdirs](https://platformdirs.readthedocs.io/en/latest/parameters.html).{user,site}_config_path(name, False)/
+    - `{app}.{toml,yaml,yml,json,ini,cfg}::{func.a,a}`
+    - `{name}.{toml,yaml,yml,json,ini,cfg}::{app.func.a,func.a,app.a,a}`
+  - ./`pyproject.toml::tool.name.{app.func.a,func.a,app.a,a}`
+- signature (`def foo(a=1)`)
+
+## Installation
+
+Any one of:
+
+- `pip install envwrap`
+- `conda install -c conda-forge envwrap`
+- `pip install "git+https://github.com/tqdm/envwrap@main"`
+
+> [!TIP]
+> Note that [`tqdm`](https://github.com/tqdm/tqdm) ships with a basic [`tqdm.utils.envwrap`](https://tqdm.github.io/docs/tqdm.utils/#envwrap), which falls back to the original env-var-only (no config file support) implementation if `import envwrap` fails.
+
+## Advanced Usage
+
+### CLI integration
+
+```py
+"""CLI example program using envwrap for configuration management.
+
+Usage:
+  myapp.py [options] <arg1> [<arg2>]
+
+Options:
+  -h, --help    Show this help message and exit.
+  -o=<value>, --option=<value>  An option [default: foo].
+
+Arguments:
+  <arg1>         An argument.
+  <arg2>         An integer argument [default: 2:int].
+
+Defaults above may be overridden by environment variables or config files:
+- `MYAPP[_CLI]_*`
+- `{.,~/.config/myapp,/etc/xdg/myapp}/myapp[/cli].{toml,yml,json,ini}::[cli.]*`
+- `pyproject.toml::tool.myapp[.cli]*`
+"""
+import argopt, shtab, envwrap
+
+ONLY_PASS_VALID = True # trim envwrap defaults based on parser's valid actions
+
+if __name__ == "__main__":
+    parser = argopt.argopt(__doc__)
+    shtab.add_argument_to(parser)
+
+    defaults = envwrap.get_defaults("myapp", "", "cli")
+    if ONLY_PASS_VALID:
+        valid = {i.dest for i in parser._actions}
+        defaults = {k: defaults[k] for k in defaults.keys() & valid}
+
+    parser.set_defaults(**defaults)
+    args = parser.parse_args()
+    print(args)
+```
+
+### Live-reload
+
+To force re-reading config files & environment variables without restarting the process:
+
+```py
+envwrap.get_defaults.cache_clear()
+```
+
+### Debugging
+
+A CLI tool can print defaults. For example, with this config:
+
+```toml
+# config file: foo.toml
+[test]
+a = 1337
+b = 2
+```
+
+```sh
+python -m envwrap --help
+FOO_A=42 python -m envwrap foo test
+```
+
+will print:
+
+```py
+>>> @envwrap.envwrap('foo', '')
+>>> def test(...):
+...    ...
+will use defaults:
+{'a': '42', 'b': 2, ...}
+```

{envwrap-0.2.0 → envwrap-0.3.0}/envwrap/__init__.py

@@ -20,26 +20,26 @@ log = logging.getLogger(__name__)
 def read_config(fpath: PurePath) -> dict:
     log.debug("Reading: %s", fpath)
     ext = fpath.suffix.lower()[1:]
-    if ext == "toml":
+    if ext == 'toml':
         try:
             from tomllib import loads  # py>=3.11
         except ModuleNotFoundError:
             from toml import loads
-    elif ext in ("yaml", "yml"):
+    elif ext in ('yaml', 'yml'):
         from yaml import safe_load as loads
-    elif ext == "json":
+    elif ext == 'json':
         from json import loads
-    elif ext in ("ini", "cfg"):
+    elif ext in ('ini', 'cfg'):
         from configparser import ConfigParser
         parser = ConfigParser()
         parser.read_string(fpath.read_text())
-        res = {sec: dict(parser.items(sec)) for sec in parser.sections() if sec.count(".") == 0}
+        res = {sec: dict(parser.items(sec)) for sec in parser.sections() if sec.count('.') == 0}
         for sec in parser.sections():
-            if sec.count(".") == 1:
-                parent, child = sec.split(".", 1)
+            if sec.count('.') == 1:
+                parent, child = sec.split('.', 1)
                 res.setdefault(parent, {}).setdefault(child, {})
                 res[parent][child] |= parser.items(sec)
-            elif sec.count(".") > 1:
+            elif sec.count('.') > 1:
                 warn(f"Skipping nested section: {sec}", UserWarning, stacklevel=2)
         return res
     else:
@@ -53,6 +53,19 @@ def get_defaults(name: str, app: str, func: str):
     """In-memory (functools.cache) of overrides extracted from config files & env vars."""
     conf = PlatformDirs(name, False)
     overrides = {}
+    log.debug("Searching in pyproject.toml::tool.%s", name)
+    if (fpath := Path("pyproject.toml")).is_file():
+        try:
+            cfg = read_config(fpath).get('tool', {}).get(name, {})
+            overrides.update(cfg)
+            if app in cfg:
+                overrides.update(cfg[app])
+            if func in cfg:
+                overrides.update(cfg[func])
+            if app in cfg and func in cfg[app]:
+                overrides.update(cfg[app][func])
+        except Exception as exc:
+            log.debug(f"Exception ignored: {exc}")
     for pth, base in (
         (conf.site_config_path, name),
         (conf.site_config_path, app),
@@ -107,6 +120,7 @@ def envwrap(name: str, app: str = "", types: dict = None, is_method=False):
         - platformdirs.{user,site}_config_path(name, False)/
             - `{app}.{toml,yaml,yml,json,ini,cfg}::{func.a,a}`
             - `{name}.{toml,yaml,yml,json,ini,cfg}::{app.func.a,func.a,app.a,a}`
+        - ./`pyproject.toml::tool.name.{app.func.a,func.a,app.a,a}`
     - signature (`def foo(a=1)`)
 
     Parameters
@@ -144,9 +158,9 @@ def envwrap(name: str, app: str = "", types: dict = None, is_method=False):
 
     def wrap(func):
         params = signature(func).parameters
-        env_overrides = get_defaults(name, app, func.__name__)
-        # ignore unknown env vars
-        overrides = {k: v for k, v in env_overrides.items() if k in params}
+        defaults = get_defaults(name, app, func.__name__)
+        # ignore unknown params
+        overrides = {k: v for k, v in defaults.items() if k in params}
         log.debug("Loaded overrides for %s: %s", func.__name__, overrides)
         # infer overrides' `type`s
         for k in overrides:

{envwrap-0.2.0 → envwrap-0.3.0}/envwrap.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: envwrap
-Version: 0.2.0
+Version: 0.3.0
 Summary: Override parameter defaults via environment variables & config files
 Maintainer-email: tqdm developers <devs@tqdm.ml>
 License: MPL-2.0
@@ -39,6 +39,10 @@ Dynamic: license-file
 [![codecov](https://codecov.io/gh/tqdm/envwrap/graph/badge.svg?token=PEWICBIPVW)](https://codecov.io/gh/tqdm/envwrap)
 [![codacy](https://app.codacy.com/project/badge/Grade/6ca7a441560444489fd5c5b1548ab0de)](https://app.codacy.com/gh/tqdm/envwrap/dashboard)
 
+[![releases](https://img.shields.io/pypi/v/envwrap.svg?label=changelog)](https://github.com/tqdm/envwrap/releases)
+[![pypi/envwrap](https://img.shields.io/pypi/pyversions/envwrap.svg?logo=python&logoColor=white)](https://pypi.org/project/envwrap)
+[![conda-forge::envwrap](https://img.shields.io/conda/v/conda-forge/envwrap.svg?label=conda-forge&logo=conda-forge)](https://anaconda.org/conda-forge/envwrap)
+
 Override parameter defaults via environment variables & config files.
 
 ```py
@@ -60,10 +64,61 @@ Precedence (descending):
   - [platformdirs](https://platformdirs.readthedocs.io/en/latest/parameters.html).{user,site}_config_path(name, False)/
     - `{app}.{toml,yaml,yml,json,ini,cfg}::{func.a,a}`
     - `{name}.{toml,yaml,yml,json,ini,cfg}::{app.func.a,func.a,app.a,a}`
+  - ./`pyproject.toml::tool.name.{app.func.a,func.a,app.a,a}`
 - signature (`def foo(a=1)`)
 
+## Installation
+
+Any one of:
+
+- `pip install envwrap`
+- `conda install -c conda-forge envwrap`
+- `pip install "git+https://github.com/tqdm/envwrap@main"`
+
+> [!TIP]
+> Note that [`tqdm`](https://github.com/tqdm/tqdm) ships with a basic [`tqdm.utils.envwrap`](https://tqdm.github.io/docs/tqdm.utils/#envwrap), which falls back to the original env-var-only (no config file support) implementation if `import envwrap` fails.
+
 ## Advanced Usage
 
+### CLI integration
+
+```py
+"""CLI example program using envwrap for configuration management.
+
+Usage:
+  myapp.py [options] <arg1> [<arg2>]
+
+Options:
+  -h, --help    Show this help message and exit.
+  -o=<value>, --option=<value>  An option [default: foo].
+
+Arguments:
+  <arg1>         An argument.
+  <arg2>         An integer argument [default: 2:int].
+
+Defaults above may be overridden by environment variables or config files:
+- `MYAPP[_CLI]_*`
+- `{.,~/.config/myapp,/etc/xdg/myapp}/myapp[/cli].{toml,yml,json,ini}::[cli.]*`
+- `pyproject.toml::tool.myapp[.cli]*`
+"""
+import argopt, shtab, envwrap
+
+ONLY_PASS_VALID = True # trim envwrap defaults based on parser's valid actions
+
+if __name__ == "__main__":
+    parser = argopt.argopt(__doc__)
+    shtab.add_argument_to(parser)
+
+    defaults = envwrap.get_defaults("myapp", "", "cli")
+    if ONLY_PASS_VALID:
+        valid = {i.dest for i in parser._actions}
+        defaults = {k: defaults[k] for k in defaults.keys() & valid}
+
+    parser.set_defaults(**defaults)
+    args = parser.parse_args()
+    print(args)
+```
+
 ### Live-reload
 
 To force re-reading config files & environment variables without restarting the process:

envwrap-0.3.0/tests/test_envwrap.py

@@ -0,0 +1,146 @@
+import os
+import shutil
+from pathlib import Path
+from sys import version_info
+from textwrap import dedent
+
+import pytest
+
+from envwrap import cli, envwrap, get_defaults
+
+
+def write_config(fpath, cfg):
+    ext = fpath.suffix.lower()[1:]
+    fpath.parent.mkdir(parents=True, exist_ok=True)
+    if ext == 'toml':
+        from toml import dumps
+    elif ext in ('yaml', 'yml'):
+        from yaml import safe_dump as dumps
+    elif ext == 'json':
+        from json import dumps
+    elif ext in ('ini', 'cfg'):
+        from configparser import ConfigParser
+        parser = ConfigParser()
+        for sec, items in cfg.items():
+            parser[sec] = {k: v for k, v in items.items() if not isinstance(v, dict)}
+            for subsec, subitems in items.items():
+                if isinstance(subitems, dict):
+                    parser[f"{sec}.{subsec}"] = subitems
+        with fpath.open('w') as fd:
+            return parser.write(fd)
+    else:
+        raise TypeError(f"Unsupported config filetype: {fpath}")
+    fpath.write_text(dumps(cfg))
+
+
+@pytest.fixture(autouse=True)
+def set_env():
+    os.environ['ENVWRAP_B'] = "42"
+    os.environ['ENVWRAP_C'] = "1337"
+    os.environ['ENVWRAP_TESTENV_D'] = "360"
+    os.environ['ENVWRAP_FUNCNAME_E'] = "101"
+    os.environ['ENVWRAP_TESTENV_FUNCNAME_F'] = "404"
+    get_defaults.cache_clear()
+
+
+def funcname(a: int = None, b=2, c=3, d=4, e=5, f=6):
+    return {'a': a, 'b': b, 'c': c, 'd': d, 'e': e, 'f': f}
+
+
+def test_env():
+    wrapped = envwrap('envwrap', 'testenv')(funcname)
+    assert wrapped(c=99) == {'a': None, 'b': 42, 'c': 99, 'd': 360, 'e': 101, 'f': 404}
+    wrapped = envwrap('envwrap')(funcname)
+    assert wrapped(c=99) == {'a': None, 'b': 42, 'c': 99, 'd': 4, 'e': 101, 'f': 6}
+
+
+@pytest.mark.parametrize('ext', ['toml', 'yaml', 'yml', 'json', 'ini', 'cfg'])
+@pytest.mark.parametrize('base', ['cfgwrap', 'testcfg'])
+def test_conf(tmp_path, base, ext):
+    if version_info < (3, 9) and ext in ('ini', 'cfg'):
+        pytest.skip("configparser dict merging requires python>=3.9")
+    config = {
+        'testcfg': {'b': 43, 'c': 1338, 'd': 361,
+                    'funcname': {'f': 405}}, 'funcname': {'e': 102, 'a': 0},
+        'cfgwrap': {'b': -1, 'e': -2, 'f': -3, 'funcname': {'e': -4}}}
+    write_config(tmp_path / f"{base}.{ext}", config)
+    pwd = os.curdir
+    os.chdir(tmp_path)
+    try:
+        wrapped = envwrap('cfgwrap', 'testcfg')(funcname)
+        if base == 'cfgwrap':
+            assert wrapped(c=98) == {'a': 0, 'b': 43, 'c': 98, 'd': 361, 'e': 102, 'f': 405}
+        else:
+            assert wrapped(c=98) == {'a': None, 'b': 2, 'c': 98, 'd': 4, 'e': 5, 'f': 6}
+        assert int(get_defaults(base, 'testcfg', 'funcname')['a']) == 0
+        assert int(get_defaults(base, 'testcfg', 'funcname')['f']) == 405
+        assert int(get_defaults(base, 'testcfg', 'miss-n/a')['d']) == 361
+        assert int(get_defaults(base, 'cfgwrap', 'funcname')['b']) == -1
+        assert int(get_defaults(base, 'cfgwrap', 'miss-n/a')['e']) == -2
+        assert int(get_defaults(base, 'cfgwrap', 'funcname')['f']) == -3
+        assert int(get_defaults(base, 'cfgwrap', 'funcname')['e']) == -4
+    finally:
+        os.chdir(pwd)
+
+
+def test_pyproject(tmp_path):
+    pwd = os.curdir
+    os.chdir(tmp_path)
+    try:
+        shutil.copy(Path(__file__).parent.parent / "pyproject.toml", "pyproject.toml")
+        for tool, key in (('isort', 'line_length'), ('flake8', 'max_line_length'),
+                          ('yapf', 'column_limit')):
+            assert get_defaults(tool, '', '')[key] == 99
+
+        assert get_defaults('coverage', '', 'report')['show_missing'] is True
+        assert get_defaults('coverage', 'report', '')['show_missing'] is True
+        assert get_defaults('coverage', 'report', 'show_missing')['report']['show_missing'] is True
+    finally:
+        os.chdir(pwd)
+
+
+def test_env_cli(capsys):
+    cli.main(['envwrap', 'testenv', 'funcname'])
+    out, err = capsys.readouterr()
+    assert out == dedent("""\
+    >>> @envwrap.envwrap('envwrap', 'testenv')
+    >>> def funcname(...):
+    ...    ...
+    will use defaults:
+    {'b': '42',
+     'c': '1337',
+     'd': '360',
+     'e': '101',
+     'f': '404',
+     'funcname_e': '101',
+     'funcname_f': '404',
+     'testenv_d': '360',
+     'testenv_funcname_f': '404'}
+    """)
+    assert not err
+
+    cli.main(['envwrap', 'funcname'])
+    out, err = capsys.readouterr()
+    assert out == dedent("""\
+    >>> @envwrap.envwrap('envwrap', '')
+    >>> def funcname(...):
+    ...    ...
+    will use defaults:
+    {'b': '42',
+     'c': '1337',
+     'e': '101',
+     'funcname_e': '101',
+     'testenv_d': '360',
+     'testenv_funcname_f': '404'}
+    """)
+    assert not err
+
+    with pytest.raises(ValueError):
+        cli.main(['envwrap'])
+    with pytest.raises(ValueError):
+        cli.main(['envwrap', 'testenv', 'funcname', 'extra'])
+
+
+def test_deprecated_underscore():
+    with pytest.warns(DeprecationWarning, match="Trailing underscore"):
+        envwrap('envwrap_', 'testenv')(funcname)

envwrap-0.2.0/README.md

@@ -1,65 +0,0 @@
-# envwrap
-
-[![CI](https://github.com/tqdm/envwrap/actions/workflows/test.yml/badge.svg)](https://github.com/tqdm/envwrap/actions/workflows/test.yml)
-[![coveralls](https://img.shields.io/coveralls/github/tqdm/envwrap/main?logo=coveralls)](https://coveralls.io/github/tqdm/envwrap)
-[![codecov](https://codecov.io/gh/tqdm/envwrap/graph/badge.svg?token=PEWICBIPVW)](https://codecov.io/gh/tqdm/envwrap)
-[![codacy](https://app.codacy.com/project/badge/Grade/6ca7a441560444489fd5c5b1548ab0de)](https://app.codacy.com/gh/tqdm/envwrap/dashboard)
-
-Override parameter defaults via environment variables & config files.
-
-```py
-import envwrap
-
-@envwrap.envwrap("name", "app")
-def func(a=1):
-    ...
-```
-
-Precedence (descending):
-
-- call (`func(a=3)`)
-- environment (`NAME_APP_FUNC_A=2`, `NAME_FUNC_A=2`, `NAME_APP_A=2`, `NAME_A=2`)
-  - `UPPER_CASE` env vars -> `lower_case` param names
-  - other cases aren't supported because Windows ignores case
-- config file:
-  - ./`{name}.{toml,yaml,yml,json,ini,cfg}::{app.func.a,func.a,app.a,a}`
-  - [platformdirs](https://platformdirs.readthedocs.io/en/latest/parameters.html).{user,site}_config_path(name, False)/
-    - `{app}.{toml,yaml,yml,json,ini,cfg}::{func.a,a}`
-    - `{name}.{toml,yaml,yml,json,ini,cfg}::{app.func.a,func.a,app.a,a}`
-- signature (`def foo(a=1)`)
-
-## Advanced Usage
-
-### Live-reload
-
-To force re-reading config files & environment variables without restarting the process:
-
-```py
-envwrap.get_defaults.cache_clear()
-```
-
-### Debugging
-
-A CLI tool can print defaults. For example, with this config:
-
-```toml
-# config file: foo.toml
-[test]
-a = 1337
-b = 2
-```
-
-```sh
-python -m envwrap --help
-FOO_A=42 python -m envwrap foo test
-```
-
-will print:
-
-```py
->>> @envwrap.envwrap('foo', '')
->>> def test(...):
-...    ...
-will use defaults:
-{'a': '42', 'b': 2, ...}
-```

envwrap-0.2.0/tests/test_envwrap.py

@@ -1,115 +0,0 @@
-import os
-from sys import version_info
-from textwrap import dedent
-
-import pytest
-
-from envwrap import cli, envwrap, get_defaults
-
-
-def write_config(fpath, cfg):
-    ext = fpath.suffix.lower()[1:]
-    fpath.parent.mkdir(parents=True, exist_ok=True)
-    if ext == "toml":
-        from toml import dumps
-    elif ext in ("yaml", "yml"):
-        from yaml import safe_dump as dumps
-    elif ext == "json":
-        from json import dumps
-    elif ext in ("ini", "cfg"):
-        from configparser import ConfigParser
-        parser = ConfigParser()
-        for sec, items in cfg.items():
-            parser[sec] = {k: v for k, v in items.items() if not isinstance(v, dict)}
-            for subsec, subitems in items.items():
-                if isinstance(subitems, dict):
-                    parser[f"{sec}.{subsec}"] = subitems
-        with fpath.open("w") as fd:
-            return parser.write(fd)
-    else:
-        raise TypeError(f"Unsupported config filetype: {fpath}")
-    fpath.write_text(dumps(cfg))
-
-
-@pytest.fixture(autouse=True)
-def set_env():
-    os.environ["ENVWRAP_B"] = "42"
-    os.environ["ENVWRAP_C"] = "1337"
-    os.environ["ENVWRAP_TESTENV_D"] = "360"
-    os.environ["ENVWRAP_FUNCNAME_E"] = "101"
-    os.environ["ENVWRAP_TESTENV_FUNCNAME_F"] = "404"
-    get_defaults.cache_clear()
-
-
-def funcname(a=1, b=2, c=3, d=4, e=5, f=6):
-    return {"a": a, "b": b, "c": c, "d": d, "e": e, "f": f}
-
-
-def test_env():
-    f = envwrap("envwrap", "testenv")(funcname)
-    assert f(c=99) == {"a": 1, "b": 42, "c": 99, "d": 360, "e": 101, "f": 404}
-    f = envwrap("envwrap")(funcname)
-    assert f(c=99) == {"a": 1, "b": 42, "c": 99, "d": 4, "e": 101, "f": 6}
-
-
-@pytest.mark.parametrize("ext", ["toml", "yaml", "yml", "json", "ini", "cfg"])
-def test_conf(tmp_path, ext):
-    if version_info < (3, 9) and ext in ("ini", "cfg"):
-        pytest.skip("configparser dict merging requires python>=3.9")
-    config = {
-        "testcfg": {"b": 43, "c": 1338, "d": 361, "funcname": {"f": 405}}, "funcname": {"e": 102}}
-    write_config(tmp_path / f"cfgwrap.{ext}", config)
-    pwd = os.curdir
-    os.chdir(tmp_path)
-    try:
-        f = envwrap("cfgwrap", "testcfg")(funcname)
-        assert f(c=98) == {"a": 1, "b": 43, "c": 98, "d": 361, "e": 102, "f": 405}
-    finally:
-        os.chdir(pwd)
-
-
-def test_env_cli(capsys):
-    cli.main(["envwrap", "testenv", "funcname"])
-    out, err = capsys.readouterr()
-    assert out == dedent("""\
-    >>> @envwrap.envwrap('envwrap', 'testenv')
-    >>> def funcname(...):
-    ...    ...
-    will use defaults:
-    {'b': '42',
-     'c': '1337',
-     'd': '360',
-     'e': '101',
-     'f': '404',
-     'funcname_e': '101',
-     'funcname_f': '404',
-     'testenv_d': '360',
-     'testenv_funcname_f': '404'}
-    """)
-    assert not err
-
-    cli.main(["envwrap", "funcname"])
-    out, err = capsys.readouterr()
-    assert out == dedent("""\
-    >>> @envwrap.envwrap('envwrap', '')
-    >>> def funcname(...):
-    ...    ...
-    will use defaults:
-    {'b': '42',
-     'c': '1337',
-     'e': '101',
-     'funcname_e': '101',
-     'testenv_d': '360',
-     'testenv_funcname_f': '404'}
-    """)
-    assert not err
-
-    with pytest.raises(ValueError):
-        cli.main(["envwrap"])
-    with pytest.raises(ValueError):
-        cli.main(["envwrap", "testenv", "funcname", "extra"])
-
-
-def test_deprecated_underscore():
-    with pytest.warns(DeprecationWarning, match="Trailing underscore"):
-        envwrap("envwrap_", "testenv")(funcname)