encommon 0.7.1__py3-none-any.whl → 0.7.2__py3-none-any.whl

encommon/config/params.py

@@ -22,7 +22,7 @@ class ConfigParams(BaseModel, extra='forbid'):
 
     :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.
+        Parameter is picked up by autodoc, please ignore.
     """
 
     paths: Optional[list[str]] = None
@@ -37,7 +37,7 @@ class LoggerParams(BaseModel, extra='forbid'):
     :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.
+        Parameter is picked up by autodoc, please ignore.
     """
 
     stdo_level: Optional[LOGLEVELS] = None
@@ -54,7 +54,7 @@ class Params(BaseModel, extra='forbid'):
     :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.
+        Parameter is picked up by autodoc, please ignore.
     """
 
     enconfig: Optional[ConfigParams] = None

encommon/config/test/__init__.py

@@ -4,3 +4,13 @@ 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 pathlib import Path
+
+
+
+SAMPLES = (
+    Path(__file__).parent
+    .joinpath('samples'))

encommon/config/test/test_config.py

@@ -9,6 +9,7 @@ is permitted, for more information consult the project license file.
 
 from pathlib import Path
 
+from . import SAMPLES
 from ..config import Config
 from ..logger import Logger
 from ..params import Params
@@ -19,12 +20,6 @@ from ...utils.sample import prep_sample
 
 
 
-SAMPLES = (
-    Path(__file__).parent
-    .joinpath('samples'))
-
-
-
 def test_Config(  # noqa: CFQ001
     config_path: Path,
 ) -> None:

encommon/config/test/test_files.py

@@ -9,6 +9,7 @@ is permitted, for more information consult the project license file.
 
 from pathlib import Path
 
+from . import SAMPLES
 from ..files import ConfigFile
 from ..files import ConfigFiles
 from ... import ENPYRWS
@@ -17,12 +18,6 @@ from ...utils.sample import prep_sample
 
 
 
-SAMPLES = (
-    Path(__file__).parent
-    .joinpath('samples'))
-
-
-
 def test_ConfigFile(
     config_path: Path,
 ) -> None:

encommon/config/test/test_paths.py

@@ -9,6 +9,7 @@ is permitted, for more information consult the project license file.
 
 from pathlib import Path
 
+from . import SAMPLES
 from ..paths import ConfigPath
 from ..paths import ConfigPaths
 from ... import ENPYRWS
@@ -17,12 +18,6 @@ from ...utils.sample import prep_sample
 
 
 
-SAMPLES = (
-    Path(__file__).parent
-    .joinpath('samples'))
-
-
-
 def test_ConfigPath(
     config_path: Path,
 ) -> None:

encommon/crypts/params.py

@@ -15,7 +15,9 @@ class CryptsParams(BaseModel, extra='forbid'):
     """
     Process and validate the common configuration parameters.
 
+    :param phrases: Passphrases that are used in operations.
     :param data: Keyword arguments passed to Pydantic model.
+        Parameter is picked up by autodoc, please ignore.
     """
 
     phrases: dict[str, str]

encommon/times/test/test_times.py

@@ -63,6 +63,7 @@ def test_Times() -> None:
     assert times.subsec == UNIXMPOCH
     assert times.human == UNIXHPOCH
     assert times.elapsed >= 1672531200
+    assert times.since >= 1672531200
 
     assert times.before == (
         '1969-12-31T23:59:59.999999Z')

encommon/times/times.py

@@ -346,6 +346,19 @@ class Times:
         return since_time(self.__source)
 
 
+    @property
+    def since(
+        self,
+    ) -> float:
+        """
+        Determine the time in seconds that occured since instance.
+
+        :returns: Time in seconds that occured between the values.
+        """
+
+        return since_time(self.__source)
+
+
     @property
     def before(
         self,

encommon/utils/stdout.py

@@ -178,11 +178,16 @@ def array_ansi(  # noqa: CFQ001, CFQ004
        This massive function should be refactored, possibly
        into a class with methods where there are functions.
 
+    Example
+    -------
+    >>> array_ansi({'foo': 'bar'})
+    "\\x1b[0;97mfoo\\x1b[0;37m:\\x1b[0;0m...
+
     :param source: Value in supported and iterable formats.
     :param indent: How many levels for initial indentation.
     :param colors: Determine colors used with different types.
     :returns: ANSI colorized string using inline directives.
-    """
+    """  # noqa: D301 LIT102
 
     output: list[str] = []
 

encommon/version.txt

@@ -1 +1 @@
-0.7.1
+0.7.2

{encommon-0.7.1.dist-info → encommon-0.7.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: encommon
-Version: 0.7.1
+Version: 0.7.2
 Summary: Enasis Network Common Library
 License: MIT
 Classifier: Programming Language :: Python :: 3

{encommon-0.7.1.dist-info → encommon-0.7.2.dist-info}/RECORD

@@ -1,24 +1,24 @@
 encommon/__init__.py,sha256=VoXUcphq-gcXCraaU47EtXBftF6UVuQPMGr0fuCTt9A,525
 encommon/conftest.py,sha256=z5BMi6KjNuactDRgbh8J8w81V08Ptf6QK2o_bJANRs4,880
 encommon/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-encommon/version.txt,sha256=kCMRx7s4-hZY_0A972FY7nN4_p1uLihPocOHNcMb0ws,6
+encommon/version.txt,sha256=0BdnGL0hTOhHTAbtYcOVyhE_38Ks3YbZqpkztA2bVh4,6
 encommon/config/__init__.py,sha256=2ic7tK2lOQvqWmmQnMozqxCJcbyQ_sSEHmOUDUFan2U,710
 encommon/config/common.py,sha256=gaKBgkF7b7UIAhd0ESio0KpG8JfdRpz5BxNgKRptd6A,2041
 encommon/config/config.py,sha256=-wIkyA6YQGAly0WuXLaOYXENjZYRYgWk_VdUN8mMe8Q,4853
 encommon/config/files.py,sha256=2DHz7GKOjF8FC26tY0V-E9svNMrlkSUshb2gfxqGgSo,2313
 encommon/config/logger.py,sha256=jtxqmpFLDFEfWyfpgiOmHEavEfuWUOdehAk32ce8slA,13662
-encommon/config/params.py,sha256=IWQ-UzR8x6VxkcUddC3qhI612IFMfLW44jEjRePXK0c,1825
+encommon/config/params.py,sha256=414LgESo-Q6htZmXrVPvkjM2y7b-hT88z0uZ-jFbAuQ,1810
 encommon/config/paths.py,sha256=0EpXWn6G9IO6tuZTrWuDq53RI5xMTgDQrAlOjRLILHs,2433
-encommon/config/test/__init__.py,sha256=PjrnBYT0efyvbaGeNx94dm3tP3EVHUHSVs-VGeLEv5g,218
+encommon/config/test/__init__.py,sha256=i0JAeRcM-0YH2StGfwpaDbZV9dVribNSgFDcYcPPay8,313
 encommon/config/test/test_common.py,sha256=U6XWfCLxtLmArn8P6h4cmCALzdXxV7IMUxKNU-UhwPw,731
-encommon/config/test/test_config.py,sha256=SMe8ZrHRVS7jcyoFB-jBmlYTdUkBT1RrjZ9QlAW1EtE,3292
-encommon/config/test/test_files.py,sha256=OlGziUPV35yrdn2Ac8tuqmFfjHciWJADdQRvacoJNUc,2298
+encommon/config/test/test_config.py,sha256=o-FYIDgLWLlKjCRSMzRWOihqXAzmwsycq3yFZlwzYeU,3247
+encommon/config/test/test_files.py,sha256=qO9B3-36H4einZrtHqRx4-ssIqwP7XSsre0PHM4mD2g,2253
 encommon/config/test/test_logger.py,sha256=6SO_iCTGDHZYnITVEyN4Q15bho2TYVxmNxDr-t3-_Ak,4740
-encommon/config/test/test_paths.py,sha256=vNWYqiN_wNuFCu1HHEekoJdGGJyRlucDBZTAspwxWhc,2107
+encommon/config/test/test_paths.py,sha256=PWshb90ckowQDZPsQRQHGHni_r0yqdjf7yd2FKxqLcQ,2062
 encommon/crypts/__init__.py,sha256=7tNT1KqdYaVTLMKJazQGBULe8RpxD4MJoJi8nGMZixw,318
 encommon/crypts/crypts.py,sha256=Av6kb9xSvj8mVMxZW8J_PuzBWV24Rw-fOFR9OKW-oH4,3158
 encommon/crypts/hashes.py,sha256=p_o8IIznBBHtYJYvI1YPEsmDS_BsE-ufNE99QQog8pk,3145
-encommon/crypts/params.py,sha256=GLaU6gnxmSPnbpxYqrnWqfVlX8bl4pCbIAzoHMPYc48,471
+encommon/crypts/params.py,sha256=7hh7a7VtsQNqcZHeSkQI_V4JLfoe0D-JyqrIvtoq86c,590
 encommon/crypts/test/__init__.py,sha256=PjrnBYT0efyvbaGeNx94dm3tP3EVHUHSVs-VGeLEv5g,218
 encommon/crypts/test/test_crypts.py,sha256=QDhIUVzn-n5z9tk1ZPXbZ4pBx0CRtcfqIyESYVB0kbU,2433
 encommon/crypts/test/test_hashes.py,sha256=Spixpx2qBi6iSJ8aNgmnNtz04JofUpwU-a_UjpRoiHA,1206
@@ -27,14 +27,14 @@ encommon/times/common.py,sha256=xLB_GLahYKT-YrVq90RUzmiodJQ4__1YihgZZTnadgg,2506
 encommon/times/duration.py,sha256=8p-L9OItO80nnd35FYrAXbiUS8RJzavI21lXBrtLaH0,9872
 encommon/times/parse.py,sha256=ZzranxftlB6bZJ1ivkoUxD53TUfXDDUdpq9jsSJN-88,6411
 encommon/times/timers.py,sha256=yOVr6deGE5iatNWUwNQCzaXjMlLeYlolx4MmKT0MSHc,6312
-encommon/times/times.py,sha256=Dfu6ztUsV4X4vHzOC7ds8jtYy0AVj4_R5xB6H-yzemE,9432
+encommon/times/times.py,sha256=xD2sRIAhjWgNE4xNE04nKfi00_eW3snZtMMhQU6ovIc,9694
 encommon/times/window.py,sha256=Fx_OJfU9B0IctCyaJ5XH_HxzhGlzeRATwuhI-HlsTPA,8023
 encommon/times/test/__init__.py,sha256=PjrnBYT0efyvbaGeNx94dm3tP3EVHUHSVs-VGeLEv5g,218
 encommon/times/test/test_common.py,sha256=nizxgB1scLDEm2o66waK1Ar_Dl5BBMTC-GRV7iDk0_U,1477
 encommon/times/test/test_duration.py,sha256=rmAhW2otHzQDHF0mBSETHnnL2OSbeAFYEHpDlaUSRnI,3901
 encommon/times/test/test_parse.py,sha256=TuZG_UbIEez4Ww35vdKIie_yaKp-PiUhsNmr1ZUoGvo,4308
 encommon/times/test/test_timers.py,sha256=z-ONyKtkAZ1A7w8qgpgx07r-Vsl5jY-pe2oneSF7hyo,2314
-encommon/times/test/test_times.py,sha256=DJBmRHCPkMLL9-bmc2DMhhf8zcr2rsTVAAQPavD_UmE,1986
+encommon/times/test/test_times.py,sha256=aI3bsTPuZqVCNgKH45lGR7TVMD4nxzZlQJ5X8_3VO0Y,2023
 encommon/times/test/test_window.py,sha256=EWjXR8XREYwKrH-221CBAUwLF9GpvHtuF_CSMdQtUXI,4735
 encommon/types/__init__.py,sha256=l2WKtDs6uC9I3dIGnrzJvz-4JLEETUJOfT509XyMQWs,420
 encommon/types/dicts.py,sha256=zJbfAsL1uiqfouBQrQgcYGoLowtkUd-Vm9536_DVK_E,2208
@@ -49,14 +49,14 @@ encommon/utils/common.py,sha256=UrowELh3PtDzpSS48nGhsAxTS_QUk96-KEJa4MlxiMA,466
 encommon/utils/match.py,sha256=4L2d2Cvr7vp3odkRCdNQ10OIW8DkEP55_NbQ6bdsReo,2462
 encommon/utils/paths.py,sha256=4EeaPsVwpv3pzoHeWmiSSGYZEud6hkD27kvbvgSpOPs,3236
 encommon/utils/sample.py,sha256=hOhS6A2aB9a5kXfrst7gUSQkxuqEo2J1AFyBsJZQhHE,3169
-encommon/utils/stdout.py,sha256=coGmpw9Wljxy-m3jI6AAUwhuGJPnxJXykz3uVWlwak0,7234
+encommon/utils/stdout.py,sha256=rmesIjpmzpMdV660qZWzVqToPCs4IZNpvPHaTi6i73Y,7360
 encommon/utils/test/__init__.py,sha256=PjrnBYT0efyvbaGeNx94dm3tP3EVHUHSVs-VGeLEv5g,218
 encommon/utils/test/test_match.py,sha256=QagKpTFdRo23-Y55fSaJrSMpt5jIebScKbz0h8tivrI,1124
 encommon/utils/test/test_paths.py,sha256=0ls9gWJ2B487Dr1fHDDFCZPA7gxtv56nFEYHrTkNX-U,1892
 encommon/utils/test/test_sample.py,sha256=iNV9IxXmA5KJat3jKRiZH3iutHrT6bsibwti60AhICk,1464
 encommon/utils/test/test_stdout.py,sha256=TA7xQuFoPZUYW2l00e04MGp4P9gHkkVxVflvPlhpQXg,4878
-encommon-0.7.1.dist-info/LICENSE,sha256=otnXKCtMjPlbHs0wgZ_BWULrp3g_2dWQJ6icRk9nkgg,1071
-encommon-0.7.1.dist-info/METADATA,sha256=NW58CHjQymcfLpmbdHWOMJVbIbxX2T_5wD4qDPs9Ctk,2671
-encommon-0.7.1.dist-info/WHEEL,sha256=GJ7t_kWBFywbagK5eo9IoUwLW6oyOeTKmQ-9iHFVNxQ,92
-encommon-0.7.1.dist-info/top_level.txt,sha256=bP8q7-5tLDNm-3XPlqn_bDENfYNug5801H_xfz3BEAM,9
-encommon-0.7.1.dist-info/RECORD,,
+encommon-0.7.2.dist-info/LICENSE,sha256=otnXKCtMjPlbHs0wgZ_BWULrp3g_2dWQJ6icRk9nkgg,1071
+encommon-0.7.2.dist-info/METADATA,sha256=PJD8NnrD4Q7aOjXUME3gtyyJPXS6H3ZOYNRPpJjKOHc,2671
+encommon-0.7.2.dist-info/WHEEL,sha256=GJ7t_kWBFywbagK5eo9IoUwLW6oyOeTKmQ-9iHFVNxQ,92
+encommon-0.7.2.dist-info/top_level.txt,sha256=bP8q7-5tLDNm-3XPlqn_bDENfYNug5801H_xfz3BEAM,9
+encommon-0.7.2.dist-info/RECORD,,