utilo 2.106.1__tar.gz

utilo-2.106.1/PKG-INFO

@@ -0,0 +1,32 @@
+Metadata-Version: 2.4
+Name: utilo
+Version: 2.106.1
+Summary: write it once
+Home-page: https://github.com/anaticulae/utilo
+Author: Helmut Konrad Schewe
+Author-email: helmutus@outlook.com
+Platform: any
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Description-Content-Type: text/markdown
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: platform
+Dynamic: summary
+
+UTILA
+=====
+
+utila is the base package which include redundant functionality for the
+project. The most common steps are implemented in this package to reduce the
+amount of code.
+
+>>> import utilo
+>>> utilo.file_read('README)

utilo-2.106.1/README

@@ -0,0 +1,9 @@
+UTILA
+=====
+
+utila is the base package which include redundant functionality for the
+project. The most common steps are implemented in this package to reduce the
+amount of code.
+
+>>> import utilo
+>>> utilo.file_read('README)

utilo-2.106.1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

utilo-2.106.1/setup.py

@@ -0,0 +1,84 @@
+#!/usr/bin/env python
+#==============================================================================
+# C O P Y R I G H T
+#------------------------------------------------------------------------------
+# Copyright (c) 2019-2024 by Helmut Konrad Schewe. All rights reserved.
+# This file is property of Helmut Konrad Schewe. Any unauthorized copy,
+# use or distribution is an offensive act against international law and may
+# be prosecuted under federal law. Its content is company confidential.
+#==============================================================================
+
+import os
+import re
+import subprocess
+
+import setuptools
+
+ROOT = os.path.dirname(__file__)
+
+with open(os.path.join(ROOT, 'README'), encoding='utf8') as fp:
+    README = fp.read()
+
+with open(os.path.join(ROOT, 'utilo/__init__.py'), encoding='utf8') as fp:
+    VERSION = re.search(r'__version__ = \'(.*?)\'', fp.read()).group(1)
+
+
+def version() -> str:
+    assert VERSION, VERSION
+    completed = subprocess.run(
+        'git describe'.split(),
+        capture_output=True,
+    )
+    value: str = completed.stdout.strip().decode('utf8')
+    if value == VERSION:
+        return VERSION
+    # transform v2.40.1-5-gc1b4bee to
+    # utilo-2.93.0.post6+g3b6726a
+    value = value[1:]
+    value = value.replace('-', '.post', 1)
+    value = value.replace('-g', '+g')
+    if not value:
+        return VERSION
+    return value
+
+
+if __name__ == "__main__":
+    setuptools.setup(
+        author='Helmut Konrad Schewe',
+        author_email='helmutus@outlook.com',
+        description='write it once',
+        include_package_data=True,
+        long_description=README,
+        long_description_content_type='text/markdown',
+        name='utilo',
+        platforms='any',
+        url='https://github.com/anaticulae/utilo',
+        version=version(),
+        zip_safe=False,  # create 'zip'-file if True. Don't do it!
+        classifiers=[
+            'Programming Language :: Python :: 3.10',
+            'Programming Language :: Python :: 3.11',
+            'Programming Language :: Python :: 3.12',
+            'Programming Language :: Python :: 3.13',
+            'Programming Language :: Python :: 3.14',
+        ],
+        packages=[
+            'utilo',
+            'utilo.classifier',
+            'utilo.cli',
+            'utilo.feature',
+            'utilo.file',
+            'utilo.math',
+            'utilo.string',
+            'utilo.xyz',
+            'utilotest',
+        ],
+        entry_points={
+            'console_scripts': [
+                'utilo_lock = utilo.xyz.lock:main',
+                'utilo_unlock = utilo.xyz.lock:unlock',
+                'utilo_table = utilo.xyz.table:main',
+                'utilo_tidy = utilo.xyz.tidy:main',
+            ],
+        },
+    )

utilo-2.106.1/tests/test_collection.py

@@ -0,0 +1,38 @@
+# =============================================================================
+# C O P Y R I G H T
+# -----------------------------------------------------------------------------
+# Copyright (c) 2019-2024 by Helmut Konrad Schewe. All rights reserved.
+# This file is property of Helmut Konrad Schewe. Any unauthorized copy,
+# use or distribution is an offensive act against international law and may
+# be prosecuted under federal law. Its content is company confidential.
+# =============================================================================
+
+import utilo
+
+
+def test_collection_make_unique():
+    assert utilo.make_unique(['a', 'b', 'c', 'd', 'a']) == ['a', 'b', 'c', 'd']
+    assert utilo.make_unique([1, 2, 3, 1, 2, 3]) == [1, 2, 3]
+
+
+def test_single_contains():
+    single = utilo.Single()
+    assert not single.contains(10)
+    assert single.contains(10)
+
+
+def test_single_contains_unhashable():
+    """Support unhashable items."""
+    single = utilo.Single()
+    assert not single.contains(set())
+    assert single.contains(set())
+
+
+def test_single_equal_hash():
+    assert hash(-2) == hash(-1)
+
+    single = utilo.Single()
+    assert not single.contains(-2)
+    assert not single.contains(-1)
+    assert single.contains(-2)
+    assert single.contains(-1)

utilo-2.106.1/tests/test_convert.py

@@ -0,0 +1,33 @@
+# =============================================================================
+# C O P Y R I G H T
+# -----------------------------------------------------------------------------
+# Copyright (c) 2020-2024 by Helmut Konrad Schewe. All rights reserved.
+# This file is property of Helmut Konrad Schewe. Any unauthorized copy,
+# use or distribution is an offensive act against international law and may
+# be prosecuted under federal law. Its content is company confidential.
+# =============================================================================
+
+import dataclasses
+
+import utilo
+
+
+def test_simplify():
+    """Convert object to python basic data structures."""
+    example = utilo.FeaturePackConfig()
+    simple = utilo.simplify(example)
+    assert 'prefixflag' in simple
+
+
+@dataclasses.dataclass
+class Human:
+    name: str = None
+    year: int = None
+
+
+def test_simplify_dataclass():
+    data = Human('Helm', 1920)
+    before = hash(str(data))
+    simple = utilo.simplify(data)
+    assert simple
+    assert hash(str(data)) == before, 'do not change data while simplify'

utilo-2.106.1/tests/test_datetime.py

@@ -0,0 +1,29 @@
+# =============================================================================
+# C O P Y R I G H T
+# -----------------------------------------------------------------------------
+# Copyright (c) 2019-2024 by Helmut Konrad Schewe. All rights reserved.
+# This file is property of Helmut Konrad Schewe. Any unauthorized copy,
+# use or distribution is an offensive act against international law and may
+# be prosecuted under federal law. Its content is company confidential.
+# =============================================================================
+
+from utilo import current
+from utilo import timedate
+from utilo import today
+
+
+def test_today():
+    assert len(today()) == 10
+    assert today().count('.') == 2
+
+
+def test_current():
+    assert len(current()) == 5
+    assert current().count(':') == 1
+
+    assert len(current(True)) == 8
+    assert current(True).count(':') == 2
+
+
+def test_time_and_date():
+    assert ' ' in timedate()

utilo-2.106.1/tests/test_decorators.py

@@ -0,0 +1,37 @@
+# =============================================================================
+# C O P Y R I G H T
+# -----------------------------------------------------------------------------
+# Copyright (c) 2022-2024 by Helmut Konrad Schewe. All rights reserved.
+# This file is property of Helmut Konrad Schewe. Any unauthorized copy,
+# use or distribution is an offensive act against international law and may
+# be prosecuted under federal law. Its content is company confidential.
+# =============================================================================
+
+import pytest
+
+import utilo
+
+
+@utilo.empty_replace(member=10, glember='hello')
+def replace_default(first=None, glember=utilo.EMPTY, member=utilo.EMPTY):
+    return first, member, glember
+
+
+def test_empty_replace():
+    assert replace_default('?', None) == ('?', 10, None)
+
+
+def test_empty_replace_invalid_signature_does_not_match():
+    with pytest.raises(ValueError):
+
+        @utilo.empty_replace(tember=10, september='hello')
+        def replacce(first=None, member=utilo.EMPTY, glember=utilo.EMPTY):
+            return first, member, glember
+
+
+def test_empty_replace_invalid_signature_missing_default():
+    with pytest.raises(ValueError):
+
+        @utilo.empty_replace(member=1, glember=2, tember=3)
+        def replacce(first=None, member=utilo.EMPTY, glember=utilo.EMPTY):
+            return first, member, glember

utilo-2.106.1/tests/test_error.py

@@ -0,0 +1,91 @@
+#==============================================================================
+# C O P Y R I G H T
+#------------------------------------------------------------------------------
+# Copyright (c) 2019-2024 by Helmut Konrad Schewe. All rights reserved.
+# This file is property of Helmut Konrad Schewe. Any unauthorized copy,
+# use or distribution is an offensive act against international law and may
+# be prosecuted under federal law. Its content is company confidential.
+#==============================================================================
+
+from pytest import raises
+
+from utilo import CANCELLED_BY_USER
+from utilo import FAILURE
+from utilo import handle_error
+from utilo import saveme
+
+
+def test_invoking_exception():
+
+    @saveme
+    def function_with_exception():
+        raise Exception()  # pylint:disable=W0719
+
+    with raises(SystemExit) as exception:
+        function_with_exception()
+
+    assert exception.value.code == FAILURE
+
+
+def test_invoking_exception_with_argument():
+    """Check passing decorator argument"""
+
+    @saveme(systemexit=True)
+    def function_with_exception():
+        raise Exception()  # pylint:disable=W0719
+
+    with raises(SystemExit) as exception:
+        function_with_exception()
+
+    assert exception.value.code == FAILURE
+
+
+def test_canceling_by_user():
+
+    @saveme
+    def keyboard_interrupt():
+        raise KeyboardInterrupt
+
+    with raises(SystemExit) as exception:
+        keyboard_interrupt()
+
+    assert exception.value.code == CANCELLED_BY_USER
+
+
+def test_invoking_empty():
+
+    @saveme
+    def function():
+        return 2
+
+    with raises(SystemExit) as exception:
+        function()
+    assert exception.value.code == 2
+
+
+def test_invoking_exception_without_system_exit():
+
+    @saveme(systemexit=False)
+    def function_with_exception():
+        raise Exception()  # pylint:disable=W0719
+
+    returncode = function_with_exception()
+
+    assert returncode == FAILURE
+
+    @saveme(systemexit=False)
+    def no_exception():
+        return 'Hallo'
+
+    returncode = no_exception()
+
+    assert returncode == 'Hallo'
+
+
+def test_error_handle_error():
+    """Catch raised error and return specified return code `37`"""
+    with raises(SystemExit) as exception:
+        with handle_error(ValueError, code=37):
+            raise ValueError()
+
+    assert exception.value.code == 37