appsettings2 2.1.0__tar.gz → 2.1.3__tar.gz

{appsettings2-2.1.0/src/appsettings2.egg-info → appsettings2-2.1.3}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: appsettings2
-Version: 2.1.0
-Summary: Unifies configuration sources into a Configuration object that can be bound to complex types, or accessed directly for configuration data.
+Version: 2.1.3
+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.0 → appsettings2-2.1.3}/pyproject.toml

@@ -1,7 +1,7 @@
 [project]
 name = "appsettings2"
-version = "2.1.0"
-description = "Unifies configuration sources into a Configuration object that can be bound to complex types, or accessed directly for configuration data."
+version = "2.1.3"
+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.0 → appsettings2-2.1.3}/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.0 → appsettings2-2.1.3}/src/appsettings2/ConfigurationWatcher.py

@@ -87,7 +87,7 @@ class ConfigurationWatcher:
         self.__handler_lock = threading.Lock()
         self.__logger = logging.getLogger(__name__)
 
-    def add_watch(self, filepath: str) -> None:
+    def add_watch(self, filepath: str) -> ConfigurationWatcher:
         """Add a file path to be watched for changes.
 
         The path is normalised to a fully-qualified (canonical) path via
@@ -100,18 +100,18 @@ class ConfigurationWatcher:
         resolved = os.path.realpath(filepath)
         with self.__lock:
             is_first_watch = len(self.__watches) == 0
-            if resolved in self.__watches:
-                return
-            self.__watches[resolved] = {
-                'path': resolved,
-                'size': None,
-                'mtime': None,
-                'state': 'pending',
-            }
-            if is_first_watch:
-                self.__start_thread()
-
-    def remove_watch(self, filepath: str) -> None:
+            if resolved not in self.__watches:
+                self.__watches[resolved] = {
+                    'path': resolved,
+                    'size': None,
+                    'mtime': None,
+                    'state': 'pending',
+                }
+                if is_first_watch:
+                    self.__start_thread()
+        return self
+
+    def remove_watch(self, filepath: str) -> ConfigurationWatcher:
         """Remove a previously added watch.
 
         Silently does nothing if the watch does not exist. The polling thread
@@ -122,11 +122,11 @@ class ConfigurationWatcher:
         """
         resolved = os.path.realpath(filepath)
         with self.__lock:
-            if resolved not in self.__watches:
-                return
-            del self.__watches[resolved]
-            if len(self.__watches) == 0 and self.__thread is not None:
-                self.__drain_thread()
+            if resolved in self.__watches:
+                del self.__watches[resolved]
+                if len(self.__watches) == 0 and self.__thread is not None:
+                    self.__drain_thread()
+        return self
 
     def list_watches(self) -> list[str]:
         """Return a fresh list of all currently watched file paths.

{appsettings2-2.1.0 → appsettings2-2.1.3}/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

{appsettings2-2.1.0 → appsettings2-2.1.3}/src/appsettings2/__init__.py

@@ -11,8 +11,8 @@ from . import helpers
 from . import providers
 
 
-__version__ = '2.1.0'
-__commit__ = 'a6890cf'
+__version__ = '2.1.3'
+__commit__ = '7215742'
 __all__ = [
     '__version__', '__commit__',
     'Configuration',

{appsettings2-2.1.0 → appsettings2-2.1.3}/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.0 → appsettings2-2.1.3}/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.0 → appsettings2-2.1.3/src/appsettings2.egg-info}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: appsettings2
-Version: 2.1.0
-Summary: Unifies configuration sources into a Configuration object that can be bound to complex types, or accessed directly for configuration data.
+Version: 2.1.3
+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.3/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.0/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