ae-base 0.3.39__py3-none-any.whl → 0.3.40__py3-none-any.whl

ae/base.py

@@ -3,7 +3,7 @@ basic constants, helper functions and context manager
 =====================================================
 
 this module is pure python, has no external dependencies, and is providing base constants, common helper
-functions and context managers.
+functions, useful classes and context managers.
 
 
 base constants
@@ -24,6 +24,9 @@ the constants :data:`PACKAGE_NAME`, :data:`PACKAGE_DOMAIN` and :data:`PERMISSION
 on mobile devices. to avoid redundancies, these values get loaded from the
 :data:`build config file <BUILD_CONFIG_FILE>` - if it exists in the current working directory.
 
+with the help of the format string constant :data:`NOW_STR_FORMAT` and the function :func:`now_str` you can create a
+sortable and compact string from a timestamp.
+
 
 base helper functions
 ---------------------
@@ -99,6 +102,15 @@ code and build Kivy apps for the Android OS, and to `Gabriel Pettier <https://gi
 osc example.
 
 
+types, classes and mixins
+-------------------------
+
+the :class:`UnsetType` class can be used e.g. for the declaration of optional function and method parameters,
+allowing also `None` is an accepted argument value.
+
+to extend any class with an intelligent error message property, add the mixin :class:`ErrorMsgMixin` to it.
+
+
 generic context manager
 -----------------------
 
@@ -148,7 +160,7 @@ from types import ModuleType
 from typing import Any, Callable, Dict, Generator, Iterable, List, Optional, Tuple, Union, cast
 
 
-__version__ = '0.3.39'
+__version__ = '0.3.40'
 
 
 DOCS_FOLDER = 'docs'                            #: project documentation root folder name
@@ -202,7 +214,9 @@ _env_variable = re.compile(r"""
     """, re.IGNORECASE | re.VERBOSE)
 
 
-NAME_PARTS_SEP = '_'                            #: name parts separator character, e.g. for :func:`norm_name`
+NAME_PARTS_SEP = '_'                                #: name parts separator character, e.g. for :func:`norm_name`
+
+NOW_STR_FORMAT = "{sep}%Y%m%d{sep}%H%M%S{sep}%f"    #: timestamp format of :func:`now_str`
 
 SKIPPED_MODULES = ('ae.base', 'ae.paths', 'ae.dynamicod', 'ae.core', 'ae.console', 'ae.gui_app', 'ae.gui_help',
                    'ae.kivy', 'ae.kivy.apps', 'ae.kivy.behaviors', 'ae.kivy.i18n', 'ae.kivy.tours', 'ae.kivy.widgets',
@@ -612,9 +626,12 @@ def now_str(sep: str = "") -> str:
 
     :param sep:                 optional prefix and separator character (separating date from time and in time part
                                 the seconds from the microseconds).
-    :return:                    UTC timestamp as string (length=20 + 3 * len(sep)).
+    :return:                    naive UTC timestamp (without timezone info) as string (length=20 + 3 * len(sep)).
     """
-    return datetime.datetime.utcnow().strftime("{sep}%Y%m%d{sep}%H%M%S{sep}%f".format(sep=sep))
+    # if sys.version_info >= (3, 12):
+    return datetime.datetime.now(datetime.timezone.utc).replace(tzinfo=None).strftime(NOW_STR_FORMAT.format(sep=sep))
+    # else:
+    #     return datetime.datetime.utcnow().strftime(NOW_STR_FORMAT.format(sep=sep))
 
 
 def os_host_name() -> str:

{ae_base-0.3.39.dist-info → ae_base-0.3.40.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: ae_base
-Version: 0.3.39
+Version: 0.3.40
 Summary: ae namespace module portion base: basic constants, helper functions and context manager
 Home-page: https://gitlab.com/ae-group/ae_base
 Author: AndiEcker
@@ -53,17 +53,17 @@ Requires-Dist: twine; extra == "tests"
 
 <!-- THIS FILE IS EXCLUSIVELY MAINTAINED by the project ae.ae V0.3.94 -->
 <!-- THIS FILE IS EXCLUSIVELY MAINTAINED by the project aedev.tpl_namespace_root V0.3.14 -->
-# base 0.3.39
+# base 0.3.40
 
 [![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.38?logo=python)](
-    https://gitlab.com/ae-group/ae_base/-/tree/release0.3.38)
+    https://img.shields.io/gitlab/pipeline/ae-group/ae_base/release0.3.39?logo=python)](
+    https://gitlab.com/ae-group/ae_base/-/tree/release0.3.39)
 [![PyPIVersions](https://img.shields.io/pypi/v/ae_base)](
     https://pypi.org/project/ae-base/#history)
 
->ae_base module 0.3.39.
+>ae_base module 0.3.40.
 
 [![Coverage](https://ae-group.gitlab.io/ae_base/coverage.svg)](
     https://ae-group.gitlab.io/ae_base/coverage/index.html)

ae_base-0.3.40.dist-info/RECORD

@@ -0,0 +1,7 @@
+ae/base.py,sha256=-_eBIIgBgO1opcu_GlqDB1qQOU0qzuUvKUd1YM0hT5c,55971
+ae_base-0.3.40.dist-info/LICENSE.md,sha256=3X7IwvwQFt4PqRHb7mV8qoJjQ1E-HmcGioyT4Y6-6c8,35002
+ae_base-0.3.40.dist-info/METADATA,sha256=Mvak-VG2CUOXlP0lNF5wi2UuQSSkdPm8WdS5FsUwL5g,5219
+ae_base-0.3.40.dist-info/WHEEL,sha256=GV9aMThwP_4oNCtvEC2ec3qUYutgWeAzklro_0m4WJQ,91
+ae_base-0.3.40.dist-info/top_level.txt,sha256=vUdgAslSmhZLXWU48fm8AG2BjVnkOWLco8rzuW-5zY0,3
+ae_base-0.3.40.dist-info/zip-safe,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
+ae_base-0.3.40.dist-info/RECORD,,

ae_base-0.3.39.dist-info/RECORD

@@ -1,7 +0,0 @@
-ae/base.py,sha256=aA_qa4s-17EzXKjN9wwfya688eGnFNJP0EglSLeYJjw,55182
-ae_base-0.3.39.dist-info/LICENSE.md,sha256=3X7IwvwQFt4PqRHb7mV8qoJjQ1E-HmcGioyT4Y6-6c8,35002
-ae_base-0.3.39.dist-info/METADATA,sha256=YPZbM4qKqfaO-3WvDLvV77O9WNWOfxg6uxhkO7nu0vA,5219
-ae_base-0.3.39.dist-info/WHEEL,sha256=GV9aMThwP_4oNCtvEC2ec3qUYutgWeAzklro_0m4WJQ,91
-ae_base-0.3.39.dist-info/top_level.txt,sha256=vUdgAslSmhZLXWU48fm8AG2BjVnkOWLco8rzuW-5zY0,3
-ae_base-0.3.39.dist-info/zip-safe,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
-ae_base-0.3.39.dist-info/RECORD,,