encommon 0.22.4__tar.gz → 0.22.6__tar.gz

{encommon-0.22.4/encommon.egg-info → encommon-0.22.6}/PKG-INFO

@@ -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 → encommon-0.22.6}/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-0.22.4 → encommon-0.22.6}/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-0.22.4 → encommon-0.22.6}/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-0.22.4 → encommon-0.22.6}/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-0.22.4 → encommon-0.22.6}/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-0.22.4 → encommon-0.22.6}/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-0.22.4 → encommon-0.22.6}/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-0.22.4 → encommon-0.22.6}/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-0.22.4 → encommon-0.22.6}/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-0.22.6/encommon/version.txt

@@ -0,0 +1 @@
+0.22.6

{encommon-0.22.4 → encommon-0.22.6/encommon.egg-info}/PKG-INFO

@@ -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/encommon/version.txt

@@ -1 +0,0 @@
-0.22.4