ae-base 0.3.43__tar.gz → 0.3.45__tar.gz

{ae_base-0.3.43/ae_base.egg-info → ae_base-0.3.45}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: ae_base
-Version: 0.3.43
+Version: 0.3.45
 Summary: ae namespace module portion base: basic constants, helper functions and context manager
 Home-page: https://gitlab.com/ae-group/ae_base
 Author: AndiEcker
@@ -55,17 +55,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.43
+# base 0.3.45
 
 [![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.42?logo=python)](
-    https://gitlab.com/ae-group/ae_base/-/tree/release0.3.42)
+    https://img.shields.io/gitlab/pipeline/ae-group/ae_base/release0.3.44?logo=python)](
+    https://gitlab.com/ae-group/ae_base/-/tree/release0.3.44)
 [![PyPIVersions](https://img.shields.io/pypi/v/ae_base)](
     https://pypi.org/project/ae-base/#history)
 
->ae_base module 0.3.43.
+>ae_base module 0.3.45.
 
 [![Coverage](https://ae-group.gitlab.io/ae_base/coverage.svg)](
     https://ae-group.gitlab.io/ae_base/coverage/index.html)

{ae_base-0.3.43 → ae_base-0.3.45}/README.md

@@ -1,16 +1,16 @@
 <!-- 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.43
+# base 0.3.45
 
 [![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.42?logo=python)](
-    https://gitlab.com/ae-group/ae_base/-/tree/release0.3.42)
+    https://img.shields.io/gitlab/pipeline/ae-group/ae_base/release0.3.44?logo=python)](
+    https://gitlab.com/ae-group/ae_base/-/tree/release0.3.44)
 [![PyPIVersions](https://img.shields.io/pypi/v/ae_base)](
     https://pypi.org/project/ae-base/#history)
 
->ae_base module 0.3.43.
+>ae_base module 0.3.45.
 
 [![Coverage](https://ae-group.gitlab.io/ae_base/coverage.svg)](
     https://ae-group.gitlab.io/ae_base/coverage/index.html)

{ae_base-0.3.43 → ae_base-0.3.45}/ae/base.py

@@ -173,7 +173,7 @@ from types import ModuleType
 from typing import Any, Callable, Dict, Generator, Iterable, List, Optional, Tuple, Union, cast
 
 
-__version__ = '0.3.43'
+__version__ = '0.3.45'
 
 
 os_path_abspath = os.path.abspath
@@ -353,7 +353,6 @@ ASCII_UNICODE = (
     (')', '⟯'),     # U+27EF: MATHEMATICAL RIGHT FLATTENED PARENTHESIS
     ('[', '⟦'),     # U+27E6: MATHEMATICAL LEFT WHITE SQUARE BRACKET
     (']', '⟧'),     # U+27E7: MATHEMATICAL RIGHT WHITE SQUARE BRACKET
-    ('_', '𛲖'),     # U+1BC96: Duployan Affix Low Line; '＿' U+FF3F Fullwidth Low Line
     ('#', '﹟'),     # U+FE5F: Small Number Sign
     (';', '﹔'),     # U+FE54: Small Semicolon
     ('@', '﹫'),     # U+FE6B: Small Commercial At
@@ -364,10 +363,15 @@ ASCII_UNICODE = (
     ('%', '﹪'),     # U+FE6A: Small Percent Sign
     ('^', '＾'),     # U+FF3E: Fullwidth Circumflex Accent
     (',', '﹐'),     # U+FE50: Small Comma
-    (' ', '　'),     # U+3000: Ideographic Space; ' ' U+200A Hair Space; ' ' U+2007 Figure Space;
-                    # ' ' U+2009 Thin; ' ' U+2003 Em Space; ' ' U+2002 En Space; ' ' U+2008 Punctuation Space
-                    # ' ' U+00A0: No-Break Space (NBSP); ' ' U+202F: Narrow No-Break Space (NNBSP)
+    (' ', '␣'),     # U+2423: Open Box; more see underneath and https://unicode-explorer.com/articles/space-characters:
+                    # ' ' U+00A0: No-Break Space (NBSP); '?¿?' U+1680 Ogham Space Mark; ' ' U+2000 En Quad;
+                    # ' ' U+2001 Em Quad; ' ' U+2002 En Space; ' ' U+2003 Em Space; ' ' U+2004 Three-Per-Em
+                    # ' ' U+2005 Four-Per-Em; ' ' U+2006 Six-Per-Em; ' ' U+2007 Figure Space;
+                    # ' ' U+2008 Punctuation Space; ' ' U+2009 Thin; ' ' U+200A Hair Space;
+                    # ' ' U+202F: Narrow No-Break Space (NNBSP); ' ' U+205F Medium Mathematical Space;
+                    # '␠' U+2420 symbol for space; '␣' U+2423 Open Box; '　' U+3000: Ideographic Space
     (chr(127), '␡'),  # U+2421: DELETE SYMBOL
+    # ('_', '𛲖'),     # U+1BC96: Duployan Affix Low Line; '＿' U+FF3F Fullwidth Low Line
 )
 """ transformation table of special ASCII to Unicode alternative character,
 see https://www.compart.com/en/unicode/category/Po and https://xahlee.info/comp/unicode_naming_slash.html (http!) """
@@ -1092,7 +1096,8 @@ def utc_datetime() -> datetime.datetime:
     return datetime.datetime.now(datetime.timezone.utc).replace(tzinfo=None)
 
 
-def write_file(file_path: str, content: Union[str, bytes], extra_mode: str = "", encoding: Optional[str] = None):
+def write_file(file_path: str, content: Union[str, bytes],
+               extra_mode: str = "", encoding: Optional[str] = None, make_dirs: bool = False):
     """ (over)write the file specified by :paramref:`~write_file.file_path` with text or binary/bytes content.
 
     :param file_path:           file path/name to write the passed content into (overwriting any previous content!).
@@ -1105,6 +1110,8 @@ def write_file(file_path: str, content: Union[str, bytes], extra_mode: str = "",
                                 be automatically added to the `mode` argument of :func:`open` (if not already specified
                                 in this argument).
     :param encoding:            encoding used to write/convert/interpret the file content to write.
+    :param make_dirs:           pass True to automatically create not existing folders specified in
+                                :paramref:`~write_file.file_path`.
     :raises FileExistsError:    if file exists already and is write-protected.
     :raises FileNotFoundError:  if parts of the file path do not exist.
     :raises OSError:            if :paramref:`~write_file.file_path` is misspelled or contains invalid characters.
@@ -1120,6 +1127,9 @@ def write_file(file_path: str, content: Union[str, bytes], extra_mode: str = "",
     for an intent result.
     Related german docs: https://developer.android.com/training/data-storage/shared/media?hl=de
     """
+    if make_dirs and (dir_path := os_path_dirname(file_path)):
+        os.makedirs(dir_path, exist_ok=True)
+
     if isinstance(content, bytes) and 'b' not in extra_mode:
         extra_mode += 'b'
 

{ae_base-0.3.43 → ae_base-0.3.45/ae_base.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: ae_base
-Version: 0.3.43
+Version: 0.3.45
 Summary: ae namespace module portion base: basic constants, helper functions and context manager
 Home-page: https://gitlab.com/ae-group/ae_base
 Author: AndiEcker
@@ -55,17 +55,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.43
+# base 0.3.45
 
 [![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.42?logo=python)](
-    https://gitlab.com/ae-group/ae_base/-/tree/release0.3.42)
+    https://img.shields.io/gitlab/pipeline/ae-group/ae_base/release0.3.44?logo=python)](
+    https://gitlab.com/ae-group/ae_base/-/tree/release0.3.44)
 [![PyPIVersions](https://img.shields.io/pypi/v/ae_base)](
     https://pypi.org/project/ae-base/#history)
 
->ae_base module 0.3.43.
+>ae_base module 0.3.45.
 
 [![Coverage](https://ae-group.gitlab.io/ae_base/coverage.svg)](
     https://ae-group.gitlab.io/ae_base/coverage/index.html)

{ae_base-0.3.43 → ae_base-0.3.45}/tests/test_base.py

@@ -1,6 +1,7 @@
 """ ae.base unit tests """
 import datetime
 import os
+import string
 import tempfile
 
 import pytest
@@ -27,8 +28,9 @@ from ae.base import (
 
 
 tst_uri1 = "schema://user:pwd@domain/path_root/path_sub\\path+file% Üml?ä|ït.path_ext*\"<>|*'()[]{}#^;&=$,~" + chr(127)
-tst_fna1 = "schema⫻user﹕pwd﹫domain⁄path𛲖root⁄path𛲖sub﹨path﹢file﹪　Üml﹖ä।ït.path𛲖ext﹡＂⟨⟩।﹡‘⟮⟯⟦⟧{}﹟＾﹔﹠﹦﹩﹐~␡"
-tst_fna2 = "test control chars" + "".join(chr(_) for _ in range(1, 32))
+tst_fna1 = "schema⫻user﹕pwd﹫domain⁄path_root⁄path_sub﹨path﹢file﹪␣Üml﹖ä।ït.path_ext﹡＂⟨⟩।﹡‘⟮⟯⟦⟧{}﹟＾﹔﹠﹦﹩﹐~␡"
+tst_uri2 = "test control chars" + "".join(chr(_) for _ in range(1, 32))
+tst_fna2 = "test␣control␣chars␁␂␃␄␅␆␇␈␉␊␋␌␍␎␏␐␑␒␓␔␕␖␗␘␙␚␛␜␝␞␟"
 
 env_var_name = 'env_var_nam1'
 env_var_val = 'value of env var'
@@ -176,13 +178,17 @@ class TestBaseHelpers:
 
     def test_dedefuse_file_name(self):
         assert dedefuse(tst_fna1) == tst_uri1
-        assert defuse(dedefuse(tst_fna1)) == tst_fna1
+        assert dedefuse(tst_fna2) == tst_uri2
 
-        assert dedefuse(defuse(tst_fna2)) == tst_fna2
+        assert dedefuse(defuse(tst_uri1)) == tst_uri1
+        assert dedefuse(defuse(tst_uri2)) == tst_uri2
 
     def test_defuse_file_name(self):
         assert defuse(tst_uri1) == tst_fna1
-        assert dedefuse(defuse(tst_uri1)) == tst_uri1
+        assert defuse(tst_uri2) == tst_fna2
+
+        assert defuse(dedefuse(tst_fna1)) == tst_fna1
+        assert defuse(dedefuse(tst_fna2)) == tst_fna2
 
     def test_defuse_os_file_name(self):
         try:
@@ -196,10 +202,18 @@ class TestBaseHelpers:
             if os.path.exists(tst_fna2):
                 os.remove(tst_fna2)
 
-    def test_defuse_maps(self):
+    def test_defuse_maps_integrity(self):
         assert URI_SEP_CHAR not in UNICODE_TO_ASCII
         assert len(UNICODE_TO_ASCII) == len(ASCII_TO_UNICODE)   # check for duplicates in the ASCII_UNICODE map
 
+    def test_defuse_maps_not_touching_chars_allowed_as_slug_and_filename(self):
+        assert '-' not in ASCII_TO_UNICODE
+        assert '_' not in ASCII_TO_UNICODE
+        assert '.' not in ASCII_TO_UNICODE
+        assert '~' not in ASCII_TO_UNICODE
+        for char in string.ascii_letters + string.digits:
+            assert char not in ASCII_TO_UNICODE
+
     def test_dummy_function(self):
         assert dummy_function() is None
         assert dummy_function(999, "any_args") is None
@@ -769,6 +783,27 @@ class TestBaseHelpers:
             if os.path.exists(test_file):
                 os.remove(test_file)
 
+    def test_write_file_make_dirs(self):
+        root_dir = os.path.join(TESTS_FOLDER, 'root path of file')
+        test_dir = os.path.join(root_dir, '1st sub dir of file', 'subDir2')
+        test_file = os.path.join(test_dir, 'file in sub dir.ext')
+        content = "any content"
+        assert not os.path.exists(test_dir)
+        assert not os.path.exists(test_file)
+        try:
+            with pytest.raises(FileNotFoundError):
+                write_file(test_file, content)
+            write_file(test_file, content, make_dirs=True)
+            assert os.path.exists(test_dir)
+            assert os.path.isdir(test_dir)
+            assert os.path.exists(test_file)
+            assert os.path.isfile(test_file)
+            assert read_file(test_file) == content
+
+        finally:
+            if os.path.exists(root_dir):
+                shutil.rmtree(root_dir)
+
 
 class TestModuleHelpers:
     def test_module_attr_callable_with_args(self):