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

ae/base.py

@@ -32,6 +32,10 @@ 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
+basic data structure values from config, ini and .env files, while also accepting unquoted strings as a `str` type
+instance.
+
 most programming languages providing a function to determine the sign of a number. the :func:`sign` functino,
 provided by this module/portion is filling this gap in Python.
 
@@ -148,6 +152,7 @@ os.path shortcuts
 the following data items are pointers to shortcut at runtime the lookup to their related functions in the
 Python module :mod:`os.path`:
 """
+# pylint: disable=too-many-lines
 import datetime
 import getpass
 import importlib.abc
@@ -171,7 +176,7 @@ from types import ModuleType
 from typing import Any, Callable, Generator, Iterable, MutableMapping, Optional, Union, cast
 
 
-__version__ = '0.3.63'
+__version__ = '0.3.65'
 
 
 os_path_abspath = os.path.abspath
@@ -494,6 +499,20 @@ def env_str(name: str, convert_name: bool = False) -> Optional[str]:
     return os.environ.get(name)
 
 
+def evaluate_literal(literal_string: str) -> Any:
+    """ evaluates a Python expression while accepting unquoted strings as str type.
+
+    :param literal_string:      any literal of the base types (like dict, list, set, tuple) which are recognized
+                                by :func:`ast.literal_eval`.
+    :return:                    an instance of the data type or the specified string, even if it is not quoted with
+                                high comma characters.
+    """
+    try:
+        return literal_eval(literal_string)
+    except (IndentationError, SyntaxError, TypeError, ValueError):
+        return literal_string
+
+
 def force_encoding(text: Union[str, bytes], encoding: str = DEF_ENCODING, errors: str = DEF_ENCODE_ERRORS) -> str:
     """ force/ensure the encoding of text (str or bytes) without any UnicodeDecodeError/UnicodeEncodeError.
 
@@ -1249,30 +1268,25 @@ def write_file(file_path: str, content: Union[str, bytes],
 class ErrorMsgMixin:                                                # pylint: disable=too-few-public-methods
     """ mixin class providing sophisticated error message handling. """
     _err_msg: str = ""
-
-    cae = None
-    po = print
-    dpo = print
-    vpo = print
+    main_app = None
+    po = dpo = vpo = print
 
     def __init__(self):
         try:
             from ae.core import main_app_instance       # type: ignore # pylint: disable=import-outside-toplevel
 
-            self.cae = cae = main_app_instance()
-            assert cae is not None, f"{self.__class__.__name__}.__init__() called too early; main app instance not"
+            self.main_app = main_app = main_app_instance()
+            assert main_app is not None, f"{self.__class__.__name__}.__init__() called too early; main app instance not"
 
-            self.po = cae.po
-            self.dpo = cae.dpo
-            self.vpo = cae.vpo
+            self.po = main_app.po
+            self.dpo = main_app.dpo
+            self.vpo = main_app.vpo
 
         except (ImportError, AssertionError, Exception) as exc:                 # pylint: disable=broad-except
             print(f"{self.__class__.__name__}.__init__() raised {exc}; using print() instead of main app error loggers")
 
-            # self.cae = None
-            # self.po = print
-            # self.dpo = print
-            # self.vpo = print
+            # self.main_app = None
+            # self.po = self.dpo = self.vpo = print
 
     @property
     def error_message(self) -> str:

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

@@ -1,29 +1,29 @@
 Metadata-Version: 2.4
 Name: ae_base
-Version: 0.3.63
+Version: 0.3.65
 Summary: ae namespace module portion base: basic constants, helper functions and context manager
 Home-page: https://gitlab.com/ae-group/ae_base
 Author: AndiEcker
 Author-email: aecker2@gmail.com
-License: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
+License: GPL-3.0-or-later
 Project-URL: Bug Tracker, https://gitlab.com/ae-group/ae_base/-/issues
 Project-URL: Documentation, https://ae.readthedocs.io/en/latest/_autosummary/ae.base.html
 Project-URL: Repository, https://gitlab.com/ae-group/ae_base
 Project-URL: Source, https://ae.readthedocs.io/en/latest/_modules/ae/base.html
 Keywords: configuration,development,environment,productivity
 Classifier: Development Status :: 3 - Alpha
-Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
 Classifier: Natural Language :: English
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.9
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Typing :: Typed
 Requires-Python: >=3.9
 Description-Content-Type: text/markdown
 License-File: LICENSE.md
 Provides-Extra: dev
-Requires-Dist: aedev_tpl_project; extra == "dev"
+Requires-Dist: aedev_project_tpls; extra == "dev"
 Requires-Dist: ae_ae; extra == "dev"
 Requires-Dist: anybadge; extra == "dev"
 Requires-Dist: coverage-badge; extra == "dev"
@@ -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.63
+# base 0.3.65
 
 [![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.61?logo=python)](
-    https://gitlab.com/ae-group/ae_base/-/tree/release0.3.61)
+    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)
 [![PyPIVersions](https://img.shields.io/pypi/v/ae_base)](
     https://pypi.org/project/ae-base/#history)
 

ae_base-0.3.65.dist-info/RECORD

@@ -0,0 +1,7 @@
+ae/base.py,sha256=dMNP9veLav-IvUULLmNPs1PXpHQ2xAn5WMva9qIVRKk,68719
+ae_base-0.3.65.dist-info/licenses/LICENSE.md,sha256=-UEWsJNTHESFg25my1bZ5yx9aZzHD04wbguYc6ZfgEY,35003
+ae_base-0.3.65.dist-info/METADATA,sha256=s82tpQCZKNjEzSNvz-9KEWY5AkXzRDHIzUJChWcg-vk,5619
+ae_base-0.3.65.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+ae_base-0.3.65.dist-info/top_level.txt,sha256=vUdgAslSmhZLXWU48fm8AG2BjVnkOWLco8rzuW-5zY0,3
+ae_base-0.3.65.dist-info/zip-safe,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
+ae_base-0.3.65.dist-info/RECORD,,

{ae_base-0.3.63.dist-info → ae_base-0.3.65.dist-info}/licenses/LICENSE.md

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

ae_base-0.3.63.dist-info/RECORD

@@ -1,7 +0,0 @@
-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,,