ae-base 0.3.60__py3-none-any.whl → 0.3.63__py3-none-any.whl

ae/base.py

@@ -171,7 +171,7 @@ from types import ModuleType
 from typing import Any, Callable, Generator, Iterable, MutableMapping, Optional, Union, cast
 
 
-__version__ = '0.3.60'
+__version__ = '0.3.63'
 
 
 os_path_abspath = os.path.abspath
@@ -207,6 +207,8 @@ INI_EXT = '.ini'                                #: INI config file extension
 DATE_ISO = "%Y-%m-%d"                           #: ISO string format for date values (e.g. in config files/variables)
 DATE_TIME_ISO = "%Y-%m-%d %H:%M:%S.%f"          #: ISO string format for datetime values
 
+DEF_PROJECT_PARENT_FOLDER = 'src'               #: default directory name to put code project roots underneath of it
+
 DEF_ENCODE_ERRORS = 'backslashreplace'          #: default encode error handling for UnicodeEncodeErrors
 DEF_ENCODING = 'ascii'
 """ encoding for :func:`force_encoding` that will always work independent from destination (console, file sys, ...).
@@ -639,7 +641,7 @@ def load_dotenvs():
         load_env_var_defaults(os_path_dirname(os_path_abspath(file_name)), env_vars)
 
 
-def load_env_var_defaults(start_dir: str, env_vars: MutableMapping[str, str]):
+def load_env_var_defaults(start_dir: str, env_vars: MutableMapping[str, str]) -> MutableMapping[str, str]:
     """ load undeclared env var defaults from a chain of ``.env`` files starting in the specified folder or its parent.
 
     :param start_dir:           folder to start search of an ``.env`` file, if not found, then also checks the parent
@@ -651,21 +653,25 @@ def load_env_var_defaults(start_dir: str, env_vars: MutableMapping[str, str]):
     :param env_vars:            environment variables mapping to be amended with env variable values from any
                                 found ``.env`` file. pass Python's :data:`os.environ` to amend this mapping directly
                                 with all the already not declared environment variables.
+    :return:                    dict with the loaded env var names (keys) and values.
     """
     start_dir = norm_path(start_dir)
     file_path = os_path_join(start_dir, DOTENV_FILE_NAME)
     if not os_path_isfile(file_path):
         file_path = os_path_join(os_path_dirname(start_dir), DOTENV_FILE_NAME)
 
+    loaded_vars = {}
     while os_path_isfile(file_path):
         for var_nam, var_val in parse_dotenv(file_path).items():
             if var_nam not in env_vars:
-                env_vars[var_nam] = var_val
+                env_vars[var_nam] = loaded_vars[var_nam] = var_val
 
         if os.sep not in file_path:
             break           # pragma: no cover # prevent endless-loop for ``.env`` file in root dir (os.sep == '/')
         file_path = os_path_join(os_path_dirname(os_path_dirname(file_path)), DOTENV_FILE_NAME)
 
+    return loaded_vars
+
 
 def main_file_paths_parts(portion_name: str) -> tuple[tuple[str, ...], ...]:
     """ determine tuple of supported main/version file name path part tuples.

{ae_base-0.3.60.dist-info → ae_base-0.3.63.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ae_base
-Version: 0.3.60
+Version: 0.3.63
 Summary: ae namespace module portion base: basic constants, helper functions and context manager
 Home-page: https://gitlab.com/ae-group/ae_base
 Author: AndiEcker
@@ -69,13 +69,13 @@ Dynamic: summary
 
 <!-- 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.60
+# base 0.3.63
 
 [![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.59?logo=python)](
-    https://gitlab.com/ae-group/ae_base/-/tree/release0.3.59)
+    https://img.shields.io/gitlab/pipeline/ae-group/ae_base/release0.3.61?logo=python)](
+    https://gitlab.com/ae-group/ae_base/-/tree/release0.3.61)
 [![PyPIVersions](https://img.shields.io/pypi/v/ae_base)](
     https://pypi.org/project/ae-base/#history)
 

ae_base-0.3.63.dist-info/RECORD

@@ -0,0 +1,7 @@
+ae/base.py,sha256=8sCPZbEHi_XZEZYmHaekTQRlz7T2_EVBWnu_4MfXUAk,67833
+ae_base-0.3.63.dist-info/licenses/LICENSE.md,sha256=vn9XT8MDUxNAWsP60HLwHJp8ZLOI0OJBRe-1N2xXh08,35002
+ae_base-0.3.63.dist-info/METADATA,sha256=Wy4QjjplmPR9IpU2VoXe4eF-bxBS0DMjN1WeX6hbLEA,5724
+ae_base-0.3.63.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+ae_base-0.3.63.dist-info/top_level.txt,sha256=vUdgAslSmhZLXWU48fm8AG2BjVnkOWLco8rzuW-5zY0,3
+ae_base-0.3.63.dist-info/zip-safe,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
+ae_base-0.3.63.dist-info/RECORD,,

ae_base-0.3.60.dist-info/RECORD

@@ -1,7 +0,0 @@
-ae/base.py,sha256=ntLmxDmy33N6G__SgvrfopMzsfDuGOWZb3nP-lnJ4Mk,67533
-ae_base-0.3.60.dist-info/licenses/LICENSE.md,sha256=vn9XT8MDUxNAWsP60HLwHJp8ZLOI0OJBRe-1N2xXh08,35002
-ae_base-0.3.60.dist-info/METADATA,sha256=lwP8j7UO5bTPl6d9j1HNN018CMIN8GcKNpBUBahLgI8,5724
-ae_base-0.3.60.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-ae_base-0.3.60.dist-info/top_level.txt,sha256=vUdgAslSmhZLXWU48fm8AG2BjVnkOWLco8rzuW-5zY0,3
-ae_base-0.3.60.dist-info/zip-safe,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
-ae_base-0.3.60.dist-info/RECORD,,