encommon 0.4.1__tar.gz → 0.6.0__tar.gz

{encommon-0.4.1 → encommon-0.6.0}/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2023 Enasis Network
+Copyright (c) 2024 Enasis Network
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

{encommon-0.4.1/encommon.egg-info → encommon-0.6.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: encommon
-Version: 0.4.1
+Version: 0.6.0
 Summary: Enasis Network Common Library
 License: MIT
 Classifier: Programming Language :: Python :: 3
@@ -18,14 +18,15 @@ Requires-Dist: snaptime
 
 # Enasis Network Common Library
 
-[![](https://img.shields.io/github/actions/workflow/status/enasisnetwork/encommon/build.yml?style=flat-square&label=GitHub%20actions)](https://github.com/enasisnetwork/encommon/actions)
-[![](https://img.shields.io/readthedocs/encommon?style=flat-square&label=Read%20the%20Docs)](https://encommon.readthedocs.io/en/stable)
-[![](https://img.shields.io/pypi/v/encommon.svg?style=flat-square&label=PyPi%20version)](https://pypi.org/project/encommon)
-[![](https://img.shields.io/pypi/dm/encommon?style=flat-square&label=PyPi%20downloads)](https://pypi.org/project/encommon)
-
 Common classes and functions used in various public and private projects for
 [Enasis Network](https://github.com/enasisnetwork).
 
+[![](https://img.shields.io/github/actions/workflow/status/enasisnetwork/encommon/build.yml?style=flat-square&label=GitHub%20actions)](https://github.com/enasisnetwork/encommon/actions)<br>
+[![codecov](https://codecov.io/gh/enasisnetwork/encommon/graph/badge.svg?token=7PGOXKJU0E)](https://codecov.io/gh/enasisnetwork/encommon)<br>
+[![](https://img.shields.io/readthedocs/encommon?style=flat-square&label=Read%20the%20Docs)](https://encommon.readthedocs.io/en/stable)<br>
+[![](https://img.shields.io/pypi/v/encommon.svg?style=flat-square&label=PyPi%20version)](https://pypi.org/project/encommon)<br>
+[![](https://img.shields.io/pypi/dm/encommon?style=flat-square&label=PyPi%20downloads)](https://pypi.org/project/encommon)
+
 ## Installing the package
 Installing stable from the PyPi repository
 ```

{encommon-0.4.1 → encommon-0.6.0}/README.md

@@ -1,13 +1,14 @@
 # Enasis Network Common Library
 
-[![](https://img.shields.io/github/actions/workflow/status/enasisnetwork/encommon/build.yml?style=flat-square&label=GitHub%20actions)](https://github.com/enasisnetwork/encommon/actions)
-[![](https://img.shields.io/readthedocs/encommon?style=flat-square&label=Read%20the%20Docs)](https://encommon.readthedocs.io/en/stable)
-[![](https://img.shields.io/pypi/v/encommon.svg?style=flat-square&label=PyPi%20version)](https://pypi.org/project/encommon)
-[![](https://img.shields.io/pypi/dm/encommon?style=flat-square&label=PyPi%20downloads)](https://pypi.org/project/encommon)
-
 Common classes and functions used in various public and private projects for
 [Enasis Network](https://github.com/enasisnetwork).
 
+[![](https://img.shields.io/github/actions/workflow/status/enasisnetwork/encommon/build.yml?style=flat-square&label=GitHub%20actions)](https://github.com/enasisnetwork/encommon/actions)<br>
+[![codecov](https://codecov.io/gh/enasisnetwork/encommon/graph/badge.svg?token=7PGOXKJU0E)](https://codecov.io/gh/enasisnetwork/encommon)<br>
+[![](https://img.shields.io/readthedocs/encommon?style=flat-square&label=Read%20the%20Docs)](https://encommon.readthedocs.io/en/stable)<br>
+[![](https://img.shields.io/pypi/v/encommon.svg?style=flat-square&label=PyPi%20version)](https://pypi.org/project/encommon)<br>
+[![](https://img.shields.io/pypi/dm/encommon?style=flat-square&label=PyPi%20downloads)](https://pypi.org/project/encommon)
+
 ## Installing the package
 Installing stable from the PyPi repository
 ```

{encommon-0.4.1 → encommon-0.6.0}/encommon/config/config.py

@@ -155,9 +155,9 @@ class Config:
         self,
     ) -> Params:
         """
-        Return the configuration in the object format for files.
+        Return the Pydantic model containing the configuration.
 
-        :returns: Configuration in the object format for files.
+        :returns: Pydantic model containing the configuration.
         """
 
         if self.__params is not None:

{encommon-0.4.1 → encommon-0.6.0}/encommon/config/params.py

@@ -20,7 +20,9 @@ class ConfigParams(BaseModel, extra='forbid'):
     """
     Process and validate the common configuration parameters.
 
+    :param paths: Complete or relative path to config paths.
     :param data: Keyword arguments passed to Pydantic model.
+        This parameter is picked up by autodoc, please ignore.
     """
 
     paths: Optional[list[str]] = None
@@ -31,7 +33,11 @@ class LoggerParams(BaseModel, extra='forbid'):
     """
     Process and validate the common configuration parameters.
 
+    :param stdo_level: Minimum log message severity level.
+    :param file_level: Minimum log message severity level.
+    :param file_path: Enables writing to the filesystem path.
     :param data: Keyword arguments passed to Pydantic model.
+        This parameter is picked up by autodoc, please ignore.
     """
 
     stdo_level: Optional[LOGLEVELS] = None
@@ -44,7 +50,11 @@ class Params(BaseModel, extra='forbid'):
     """
     Process and validate the common configuration parameters.
 
+    :param enconfig: Configuration for the `.Config` object.
+    :param enlogger: Configuration for the `.Logger` object.
+    :param encrypts: Configuration for the `.Crypts` object.
     :param data: Keyword arguments passed to Pydantic model.
+        This parameter is picked up by autodoc, please ignore.
     """
 
     enconfig: Optional[ConfigParams] = None

{encommon-0.4.1 → encommon-0.6.0}/encommon/config/test/test_config.py

@@ -25,7 +25,7 @@ SAMPLES = (
 
 
 
-def test_Config(
+def test_Config(  # noqa: CFQ001
     config_path: Path,
 ) -> None:
     """
@@ -108,6 +108,26 @@ def test_Config(
     assert sample == expect
 
 
+    _params1 = config.params
+    _params2 = config.params
+
+    assert _params1 is _params2
+
+    sample = load_sample(
+        path=SAMPLES.joinpath('params.json'),
+        update=ENPYRWS,
+        content=_params1.model_dump(),
+        replace={
+            'config_path': str(config_path)})
+
+    expect = prep_sample(
+        content=_params2.model_dump(),
+        replace={
+            'config_path': str(config_path)})
+
+    assert sample == expect
+
+
     logger = config.logger
 
     assert isinstance(logger, Logger)

{encommon-0.4.1/encommon/config/test → encommon-0.6.0/encommon}/conftest.py

@@ -21,6 +21,7 @@ def config_path(
     Construct the directory and files needed for the tests.
 
     :param tmp_path: pytest object for temporal filesystem.
+    :returns: New resolved filesystem path object instance.
     """
 
 
@@ -40,4 +41,4 @@ def config_path(
         .write_text('name: Tony Stark'))
 
 
-    return tmp_path
+    return tmp_path.resolve()

{encommon-0.4.1 → encommon-0.6.0}/encommon/times/common.py

@@ -20,7 +20,7 @@ if TYPE_CHECKING:
 
 
 NUMERISH = compile(r'^\-?\d+(\.\d+)?$')
-SNAPABLE = compile(r'^\-|\+[\d\@a-z]+$')
+SNAPABLE = compile(r'^(\-|\+)[\d\@a-z\-\+]+$')
 STRINGNOW = {'None', 'null', 'now'}
 
 NUMERIC = Union[int, float]

{encommon-0.4.1 → encommon-0.6.0}/encommon/times/test/test_timers.py

@@ -7,6 +7,7 @@ is permitted, for more information consult the project license file.
 
 
 
+from pathlib import Path
 from time import sleep
 
 from pytest import raises
@@ -25,8 +26,10 @@ def test_Timers() -> None:
     attrs = list(timers.__dict__)
 
     assert attrs == [
-        '_Timers__timing',
-        '_Timers__caches']
+        '_Timers__timers',
+        '_Timers__cache_file',
+        '_Timers__cache_name',
+        '_Timers__cache_dict']
 
 
     assert repr(timers).startswith(
@@ -36,7 +39,11 @@ def test_Timers() -> None:
         '<encommon.times.timers.Timers')
 
 
-    assert timers.timing == {'one': 1}
+    assert timers.timers == {'one': 1}
+    assert timers.cache_file is not None
+    assert len(timers.cache_dict) == 1
+    assert timers.cache_name is not None
+
 
     assert not timers.ready('one')
     sleep(1.1)
@@ -50,6 +57,42 @@ def test_Timers() -> None:
 
 
 
+def test_Timers_cache(
+    tmp_path: Path,
+) -> None:
+    """
+    Perform various tests associated with relevant routines.
+
+    :param tmp_path: pytest object for temporal filesystem.
+    """
+
+    cache_file = (
+        f'{tmp_path}/timers.db')
+
+    timers1 = Timers(
+        timers={'one': 1},
+        cache_file=cache_file)
+
+    assert not timers1.ready('one')
+
+    sleep(0.75)
+
+    timers2 = Timers(
+        timers={'one': 1},
+        cache_file=cache_file)
+
+    assert not timers1.ready('one')
+    assert not timers2.ready('one')
+
+    sleep(0.25)
+
+    timers2.load_cache()
+
+    assert timers1.ready('one')
+    assert timers2.ready('one')
+
+
+
 def test_Timers_raises() -> None:
     """
     Perform various tests associated with relevant routines.

encommon-0.6.0/encommon/times/timers.py

@@ -0,0 +1,287 @@
+"""
+Functions and routines associated with Enasis Network Common Library.
+
+This file is part of Enasis Network software eco-system. Distribution
+is permitted, for more information consult the project license file.
+"""
+
+
+
+from sqlite3 import connect as SQLite
+from typing import Optional
+from typing import TYPE_CHECKING
+
+from .common import NUMERIC
+from .common import PARSABLE
+from .times import Times
+
+if TYPE_CHECKING:
+    from sqlite3 import Connection
+
+
+TABLE = (
+    """
+    create table
+     if not exists
+     {0} (
+      "unique" text not null,
+      "update" text not null,
+     primary key ("unique"));
+    """)  # noqa: LIT003
+
+
+
+class Timers:
+    """
+    Track timers on unique key and determine when to proceed.
+
+    .. warning::
+       This class will use an in-memory database for cache,
+       unless a cache file is explicity defined.
+
+    .. testsetup::
+       >>> from time import sleep
+
+    Example
+    -------
+    >>> timers = Timers({'one': 1})
+    >>> timers.ready('one')
+    False
+    >>> sleep(1)
+    >>> timers.ready('one')
+    True
+
+    :param timers: Seconds that are used for each of timers.
+    :param cache_file: Optional path to SQLite database for
+        cache. This will allow for use between executions.
+    :param cache_name: Optional override default table name.
+    """
+
+    __timers: dict[str, float]
+    __cache_file: 'Connection'
+    __cache_name: str
+    __cache_dict: dict[str, Times]
+
+
+    def __init__(
+        self,
+        timers: Optional[dict[str, NUMERIC]] = None,
+        cache_file: str = ':memory:',
+        cache_name: str = 'encommon_timers',
+    ) -> None:
+        """
+        Initialize instance for class using provided parameters.
+        """
+
+        timers = timers or {}
+
+
+        self.__timers = {
+            k: float(v)
+            for k, v in
+            timers.items()}
+
+
+        cached = SQLite(cache_file)
+
+        cached.execute(
+            TABLE.format(cache_name))
+
+        cached.commit()
+
+        self.__cache_file = cached
+        self.__cache_name = cache_name
+
+
+        self.__cache_dict = {
+            x: Times()
+            for x in
+            self.__timers}
+
+
+        self.load_cache()
+        self.save_cache()
+
+
+    def load_cache(
+        self,
+    ) -> None:
+        """
+        Load the timers cache from the database into attribute.
+        """
+
+        cached = self.__cache_file
+        table = self.__cache_name
+        cachem = self.__cache_dict
+
+        cursor = cached.execute(
+            f'select * from {table}'
+            ' order by "unique" asc')
+
+        records = cursor.fetchall()
+
+        for record in records:
+
+            unique = record[0]
+            update = record[1]
+
+            times = Times(update)
+
+            cachem[unique] = times
+
+
+    def save_cache(
+        self,
+    ) -> None:
+        """
+        Save the timers cache from the attribute into database.
+        """
+
+        cached = self.__cache_file
+        table = self.__cache_name
+        cachem = self.__cache_dict
+
+        insert = [
+            (k, str(v)) for k, v
+            in cachem.items()]
+
+        cached.executemany(
+            (f'replace into {table}'
+             ' ("unique", "update")'
+             ' values (?, ?)'),
+            tuple(insert))
+
+        cached.commit()
+
+
+    @property
+    def timers(
+        self,
+    ) -> dict[str, float]:
+        """
+        Return the property for attribute from the class instance.
+
+        :returns: Property for attribute from the class instance.
+        """
+
+        return dict(self.__timers)
+
+
+    @property
+    def cache_file(
+        self,
+    ) -> 'Connection':
+        """
+        Return the property for attribute from the class instance.
+
+        :returns: Property for attribute from the class instance.
+        """
+
+        return self.__cache_file
+
+
+    @property
+    def cache_dict(
+        self,
+    ) -> dict[str, Times]:
+        """
+        Return the property for attribute from the class instance.
+
+        :returns: Property for attribute from the class instance.
+        """
+
+        return dict(self.__cache_dict)
+
+
+    @property
+    def cache_name(
+        self,
+    ) -> str:
+        """
+        Return the property for attribute from the class instance.
+
+        :returns: Property for attribute from the class instance.
+        """
+
+        return self.__cache_name
+
+
+    def ready(
+        self,
+        unique: str,
+        update: bool = True,
+    ) -> bool:
+        """
+        Determine whether or not the appropriate time has passed.
+
+        .. note::
+           For performance reasons, this method will not notice
+           changes within the database unless refreshed first.
+
+        :param unique: Unique identifier for the timer in mapping.
+        :param update: Determines whether or not time is updated.
+        """
+
+        timers = self.__timers
+        caches = self.__cache_dict
+
+        if unique not in caches:
+            raise ValueError('unique')
+
+        cache = caches[unique]
+        timer = timers[unique]
+
+        ready = cache.elapsed >= timer
+
+        if ready and update:
+            self.update(unique)
+
+        return ready
+
+
+    def update(
+        self,
+        unique: str,
+        started: Optional[PARSABLE] = None,
+    ) -> None:
+        """
+        Update the existing timer from mapping within the cache.
+
+        :param unique: Unique identifier for the timer in mapping.
+        :param started: Override the start time for timer value.
+        """
+
+        caches = self.__cache_dict
+
+        if unique not in caches:
+            raise ValueError('unique')
+
+        caches[unique] = Times(started)
+
+        self.save_cache()
+
+
+    def create(
+        self,
+        unique: str,
+        minimum: int | float,
+        started: Optional[PARSABLE] = None,
+    ) -> None:
+        """
+        Update the existing timer from mapping within the cache.
+
+        :param unique: Unique identifier for the timer in mapping.
+        :param minimum: Determines minimum seconds that must pass.
+        :param started: Determines when the time starts for timer.
+        """
+
+        timers = self.__timers
+        caches = self.__cache_dict
+
+        if unique in caches:
+            raise ValueError('unique')
+
+        timers[unique] = float(minimum)
+        caches[unique] = Times(started)
+
+        self.save_cache()

{encommon-0.4.1 → encommon-0.6.0}/encommon/types/__init__.py

@@ -8,10 +8,14 @@ is permitted, for more information consult the project license file.
 
 
 from .dicts import merge_dicts
+from .dicts import sort_dict
 from .empty import Empty
+from .strings import striplower
 
 
 
 __all__ = [
     'Empty',
-    'merge_dicts']
+    'merge_dicts',
+    'sort_dict',
+    'striplower']

{encommon-0.4.1 → encommon-0.6.0}/encommon/types/dicts.py

@@ -58,3 +58,29 @@ def merge_dicts(
 
         elif force is True:
             dict1[key] = value
+
+
+
+def sort_dict(
+    value: dict[Any, Any],
+    reverse: bool = False,
+) -> dict[Any, Any]:
+    """
+    Sort the keys within the dictionary and return new one.
+
+    Example
+    -------
+    >>> foo = {'b': 'be', 'a': 'ey'}
+    >>> sort_dict(foo)
+    {'a': 'ey', 'b': 'be'}
+    >>> sort_dict(foo, True)
+    {'b': 'be', 'a': 'ey'}
+
+    :param value: Dictionary whose keys are sorted into new.
+    :param reverse: Optionally reverse the sort direction.
+    :returns: New dictionary with keys sorted alphabetical.
+    """
+
+    return dict(sorted(
+        value.items(),
+        reverse=reverse))

encommon-0.6.0/encommon/types/strings.py

@@ -0,0 +1,25 @@
+"""
+Functions and routines associated with Enasis Network Common Library.
+
+This file is part of Enasis Network software eco-system. Distribution
+is permitted, for more information consult the project license file.
+"""
+
+
+
+def striplower(
+    value: str,
+) -> str:
+    """
+    Return the provided string but stripped and lower cased.
+
+    Example
+    -------
+    >>> striplower('  Foo ')
+    'foo'
+
+    :param value: String which will be stripped and lowered.
+    :returns: Provided string but stripped and lower cased.
+    """
+
+    return value.strip().lower()

{encommon-0.4.1 → encommon-0.6.0}/encommon/types/test/test_dicts.py

@@ -10,6 +10,23 @@ is permitted, for more information consult the project license file.
 from copy import deepcopy
 
 from ..dicts import merge_dicts
+from ..dicts import sort_dict
+
+
+
+DICT1 = {
+    'dict1': 'dict1',
+    'str': 'd1string',
+    'list': ['d1list'],
+    'dict': {'key': 'd1value'},
+    'bool': False}
+
+DICT2 = {
+    'dict2': 'dict2',
+    'str': 'd2string',
+    'list': ['d2list'],
+    'dict': {'key': 'd2value'},
+    'bool': True}
 
 
 
@@ -18,19 +35,8 @@ def test_merge_dicts() -> None:
     Perform various tests associated with relevant routines.
     """
 
-    dict1 = {
-        'dict1': 'dict1',
-        'str': 'd1string',
-        'list': ['d1list'],
-        'dict': {'key': 'd1value'},
-        'bool': False}
-
-    dict2 = {
-        'dict2': 'dict2',
-        'str': 'd2string',
-        'list': ['d2list'],
-        'dict': {'key': 'd2value'},
-        'bool': True}
+    dict1 = deepcopy(DICT1)
+    dict2 = deepcopy(DICT2)
 
     dict1['recurse'] = deepcopy(dict1)
     dict2['recurse'] = deepcopy(dict2)
@@ -100,3 +106,17 @@ def test_merge_dicts() -> None:
             'list': ['d1list'],
             'dict': {'key': 'd1value'},
             'bool': False}}
+
+
+
+def test_sort_dict() -> None:
+    """
+    Perform various tests associated with relevant routines.
+    """
+
+    assert sort_dict(DICT1) == {
+        'bool': False,
+        'dict': {'key': 'd1value'},
+        'dict1': 'dict1',
+        'list': ['d1list'],
+        'str': 'd1string'}

encommon-0.6.0/encommon/types/test/test_strings.py

@@ -0,0 +1,19 @@
+"""
+Functions and routines associated with Enasis Network Common Library.
+
+This file is part of Enasis Network software eco-system. Distribution
+is permitted, for more information consult the project license file.
+"""
+
+
+
+from ..strings import striplower
+
+
+
+def test_striplower() -> None:
+    """
+    Perform various tests associated with relevant routines.
+    """
+
+    assert striplower('  Foo ') == 'foo'

{encommon-0.4.1 → encommon-0.6.0}/encommon/utils/sample.py

@@ -98,7 +98,7 @@ def load_sample(
     :param update: Determine whether the sample is updated.
     :param content: Content which will be processed for JSON.
     :param default: Callable used when stringifying values.
-    :param replace: Optional string values to replace in path.
+    :param replace: Optional string values to replace in file.
     :returns: Content after processing using JSON functions.
     """
 

encommon-0.6.0/encommon/version.txt

@@ -0,0 +1 @@
+0.6.0

{encommon-0.4.1 → encommon-0.6.0/encommon.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: encommon
-Version: 0.4.1
+Version: 0.6.0
 Summary: Enasis Network Common Library
 License: MIT
 Classifier: Programming Language :: Python :: 3
@@ -18,14 +18,15 @@ Requires-Dist: snaptime
 
 # Enasis Network Common Library
 
-[![](https://img.shields.io/github/actions/workflow/status/enasisnetwork/encommon/build.yml?style=flat-square&label=GitHub%20actions)](https://github.com/enasisnetwork/encommon/actions)
-[![](https://img.shields.io/readthedocs/encommon?style=flat-square&label=Read%20the%20Docs)](https://encommon.readthedocs.io/en/stable)
-[![](https://img.shields.io/pypi/v/encommon.svg?style=flat-square&label=PyPi%20version)](https://pypi.org/project/encommon)
-[![](https://img.shields.io/pypi/dm/encommon?style=flat-square&label=PyPi%20downloads)](https://pypi.org/project/encommon)
-
 Common classes and functions used in various public and private projects for
 [Enasis Network](https://github.com/enasisnetwork).
 
+[![](https://img.shields.io/github/actions/workflow/status/enasisnetwork/encommon/build.yml?style=flat-square&label=GitHub%20actions)](https://github.com/enasisnetwork/encommon/actions)<br>
+[![codecov](https://codecov.io/gh/enasisnetwork/encommon/graph/badge.svg?token=7PGOXKJU0E)](https://codecov.io/gh/enasisnetwork/encommon)<br>
+[![](https://img.shields.io/readthedocs/encommon?style=flat-square&label=Read%20the%20Docs)](https://encommon.readthedocs.io/en/stable)<br>
+[![](https://img.shields.io/pypi/v/encommon.svg?style=flat-square&label=PyPi%20version)](https://pypi.org/project/encommon)<br>
+[![](https://img.shields.io/pypi/dm/encommon?style=flat-square&label=PyPi%20downloads)](https://pypi.org/project/encommon)
+
 ## Installing the package
 Installing stable from the PyPi repository
 ```

{encommon-0.4.1 → encommon-0.6.0}/encommon.egg-info/SOURCES.txt

@@ -5,6 +5,7 @@ pyproject.toml
 reqs-install.txt
 setup.cfg
 encommon/__init__.py
+encommon/conftest.py
 encommon/py.typed
 encommon/version.txt
 encommon.egg-info/PKG-INFO
@@ -20,7 +21,6 @@ encommon/config/logger.py
 encommon/config/params.py
 encommon/config/paths.py
 encommon/config/test/__init__.py
-encommon/config/test/conftest.py
 encommon/config/test/test_common.py
 encommon/config/test/test_config.py
 encommon/config/test/test_files.py
@@ -50,9 +50,11 @@ encommon/times/test/test_window.py
 encommon/types/__init__.py
 encommon/types/dicts.py
 encommon/types/empty.py
+encommon/types/strings.py
 encommon/types/test/__init__.py
 encommon/types/test/test_dicts.py
 encommon/types/test/test_empty.py
+encommon/types/test/test_strings.py
 encommon/utils/__init__.py
 encommon/utils/common.py
 encommon/utils/match.py

{encommon-0.4.1 → encommon-0.6.0}/setup.cfg

@@ -11,6 +11,7 @@ ignore =
 	W503,
 per-file-ignores = 
 	encommon/crypts/hashes.py:S324,
+	encommon/times/timers.py:S608,
 
 [mypy]
 mypy_path = stubs

encommon-0.4.1/encommon/times/timers.py

@@ -1,144 +0,0 @@
-"""
-Functions and routines associated with Enasis Network Common Library.
-
-This file is part of Enasis Network software eco-system. Distribution
-is permitted, for more information consult the project license file.
-"""
-
-
-
-from typing import Optional
-
-from .common import NUMERIC
-from .common import PARSABLE
-from .times import Times
-
-
-
-class Timers:
-    """
-    Track timers on unique key and determine when to proceed.
-
-    .. testsetup::
-       >>> from time import sleep
-
-    Example
-    -------
-    >>> timing = {'test': 1}
-    >>> timers = Timers(timing)
-    >>> timers.ready('test')
-    False
-    >>> sleep(1)
-    >>> timers.ready('test')
-    True
-
-    :param timing: Seconds that are used for each of timers.
-    """
-
-    __timing: dict[str, float]
-    __caches: dict[str, Times]
-
-
-    def __init__(
-        self,
-        timing: Optional[dict[str, NUMERIC]] = None,
-    ) -> None:
-        """
-        Initialize instance for class using provided parameters.
-        """
-
-        timing = timing or {}
-
-        self.__timing = {
-            k: float(v)
-            for k, v in timing.items()}
-
-        self.__caches = {
-            x: Times()
-            for x in self.__timing}
-
-
-    @property
-    def timing(
-        self,
-    ) -> dict[str, float]:
-        """
-        Return the property for attribute from the class instance.
-
-        :returns: Property for attribute from the class instance.
-        """
-
-        return dict(self.__timing)
-
-
-    def ready(
-        self,
-        unique: str,
-        update: bool = True,
-    ) -> bool:
-        """
-        Determine whether or not the appropriate time has passed.
-
-        :param unique: Unique identifier for the timer in mapping.
-        :param update: Determines whether or not time is updated.
-        """
-
-        timer = self.__timing
-        cache = self.__caches
-
-        if unique not in cache:
-            raise ValueError('unique')
-
-        _cache = cache[unique]
-        _timer = timer[unique]
-
-        ready = _cache.elapsed >= _timer
-
-        if ready and update:
-            self.update(unique)
-
-        return ready
-
-
-    def update(
-        self,
-        unique: str,
-        started: Optional[PARSABLE] = None,
-    ) -> None:
-        """
-        Update the existing timer from mapping within the cache.
-
-        :param unique: Unique identifier for the timer in mapping.
-        :param started: Override the start time for timer value.
-        """
-
-        cache = self.__caches
-
-        if unique not in cache:
-            raise ValueError('unique')
-
-        cache[unique] = Times(started)
-
-
-    def create(
-        self,
-        unique: str,
-        minimum: int | float,
-        started: Optional[PARSABLE] = None,
-    ) -> None:
-        """
-        Update the existing timer from mapping within the cache.
-
-        :param unique: Unique identifier for the timer in mapping.
-        :param started: Determines when the time starts for timer.
-        :param minimum: Determines minimum seconds that must pass.
-        """
-
-        timer = self.__timing
-        cache = self.__caches
-
-        if unique in cache:
-            raise ValueError('unique')
-
-        timer[unique] = float(minimum)
-        cache[unique] = Times(started)

encommon-0.4.1/encommon/version.txt

@@ -1 +0,0 @@
-0.4.1