appsettings2 2.1.1__tar.gz → 2.1.4__tar.gz

{appsettings2-2.1.1/src/appsettings2.egg-info → appsettings2-2.1.4}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: appsettings2
-Version: 2.1.1
-Summary: Unifies configuration sources into a Configuration object that can be bound to complex types, or accessed directly for configuration data.
+Version: 2.1.4
+Summary: ..unify configuration sources into a `Configuration` object that can be bound to complex types, or accessed directly for configuration data.
 Author-email: Shaun Wilson <mrshaunwilson@msn.com>
 License-Expression: MIT
 Project-URL: Documentation, https://appsettings2.readthedocs.io/
@@ -17,12 +17,8 @@ License-File: LICENSE
 Requires-Dist: pyyaml>=6.0.3
 Provides-Extra: dev
 Requires-Dist: coverage; extra == "dev"
-Requires-Dist: flake8; extra == "dev"
-Requires-Dist: flake8-pyproject; extra == "dev"
 Requires-Dist: mypy; extra == "dev"
-Requires-Dist: pep8-naming; extra == "dev"
-Requires-Dist: punit>=1.12.5; extra == "dev"
-Requires-Dist: twine; extra == "dev"
+Requires-Dist: punit>=1.14.2; extra == "dev"
 Requires-Dist: types-PyYAML; extra == "dev"
 Dynamic: license-file
 

{appsettings2-2.1.1 → appsettings2-2.1.4}/pyproject.toml

@@ -1,7 +1,7 @@
 [project]
 name = "appsettings2"
-version = "2.1.1"
-description = "Unifies configuration sources into a Configuration object that can be bound to complex types, or accessed directly for configuration data."
+version = "2.1.4"
+description = "..unify configuration sources into a `Configuration` object that can be bound to complex types, or accessed directly for configuration data."
 keywords = ["appsettings", "configuration"]
 authors = [
     { name="Shaun Wilson", email="mrshaunwilson@msn.com" }
@@ -15,18 +15,14 @@ classifiers = [
 ]
 requires-python = ">=3.11"
 dependencies = [
-  "pyyaml>=6.0.3"
+  "pyyaml (>=6.0.3)"
 ]
 
 [project.optional-dependencies]
 dev = [
     "coverage",
-    "flake8",
-    "flake8-pyproject",
     "mypy",
-    "pep8-naming",
-    "punit (>=1.12.5)",
-    "twine",
+    "punit (>=1.14.2)",
     "types-PyYAML"
 ]
 
@@ -35,24 +31,8 @@ Documentation = "https://appsettings2.readthedocs.io/"
 Homepage = "https://github.com/wilson0x4d/appsettings2"
 Repository = "https://github.com/wilson0x4d/appsettings2.git"
 
-[build-system]
-requires = ["setuptools"]
-build-backend = "setuptools.build_meta"
-
-[tool.setuptools.packages.find]
-where = ["src"]
-exclude = [
-    "docs",
-    "tests",
-    "tests.*"
-]
-
 [tool.setuptools.package-data]
 "appsettings2" = ["py.typed", "SKILL.md"]
 
-[tool.flake8]
-max-line-length = 120
-ignore = ["D100","E501"]
-per-file-ignores = [
-    "tests/*.py:D012,E306",
-]
+[tool.uv]
+package = true

{appsettings2-2.1.1 → appsettings2-2.1.4}/src/appsettings2/Configuration.py

@@ -585,8 +585,13 @@ class Configuration:
         """
         Set the configuration value for a configuration key.
 
-        :param key: The *key* to associate the configuration *value*.
+        :param key: The *key* to associate the configuration *value*. Supports `__` and `:` hierarchical delimiters.
         :param value: The *value* to be associated with the configuration *key*.
+
+        Intermediate segments of a hierarchical key are created as nested
+        :py:class:`~appsettings2.Configuration` objects as needed. If an
+        intermediate segment already holds a non-``Configuration`` value
+        (e.g. a scalar or list), it is replaced by a new ``Configuration``.
         """
         if self.__normalize:
             key = key.upper()
@@ -608,6 +613,12 @@ class Configuration:
                     o = c
                 else:
                     o = getattr(self, self.__scrub_key(k))
+                    if not isinstance(o, Configuration):
+                        c = Configuration(normalize=self.__normalize, scrubkeys=(
+                            self.__key_scrub_re is None))
+                        setattr(self, self.__scrub_key(k), c)
+                        self.__add_child_change_handler(parts[i])
+                        o = c
             else:
                 if not o.has_key(parts[i]):
                     c = Configuration(normalize=self.__normalize, scrubkeys=(
@@ -616,6 +627,11 @@ class Configuration:
                     o = c
                 else:
                     o = o.get(parts[i])
+                    if not isinstance(o, Configuration):
+                        c = Configuration(normalize=self.__normalize, scrubkeys=(
+                            self.__key_scrub_re is None))
+                        o.set(parts[i], c)
+                        o = c
 
         # Convert dict/list values
         vtype = type(value)

{appsettings2-2.1.1 → appsettings2-2.1.4}/src/appsettings2/ConfigurationBuilder.py

@@ -76,7 +76,7 @@ class ConfigurationBuilder:
         """
         Add a :py:class:`~appsettings2.providers.EnvironmentConfigurationProvider`.
 
-        :param required_prefix: Optional prefix used to filter which environment variables are included. Only variables whose names start with this prefix (followed by ``_`` or ``__``) will be loaded. When ``None``, all environment variables are included. Defaults to None.
+        :param required_prefix: Optional prefix used to filter which environment variables are included. Only variables whose names start with this prefix (followed by ``_`` or ``__``) will be loaded. When ``None``, all environment variables are included. Defaults to None. Note that environment variables whose names begin with an underscore are unsupported and are always ignored, even when ``required_prefix`` matches them.
         :return: Returns :py:class:`~appsettings2.ConfigurationBuilder` for method chaining.
         """
         return self.add_provider(EnvironmentConfigurationProvider(required_prefix=required_prefix))

{appsettings2-2.1.1 → appsettings2-2.1.4}/src/appsettings2/SKILL.md

@@ -82,6 +82,8 @@ export MYAPP_DB_HOST=postgres://...        # loaded as "DB_HOST"
 export OTHER_KEY=value                     # ignored
 ```
 
+Env vars whose names begin with an underscore (e.g. `_FOO`, `__FOO`) are unsupported and are always ignored, even when `required_prefix` is set to a matching value. This prevents double-underscore-prefixed variables from producing an unwanted empty (`''`) hierarchy key.
+
 ### `build()`
 
 ```python
@@ -122,6 +124,8 @@ config.set('Section__Key', 'value')     # hierarchical key
 config['Section__Key'] = 'value'        # same via setter
 ```
 
+Intermediate segments are created as nested `Configuration` objects as needed; if an intermediate segment already holds a non-`Configuration` value (scalar/list), it is replaced by a new `Configuration`.
+
 ### Other members
 
 | Member | Signature | Description |

{appsettings2-2.1.1 → appsettings2-2.1.4}/src/appsettings2/__init__.py

@@ -11,8 +11,8 @@ from . import helpers
 from . import providers
 
 
-__version__ = '2.1.1'
-__commit__ = 'ec3a50a'
+__version__ = '2.1.4'
+__commit__ = '56a39dc'
 __all__ = [
     '__version__', '__commit__',
     'Configuration',

{appsettings2-2.1.1 → appsettings2-2.1.4}/src/appsettings2/helpers.py

@@ -30,7 +30,7 @@ def get_configuration(
     :param cli: ``True`` to load configuration from Command-Line, defaults to True
     :param environment: ``True`` to load configuration from process Environment, defaults to True
     :param variations: A set of variations to apply to use with file-based Configuration Providers, defaults to ['', 'prod', 'production', 'stage', 'staging', 'qa', 'dev', 'development', 'local']
-    :param env_prefix: (OPTIONAL) When specified, only env vars having the specified prefix are bound as configuration settings, the prefix is stripped from the resulting setting name.
+    :param env_prefix: (OPTIONAL) When specified, only env vars having the specified prefix are bound as configuration settings, the prefix is stripped from the resulting setting name. Env vars whose names begin with an underscore are unsupported and are always ignored, even when they match ``env_prefix``.
     :param disable_events: Option indicating whether change events should be emitted, defaults to False.
     :return: An ``appsettings2.Configuration`` instance.
     """

{appsettings2-2.1.1 → appsettings2-2.1.4}/src/appsettings2/providers/EnvironmentConfigurationProvider.py

@@ -33,8 +33,15 @@ class EnvironmentConfigurationProvider(ConfigurationProvider):
 
         When ``required_prefix`` is set, only keys starting with that prefix are included,
         and the prefix is stripped from each key in the output configuration.
+
+        Environment variable names starting with an underscore (e.g. ``_FOO``,
+        ``__FOO``) are unsupported and are always ignored, even when they match
+        ``required_prefix``. This prevents double-underscore-prefixed variables
+        from producing empty (``''``) hierarchy keys.
         """
         for k in os.environ:
+            if k.startswith('_'):
+                continue
             key = (
                 k
                 if self.__required_prefix is None

{appsettings2-2.1.1 → appsettings2-2.1.4/src/appsettings2.egg-info}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: appsettings2
-Version: 2.1.1
-Summary: Unifies configuration sources into a Configuration object that can be bound to complex types, or accessed directly for configuration data.
+Version: 2.1.4
+Summary: ..unify configuration sources into a `Configuration` object that can be bound to complex types, or accessed directly for configuration data.
 Author-email: Shaun Wilson <mrshaunwilson@msn.com>
 License-Expression: MIT
 Project-URL: Documentation, https://appsettings2.readthedocs.io/
@@ -17,12 +17,8 @@ License-File: LICENSE
 Requires-Dist: pyyaml>=6.0.3
 Provides-Extra: dev
 Requires-Dist: coverage; extra == "dev"
-Requires-Dist: flake8; extra == "dev"
-Requires-Dist: flake8-pyproject; extra == "dev"
 Requires-Dist: mypy; extra == "dev"
-Requires-Dist: pep8-naming; extra == "dev"
-Requires-Dist: punit>=1.12.5; extra == "dev"
-Requires-Dist: twine; extra == "dev"
+Requires-Dist: punit>=1.14.2; extra == "dev"
 Requires-Dist: types-PyYAML; extra == "dev"
 Dynamic: license-file
 

appsettings2-2.1.4/src/appsettings2.egg-info/requires.txt

@@ -0,0 +1,7 @@
+pyyaml>=6.0.3
+
+[dev]
+coverage
+mypy
+punit>=1.14.2
+types-PyYAML

appsettings2-2.1.1/src/appsettings2.egg-info/requires.txt

@@ -1,11 +0,0 @@
-pyyaml>=6.0.3
-
-[dev]
-coverage
-flake8
-flake8-pyproject
-mypy
-pep8-naming
-punit>=1.12.5
-twine
-types-PyYAML