encommon 0.22.4__py3-none-any.whl → 0.22.6__py3-none-any.whl

encommon/colors/color.py

@@ -7,6 +7,7 @@ is permitted, for more information consult the project license file.
 
 
 
+from colorsys import hls_to_rgb
 from contextlib import suppress
 from typing import Union
 
@@ -61,6 +62,51 @@ class Color:
         self.__source = source
 
 
+    @classmethod
+    def from_hsl(
+        cls,
+        hue: int,
+        sat: int,
+        lev: int,
+    ) -> 'Color':
+        """
+        Initialize instance for class using provided parameters.
+        """
+
+        h, s, l = (  # noqa: E741
+            hue / 360,
+            sat / 100,
+            lev / 100)
+
+        r, g, b = hls_to_rgb(h, l, s)
+
+        color = (
+            f'{round(r * 255):02X}'
+            f'{round(g * 255):02X}'
+            f'{round(b * 255):02X}')
+
+        return cls(color)
+
+
+    @classmethod
+    def from_rgb(
+        cls,
+        red: int,
+        green: int,
+        blue: int,
+    ) -> 'Color':
+        """
+        Initialize instance for class using provided parameters.
+        """
+
+        value = (
+            f'{red:02X}'
+            f'{green:02X}'
+            f'{blue:02X}')
+
+        return cls(value)
+
+
     def __repr__(
         self,
     ) -> str:

encommon/colors/test/test_color.py

@@ -84,6 +84,7 @@ def test_Color_rgb(
     """
 
     assert Color(source).rgb == expect
+    assert Color.from_rgb(*expect) == source
 
 
 
@@ -155,7 +156,7 @@ def test_Color_xy(
      ('ffff00', (60, 100, 50)),
      ('00ffff', (180, 100, 50)),
      ('ff00ff', (300, 100, 50)),
-     ('800080', (300, 100, 25))])
+     ('80007F', (300, 100, 25))])
 def test_Color_hsl(
     source: str,
     expect: tuple[int, ...],
@@ -168,6 +169,7 @@ def test_Color_hsl(
     """
 
     assert Color(source).hsl == expect
+    assert Color.from_hsl(*expect) == source
 
 
 

encommon/times/test/test_timers.py

@@ -100,8 +100,8 @@ def test_Timers(
         '_Timers__params',
         '_Timers__store',
         '_Timers__group',
-        '_Timers__store_engine',
-        '_Timers__store_session',
+        '_Timers__sengine',
+        '_Timers__session',
         '_Timers__timers']
 
 

encommon/times/test/test_windows.py

@@ -111,8 +111,8 @@ def test_Windows(
         '_Windows__params',
         '_Windows__store',
         '_Windows__group',
-        '_Windows__store_engine',
-        '_Windows__store_session',
+        '_Windows__sengine',
+        '_Windows__session',
         '_Windows__start',
         '_Windows__stop',
         '_Windows__windows']

encommon/times/timers.py

@@ -107,8 +107,8 @@ class Timers:
     __store: str
     __group: str
 
-    __store_engine: Engine
-    __store_session: (
+    __sengine: Engine
+    __session: (
         # pylint: disable=unsubscriptable-object
         sessionmaker[Session])
 
@@ -152,17 +152,18 @@ class Timers:
         Construct instances using the configuration parameters.
         """
 
-        store = self.__store
-
-        engine = create_engine(store)
+        sengine = create_engine(
+            self.__store,
+            pool_pre_ping=True)
 
         (SQLBase.metadata
-         .create_all(engine))
+         .create_all(sengine))
 
-        session = sessionmaker(engine)
+        session = (
+            sessionmaker(sengine))
 
-        self.__store_engine = engine
-        self.__store_session = session
+        self.__sengine = sengine
+        self.__session = session
 
 
     @property
@@ -214,7 +215,7 @@ class Timers:
         :returns: Value for the attribute from class instance.
         """
 
-        return self.__store_engine
+        return self.__sengine
 
 
     @property
@@ -227,7 +228,7 @@ class Timers:
         :returns: Value for the attribute from class instance.
         """
 
-        return self.__store_session()
+        return self.__session()
 
 
     @property

encommon/times/windows.py

@@ -109,8 +109,8 @@ class Windows:
     __store: str
     __group: str
 
-    __store_engine: Engine
-    __store_session: (
+    __sengine: Engine
+    __session: (
         # pylint: disable=unsubscriptable-object
         sessionmaker[Session])
 
@@ -168,17 +168,18 @@ class Windows:
         Construct instances using the configuration parameters.
         """
 
-        store = self.__store
-
-        engine = create_engine(store)
+        sengine = create_engine(
+            self.__store,
+            pool_pre_ping=True)
 
         (SQLBase.metadata
-         .create_all(engine))
+         .create_all(sengine))
 
-        session = sessionmaker(engine)
+        session = (
+            sessionmaker(sengine))
 
-        self.__store_engine = engine
-        self.__store_session = session
+        self.__sengine = sengine
+        self.__session = session
 
 
     @property
@@ -230,7 +231,7 @@ class Windows:
         :returns: Value for the attribute from class instance.
         """
 
-        return self.__store_engine
+        return self.__sengine
 
 
     @property
@@ -243,7 +244,7 @@ class Windows:
         :returns: Value for the attribute from class instance.
         """
 
-        return self.__store_session()
+        return self.__session()
 
 
     @property

encommon/utils/__init__.py

@@ -7,6 +7,7 @@ is permitted, for more information consult the project license file.
 
 
 
+from .files import append_text
 from .files import read_text
 from .files import save_text
 from .match import fuzz_match
@@ -27,6 +28,7 @@ from .stdout import strip_ansi
 
 
 __all__ = [
+    'append_text',
     'array_ansi',
     'fuzz_match',
     'kvpair_ansi',

encommon/utils/files.py

@@ -23,6 +23,8 @@ def read_text(
 
     Example
     -------
+    >>> path.exists()
+    False
     >>> save_text(path, 'foo')
     'foo'
     >>> read_text(path)
@@ -52,6 +54,8 @@ def save_text(
 
     Example
     -------
+    >>> path.exists()
+    False
     >>> save_text(path, 'foo')
     'foo'
     >>> read_text(path)
@@ -69,3 +73,38 @@ def save_text(
         encoding='utf-8')
 
     return read_text(path)
+
+
+
+def append_text(
+    path: str | Path,
+    content: str,
+) -> None:
+    """
+    Append the provided text content into provided file path.
+
+    .. testsetup::
+       >>> tmpdir = getfixture('tmpdir')
+       >>> path = Path(f'{tmpdir}/text.txt')
+
+    Example
+    -------
+    >>> path.exists()
+    False
+    >>> append_text(path, 'foo')
+    >>> append_text(path, 'foo')
+    >>> read_text(path)
+    'foofoo'
+
+    :param path: Complete or relative path to the text file.
+    :param content: Content that will be written to the file.
+    """
+
+    path = Path(path).resolve()
+
+    with path.open(
+        mode='a',
+        encoding='utf-8',
+    ) as file:
+
+        file.write(f'{content}')

encommon/utils/test/test_files.py

@@ -9,6 +9,7 @@ is permitted, for more information consult the project license file.
 
 from pathlib import Path
 
+from ..files import append_text
 from ..files import read_text
 from ..files import save_text
 
@@ -33,3 +34,30 @@ def test_readsave_text(
         f'{tmp_path}/test.txt')
 
     assert loaded == content
+
+
+
+def test_append_text(
+    tmp_path: Path,
+) -> None:
+    """
+    Perform various tests associated with relevant routines.
+
+    :param tmp_path: pytest object for temporal filesystem.
+    """
+
+    content = 'pytest'
+
+    append_text(
+        f'{tmp_path}/test.txt',
+        content)
+
+    append_text(
+        f'{tmp_path}/test.txt',
+        content)
+
+    loaded = read_text(
+        f'{tmp_path}/test.txt')
+
+    assert loaded == (
+        f'{content}{content}')

encommon/version.txt

@@ -1 +1 @@
-0.22.4
+0.22.6

{encommon-0.22.4.dist-info → encommon-0.22.6.dist-info}/METADATA

@@ -1,6 +1,6 @@
-Metadata-Version: 2.2
+Metadata-Version: 2.4
 Name: encommon
-Version: 0.22.4
+Version: 0.22.6
 Summary: Enasis Network Common Library
 License: MIT
 Project-URL: Source, https://github.com/enasisnetwork/encommon
@@ -20,6 +20,7 @@ Requires-Dist: python-dateutil
 Requires-Dist: pyyaml
 Requires-Dist: snaptime
 Requires-Dist: sqlalchemy
+Dynamic: license-file
 
 # Enasis Network Common Library
 

{encommon-0.22.4.dist-info → encommon-0.22.6.dist-info}/RECORD

@@ -1,11 +1,11 @@
 encommon/__init__.py,sha256=YDGzuhpk5Gd1hq54LI0hw1NrrDvrJDrvH20TEy_0l5E,443
 encommon/conftest.py,sha256=I7Zl2cMytnA-mwSPh0rRjsU0YSlES94jQq6mocRhVUE,1884
 encommon/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-encommon/version.txt,sha256=-eRxdwnwDKJRp0_JuBOL0dSCuOs0VzMGRMBCywRYzlQ,7
+encommon/version.txt,sha256=9re3L5NjSNkeHKRqeABthCK7OCnb0x1tZy-Fuc591KY,7
 encommon/colors/__init__.py,sha256=XRiGimMj8oo040NO5a5ZsbsIUxaGVW4tf4xWTPWgnZY,269
-encommon/colors/color.py,sha256=YmmJzwTGdTafe_cWENvvoyW4YCyeycVIqCDJYLr4k-w,10918
+encommon/colors/color.py,sha256=vdOqOsJYJcrGq0b4udegrn4E8gcuVGx6iTRg3_s8Z-Q,11798
 encommon/colors/test/__init__.py,sha256=PjrnBYT0efyvbaGeNx94dm3tP3EVHUHSVs-VGeLEv5g,218
-encommon/colors/test/test_color.py,sha256=ljAcVJ_DMeDcL_8cG05-uvxu_jErylUf3RDaswpn9-g,4596
+encommon/colors/test/test_color.py,sha256=o0CRVdKhfya304IWrk0Vr1ZsmPqUyD7WxqHzG-E3KHM,4686
 encommon/config/__init__.py,sha256=iZdbW7A4m7iN4xt5cEeQqo0Klqs-CaPLdD5ocLmUYi8,856
 encommon/config/config.py,sha256=dgJD9Ftj7i309ZBecbILcNGW2WALKdIjDnwa9WoggyM,7000
 encommon/config/files.py,sha256=dSuShvIbQXFiNmpkwNVHCKDI-phBWC03OJVUfKJnfX0,2433
@@ -39,22 +39,22 @@ encommon/times/params.py,sha256=qg0mLkXVsl54m72kd9uXRvmYKqUR_Ag5PBfnTsrwQhE,4360
 encommon/times/parse.py,sha256=_PF12z-UOa75SyeUpBXVn7Jjt-c-Pfnzt6pAs_PjXmQ,6496
 encommon/times/time.py,sha256=Px_9Ifae7GKSY557FAbG1g9cwy3a6VZL09puAbinztQ,11745
 encommon/times/timer.py,sha256=xxS6KVXFuRLq-RkXWMR7MMX5x0HGrEhLlOhRCecuCZY,3225
-encommon/times/timers.py,sha256=JwvBIfWbXjwoIDQ08k2MAOoMif0Q1jsIJjmFWMxSRGA,9807
+encommon/times/timers.py,sha256=4kRUd_posGCLSi6hW8aBDypNgnUjnfkbuKpAr4mjOLg,9815
 encommon/times/unitime.py,sha256=MwYUJBdX_Rj7pW8QoMtZMUyHa4lsdZKryTdBCpVjnpY,1316
 encommon/times/utils.py,sha256=PJ5QsKb3_pYEnD3Sz81d8QDhYQtTIj4HJfMoC9gNwmo,3100
 encommon/times/window.py,sha256=tnOPz57cwIXVnOEGh7WPvBPhdjenvw1bYxV4mz721n0,8490
-encommon/times/windows.py,sha256=oxEsCsM8qPQ5AbB8IRK_ONEWzLgXPpft8yR6xUKrb_4,10853
+encommon/times/windows.py,sha256=DaouFEVwiBz5JfOHqJX5b13dsCF4RU5FO1bd3E23HIU,10861
 encommon/times/test/__init__.py,sha256=PjrnBYT0efyvbaGeNx94dm3tP3EVHUHSVs-VGeLEv5g,218
 encommon/times/test/test_duration.py,sha256=3Tw6Y_ah36GCJl4vZ76z4Jt7rIxcm9P18-A69qsbLjI,4224
 encommon/times/test/test_params.py,sha256=kHvs-WvKfPQCdCDnPU9tAyMVXmzH3eUjwQN-QdWBeh4,1407
 encommon/times/test/test_parse.py,sha256=3Dihhu8xKmgbcq_dqKcO-itAeGtqAJxjGFQ6dPsJ4XM,4210
 encommon/times/test/test_time.py,sha256=XTgtsil2dgkeBUlJyORsNKUapcZWDFvOU-JwtypA6zw,2257
 encommon/times/test/test_timer.py,sha256=cBZvO-k-FG7k4LICLLGVFxNBJuTjH4-eL4FNaa14uyY,1563
-encommon/times/test/test_timers.py,sha256=zW6czbR5Ujz2cM4K935HCpO6Rx9EHxCgpFqktGYw8Xs,3892
+encommon/times/test/test_timers.py,sha256=HePWaNNH4MTDZoa2H-S_XkmN32lZLXW3g5xv-zTCyl0,3881
 encommon/times/test/test_unitime.py,sha256=5i4UjBCw8R9h-Lw963GfB_dHBMEQhjvv1k-t27Wyyls,510
 encommon/times/test/test_utils.py,sha256=WkzHJY6zOt02Ujg5FItOo1nPtktz5ss8ODmG1tRQaaw,2056
 encommon/times/test/test_window.py,sha256=6ySO5DaYzg1bsVNCqB6u71rKWc0vpolxQ09ruoswN2c,6138
-encommon/times/test/test_windows.py,sha256=Sq31BCvJtEN9OGGYXFKiagVZP0kc1n6HuaEBNwbkuks,4496
+encommon/times/test/test_windows.py,sha256=drcPbtGxr7Y8hKiU7XM3rkHYG5tkrq6oG-KRwj6Er2c,4485
 encommon/types/__init__.py,sha256=rly7loMD1R7YU83u90KqPYiifjZAX_UAXpVGcB_Xerk,1269
 encommon/types/classes.py,sha256=FYFTu8Uj-74JWudHOlhaOrsXXPxitorBfM9_QM3EGSU,1689
 encommon/types/dicts.py,sha256=IuLoVdtilhM83ujT74mcz0Zi1HI87P4k7wjnnyMxPag,2821
@@ -72,15 +72,15 @@ encommon/types/test/test_funcs.py,sha256=dYVJgihEj1j3F-OxH0mYSIMoDwZbjvgMnvJKea8
 encommon/types/test/test_lists.py,sha256=uRdON1vnDT21TBl2prlO15SHIkN7YOApZzHS78R-Bvs,1139
 encommon/types/test/test_notate.py,sha256=KTOqlHUuS7ed80_h0n7TJNkAqoeULrkbiMH6sPw0lak,9520
 encommon/types/test/test_strings.py,sha256=oXusioFMdknHeBdwlP_GakDVS9Tf2YBndjonj22UfmM,1277
-encommon/utils/__init__.py,sha256=bBgh81wX_TwLgWkx0aBAyVLHNphrfcyQc1AF7-ziyNI,1027
+encommon/utils/__init__.py,sha256=Wb-YFSoGlcAW36LsaQTc_IYiqDbb2d8m_ggej42LNeI,1077
 encommon/utils/common.py,sha256=-bjGJ2UJa-WTOsVYiuZcVj1gkyH5OlRdRkJtxPw8J6k,555
-encommon/utils/files.py,sha256=2uj10JfvKZHdLHNF992_LUvQ4rfMRCZGqJd7LrxKDnE,1458
+encommon/utils/files.py,sha256=mP8p9mcYcK3dGqWcLvYxnYamqa0udmtTbXWVPo6i9W4,2208
 encommon/utils/match.py,sha256=XvmmMKQ1q8_21zzPGuVvaZf6XwHXPZn4IWIYBEqVCQM,2471
 encommon/utils/paths.py,sha256=u8-vTONG3QdnpkKfVpl19WssH95bCHg1gHlnRwzyAFM,3509
 encommon/utils/sample.py,sha256=wcT_me9L-U6atd8kEew4q_4B-iIn8vV1LhEDoVr-cFw,4834
 encommon/utils/stdout.py,sha256=nzXvdnvgjfdtLlAdIsOZurjGMfUX239gZZxPPQK9BIw,8595
 encommon/utils/test/__init__.py,sha256=PjrnBYT0efyvbaGeNx94dm3tP3EVHUHSVs-VGeLEv5g,218
-encommon/utils/test/test_files.py,sha256=-hdl4UOo-vH1H5gTL1r9Ib3P26DtWaD2YV32P08ykvc,679
+encommon/utils/test/test_files.py,sha256=Nc7EteuZpnaFaF8OaqzEhuui9_SYHG1SK1OcoX9jEa8,1175
 encommon/utils/test/test_match.py,sha256=QagKpTFdRo23-Y55fSaJrSMpt5jIebScKbz0h8tivrI,1124
 encommon/utils/test/test_paths.py,sha256=4AzIhQyYFEWhRWHgOZCCzomQ3Zs3EVwRnDQDa6Nq1Mc,1942
 encommon/utils/test/test_sample.py,sha256=Qf-W0XbjTe5PfG87sdVizL2ymUPRTdX0qQtLGHaTgx8,3539
@@ -131,8 +131,8 @@ encommon/webkit/test/test_moderate.py,sha256=KitKGBtwHOQm0pXXZA5nl9MwAi2pbHOsKhM
 encommon/webkit/test/test_numeric.py,sha256=9Jqiyo-Bh572QJSyd3gqRwYTifnqqzE7_cNCmLn0CG0,3531
 encommon/webkit/test/test_statate.py,sha256=4VvmyJhsK3TSK-hq3TzkzwPkXY-GPTU_7uJf-zG_y_s,1760
 encommon/webkit/test/test_tagues.py,sha256=LQWk6rSBoBxAu-YmUOU8uWNki5RBzk5lp0dbFpySg68,1431
-encommon-0.22.4.dist-info/LICENSE,sha256=otnXKCtMjPlbHs0wgZ_BWULrp3g_2dWQJ6icRk9nkgg,1071
-encommon-0.22.4.dist-info/METADATA,sha256=Lza7EHPRbAHTVhizIOg3YUEHJAyAbVAx3MtNkHJaNwU,4282
-encommon-0.22.4.dist-info/WHEEL,sha256=jB7zZ3N9hIM9adW7qlTAyycLYW9npaWKLRzaoVcLKcM,91
-encommon-0.22.4.dist-info/top_level.txt,sha256=bP8q7-5tLDNm-3XPlqn_bDENfYNug5801H_xfz3BEAM,9
-encommon-0.22.4.dist-info/RECORD,,
+encommon-0.22.6.dist-info/licenses/LICENSE,sha256=otnXKCtMjPlbHs0wgZ_BWULrp3g_2dWQJ6icRk9nkgg,1071
+encommon-0.22.6.dist-info/METADATA,sha256=UY0Gl0EMFAOEIPZCq6_sWMH5xtVlmtkOyZm3o_Fsv5k,4304
+encommon-0.22.6.dist-info/WHEEL,sha256=CmyFI0kx5cdEMTLiONQRbGQwjIoR1aIYB7eCAQ4KPJ0,91
+encommon-0.22.6.dist-info/top_level.txt,sha256=bP8q7-5tLDNm-3XPlqn_bDENfYNug5801H_xfz3BEAM,9
+encommon-0.22.6.dist-info/RECORD,,

{encommon-0.22.4.dist-info → encommon-0.22.6.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (75.8.2)
+Generator: setuptools (78.1.0)
 Root-Is-Purelib: true
 Tag: py3-none-any