ae-base 0.3.65__tar.gz → 0.3.66__tar.gz

{ae_base-0.3.65 → ae_base-0.3.66}/LICENSE.md

@@ -1,4 +1,4 @@
-<!-- THIS FILE IS EXCLUSIVELY MAINTAINED by the project aedev.project_tpls V0.3.45 -->
+<!-- THIS FILE IS EXCLUSIVELY MAINTAINED by the project aedev.project_tpls v0.3.46 -->
 ### GNU GENERAL PUBLIC LICENSE
 
 Version 3, 29 June 2007

{ae_base-0.3.65/ae_base.egg-info → ae_base-0.3.66}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ae_base
-Version: 0.3.65
+Version: 0.3.66
 Summary: ae namespace module portion base: basic constants, helper functions and context manager
 Home-page: https://gitlab.com/ae-group/ae_base
 Author: AndiEcker
@@ -67,15 +67,15 @@ Dynamic: provides-extra
 Dynamic: requires-python
 Dynamic: summary
 
-<!-- THIS FILE IS EXCLUSIVELY MAINTAINED by the project ae.ae V0.3.96 -->
+<!-- THIS FILE IS EXCLUSIVELY MAINTAINED by the project ae.ae v0.3.96 -->
 <!-- THIS FILE IS EXCLUSIVELY MAINTAINED by the project aedev.tpl_namespace_root V0.3.14 -->
-# base 0.3.65
+# base 0.3.66
 
 [![GitLab develop](https://img.shields.io/gitlab/pipeline/ae-group/ae_base/develop?logo=python)](
     https://gitlab.com/ae-group/ae_base)
 [![LatestPyPIrelease](
-    https://img.shields.io/gitlab/pipeline/ae-group/ae_base/release0.3.64?logo=python)](
-    https://gitlab.com/ae-group/ae_base/-/tree/release0.3.64)
+    https://img.shields.io/gitlab/pipeline/ae-group/ae_base/release0.3.65?logo=python)](
+    https://gitlab.com/ae-group/ae_base/-/tree/release0.3.65)
 [![PyPIVersions](https://img.shields.io/pypi/v/ae_base)](
     https://pypi.org/project/ae-base/#history)
 

{ae_base-0.3.65 → ae_base-0.3.66}/README.md

@@ -1,12 +1,12 @@
-<!-- THIS FILE IS EXCLUSIVELY MAINTAINED by the project ae.ae V0.3.96 -->
+<!-- THIS FILE IS EXCLUSIVELY MAINTAINED by the project ae.ae v0.3.96 -->
 <!-- THIS FILE IS EXCLUSIVELY MAINTAINED by the project aedev.tpl_namespace_root V0.3.14 -->
-# base 0.3.65
+# base 0.3.66
 
 [![GitLab develop](https://img.shields.io/gitlab/pipeline/ae-group/ae_base/develop?logo=python)](
     https://gitlab.com/ae-group/ae_base)
 [![LatestPyPIrelease](
-    https://img.shields.io/gitlab/pipeline/ae-group/ae_base/release0.3.64?logo=python)](
-    https://gitlab.com/ae-group/ae_base/-/tree/release0.3.64)
+    https://img.shields.io/gitlab/pipeline/ae-group/ae_base/release0.3.65?logo=python)](
+    https://gitlab.com/ae-group/ae_base/-/tree/release0.3.65)
 [![PyPIVersions](https://img.shields.io/pypi/v/ae_base)](
     https://pypi.org/project/ae-base/#history)
 

{ae_base-0.3.65 → ae_base-0.3.66}/ae/base.py

@@ -32,7 +32,7 @@ sortable and compact string from a timestamp.
 base helper functions
 ---------------------
 
-the function :func:`evaluate_literal` can be used as an replacement of :func:`ast.literal_eval` to retrieve
+the function :func:`evaluate_literal` can be used as a replacement of :func:`ast.literal_eval` to retrieve
 basic data structure values from config, ini and .env files, while also accepting unquoted strings as a `str` type
 instance.
 
@@ -176,7 +176,7 @@ from types import ModuleType
 from typing import Any, Callable, Generator, Iterable, MutableMapping, Optional, Union, cast
 
 
-__version__ = '0.3.65'
+__version__ = '0.3.66'
 
 
 os_path_abspath = os.path.abspath
@@ -360,6 +360,7 @@ def deep_dict_update(data: dict, update: dict, overwrite: bool = True):
 
 
 URI_SEP_CHAR = '⫻'  # U+2AFB: TRIPLE SOLIDUS BINARY RELATION
+# noinspection GrazieInspection
 ASCII_UNICODE = (
     ('/', '⁄'),     # U+2044: Fraction Slash; '∕' U+2215: Division Slash; '⧸' U+29F8: Big Solidus;
                     # '╱' U+FF0F: Fullwidth Solidus; '╱' U+2571: Box Drawings Light Diagonal Upper Right to Lower Left
@@ -433,7 +434,7 @@ def defuse(value: str) -> str:
     in most unix variants only the slash and the ASCII 0 characters are not allowed in file names.
 
     in MS Windows are not allowed: ASCII 0..31 / | \\ : * ? ” % < > ( ). some blogs recommend also not allowing
-    (convert) the characters # and '.
+    (convert) the characters `#` and `'`.
 
     only old POSIX seems to be even more restricted (only allowing alphanumeric characters plus . - and _).
 
@@ -649,14 +650,26 @@ def in_wd(new_cwd: str) -> Generator[None, None, None]:
         os.chdir(cur_dir)
 
 
-def load_dotenvs():
-    """ detect and load multiple ``.env`` files in/above the current working directory and the calling module folder.
+def load_dotenvs(from_module_path: bool = False):
+    """ detect and load not defined OS environment variables from ``.env`` files.
 
-    .. hint:: call from the main module of project/app in order to also load ``.env`` files in/above the project folder.
+    :param from_module_path:    pass True to load OS environment variables (that are not already loaded from ``.env``
+                                files situated in or above the current working directory) also from/above the folder of
+                                the first module in the call stack that gets not excluded/skipped by :func:`stack_var`.
+
+                                in order to also load ``.env`` files in/above the project folder.
+                                call this function from the main module of project/app.
+
+    .. note::
+        only variables that are not already defined in the OS environment variables mapping :data:`os.environ` will be
+        loaded/added. variables will be loaded first from the first ``.env`` file found in or above the current working
+        directory, while the variable values in the deeper situated files are overwriting the values defined in the
+        ``.env`` files situated in the above folders.
     """
     env_vars = os.environ
     load_env_var_defaults(os.getcwd(), env_vars)
-    if file_name := stack_var('__file__'):
+
+    if from_module_path and (file_name := stack_var('__file__')):
         load_env_var_defaults(os_path_dirname(os_path_abspath(file_name)), env_vars)
 
 
@@ -788,11 +801,12 @@ def module_name(*skip_modules: str, depth: int = 0) -> Optional[str]:
 
 
 def norm_line_sep(text: str) -> str:
+    # noinspection GrazieInspection
     """ convert any combination of line separators in the :paramref:`~norm_line_sep.text` arg to new-line characters.
 
-    :param text:                string containing any combination of line separators ('\\\\r\\\\n' or '\\\\r').
-    :return:                    normalized/converted string with only new-line ('\\\\n') line separator characters.
-    """
+        :param text:                string containing any combination of line separators ('\\\\r\\\\n' or '\\\\r').
+        :return:                    normalized/converted string with only new-line ('\\\\n') line separator characters.
+        """
     return text.replace('\r\n', '\n').replace('\r', '\n')
 
 

{ae_base-0.3.65 → ae_base-0.3.66/ae_base.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ae_base
-Version: 0.3.65
+Version: 0.3.66
 Summary: ae namespace module portion base: basic constants, helper functions and context manager
 Home-page: https://gitlab.com/ae-group/ae_base
 Author: AndiEcker
@@ -67,15 +67,15 @@ Dynamic: provides-extra
 Dynamic: requires-python
 Dynamic: summary
 
-<!-- THIS FILE IS EXCLUSIVELY MAINTAINED by the project ae.ae V0.3.96 -->
+<!-- THIS FILE IS EXCLUSIVELY MAINTAINED by the project ae.ae v0.3.96 -->
 <!-- THIS FILE IS EXCLUSIVELY MAINTAINED by the project aedev.tpl_namespace_root V0.3.14 -->
-# base 0.3.65
+# base 0.3.66
 
 [![GitLab develop](https://img.shields.io/gitlab/pipeline/ae-group/ae_base/develop?logo=python)](
     https://gitlab.com/ae-group/ae_base)
 [![LatestPyPIrelease](
-    https://img.shields.io/gitlab/pipeline/ae-group/ae_base/release0.3.64?logo=python)](
-    https://gitlab.com/ae-group/ae_base/-/tree/release0.3.64)
+    https://img.shields.io/gitlab/pipeline/ae-group/ae_base/release0.3.65?logo=python)](
+    https://gitlab.com/ae-group/ae_base/-/tree/release0.3.65)
 [![PyPIVersions](https://img.shields.io/pypi/v/ae_base)](
     https://pypi.org/project/ae-base/#history)
 

{ae_base-0.3.65 → ae_base-0.3.66}/setup.py

@@ -1,4 +1,4 @@
-# THIS FILE IS EXCLUSIVELY MAINTAINED by the project aedev.project_tpls V0.3.45
+# THIS FILE IS EXCLUSIVELY MAINTAINED by the project aedev.project_tpls v0.3.46
 """ setup of ae namespace module portion base: basic constants, helper functions and context manager. """
 # noinspection PyUnresolvedReferences
 import sys
@@ -24,15 +24,15 @@ setup_kwargs = {
     'install_requires': [],
     'keywords': ['configuration', 'development', 'environment', 'productivity'],
     'license': 'GPL-3.0-or-later',
-    'long_description': ('<!-- THIS FILE IS EXCLUSIVELY MAINTAINED by the project ae.ae V0.3.96 -->\n'
+    'long_description': ('<!-- THIS FILE IS EXCLUSIVELY MAINTAINED by the project ae.ae v0.3.96 -->\n'
  '<!-- THIS FILE IS EXCLUSIVELY MAINTAINED by the project aedev.tpl_namespace_root V0.3.14 -->\n'
- '# base 0.3.65\n'
+ '# base 0.3.66\n'
  '\n'
  '[![GitLab develop](https://img.shields.io/gitlab/pipeline/ae-group/ae_base/develop?logo=python)](\n'
  '    https://gitlab.com/ae-group/ae_base)\n'
  '[![LatestPyPIrelease](\n'
- '    https://img.shields.io/gitlab/pipeline/ae-group/ae_base/release0.3.64?logo=python)](\n'
- '    https://gitlab.com/ae-group/ae_base/-/tree/release0.3.64)\n'
+ '    https://img.shields.io/gitlab/pipeline/ae-group/ae_base/release0.3.65?logo=python)](\n'
+ '    https://gitlab.com/ae-group/ae_base/-/tree/release0.3.65)\n'
  '[![PyPIVersions](https://img.shields.io/pypi/v/ae_base)](\n'
  '    https://pypi.org/project/ae-base/#history)\n'
  '\n'
@@ -110,7 +110,7 @@ setup_kwargs = {
     'python_requires': '>=3.9',
     'setup_requires': [],
     'url': 'https://gitlab.com/ae-group/ae_base',
-    'version': '0.3.65',
+    'version': '0.3.66',
     'zip_safe': True,
 }
 

{ae_base-0.3.65 → ae_base-0.3.66}/tests/test_base.py

@@ -543,6 +543,11 @@ class TestBaseHelpers:
         load_dotenvs()
         assert env_var_name not in os.environ
 
+    def test_load_dotenvs_from_module_path(self, os_env_test_env):
+        assert env_var_name not in os.environ
+        load_dotenvs(from_module_path=True)
+        assert env_var_name not in os.environ
+
     def test_load_env_var_defaults_errors(self):
         with pytest.raises(TypeError):
             # noinspection PyArgumentList