ka-uts-com 3.0.2.250508__py3-none-any.whl → 4.0.0.250510__py3-none-any.whl

ka_uts_com/__version__.py

@@ -1,7 +1,7 @@
 __title__ = 'ka_uts_com'
 __description__ = 'Communication Utilities.'
 __url__ = 'https://ka-ut-com.readthedocs.io/en/latest'
-__version__ = '3.0.2.250508'
+__version__ = '4.0.0.250510'
 __build__ = 0x022200
 __author__ = 'Bernd Stroehle'
 __author_email__ = 'bernd.stroehle@gmail.com'

ka_uts_com/com.py

@@ -40,9 +40,9 @@ class Com:
     d_app_pacmod: TyDic = {}
 
     ts: TnTimeStamp
-    ts_start: TnDateTime = None
-    ts_end: TnDateTime = None
-    ts_etime: TnDateTime = None
+    # ts_start: TnDateTime = None
+    # ts_end: TnDateTime = None
+    # ts_etime: TnDateTime = None
     d_timer: TyDic = {}
 
     Cfg: TnDic = None

ka_uts_com/decorators/dec.py

@@ -2,12 +2,25 @@
 Decorators
 """
 # coding=utf-8
-from ka_uts_com.timer import Timer
+# from ka_uts_com.timer import Timer
+import numpy as np
+from datetime import datetime
+from ka_uts_uts.utils.fnc import Fnc
+from ka_uts_log.log import Log
 
 
 def timer(fnc):
     def wrapper(*args, **kwargs):
-        Timer.start(fnc)
+        # Timer.start(fnc, *args, **kwargs)
+        start = datetime.now()
         fnc(*args, **kwargs)
-        Timer.end(fnc)
+        _fnc_name = Fnc.sh_fnc_name(fnc)
+        end = datetime.now()
+        # elapse_time = (end - start).total_seconds()
+        elapse_time = end.timestamp() - start.timestamp()
+        # np_elapse_time = np.format_float_positional(elapse_time, trim='-')
+        np_elapse_time = np.format_float_positional(elapse_time, trim='k')
+        msg = f"{_fnc_name} elapse time [sec] = {np_elapse_time}"
+        Log.info(msg, stacklevel=2)
+        # Timer.end(fnc, *args, **kwargs)
     return wrapper

ka_uts_com/timer.py

@@ -3,6 +3,7 @@ from datetime import datetime
 
 from ka_uts_com.com import Com
 from ka_uts_log.log import Log
+from ka_uts_uts.utils.fnc import Fnc
 
 from typing import Any
 TyAny = Any
@@ -26,42 +27,58 @@ class Timer:
     """ Timer Management
     """
     @staticmethod
-    def sh_task_id(d_pacmod: TyDic, class_id: TyAny, parms: TnAny, sep: TyStr) -> TyStr:
+    def sh_args_str(*args) -> TyStr:
+        """
+        Show class name, the item class_name is the class_id if its a string,
+        otherwise the attribute __qualname__ is used.
+        """
+        if not args:
+            return ""
+        else:
+            return f"{args}"
+
+    @staticmethod
+    def sh_kwargs_str(**kwargs) -> TyStr:
+        """
+        Show class name, the item class_name is the class_id if its a string,
+        otherwise the attribute __qualname__ is used.
+        """
+        if not kwargs:
+            return ""
+        else:
+            return f"{kwargs}"
+
+    @classmethod
+    def sh_task_id(cls, fnc, *args, **kwargs) -> TyStr:
         """
         Show task id, which is created by the concationation of the following items:
         package, module, class_name and parms if they are defined; the items package
         and module are get from the package-module directory; the item class_name is
         the class_id if its a string, otherwise the attribute __qualname__ is used.
         """
-        package = d_pacmod.get('package')
-        module = d_pacmod.get('module')
-        if isinstance(class_id, str):
-            class_name = class_id
-        else:
-            class_name = class_id.__qualname__
-        if not parms:
-            parms = ""
-        else:
-            parms = f" {parms}"
-        arr: TyArr = []
-        for item in [package, module, class_name, parms]:
-            if not item:
-                continue
-            arr.append(item)
-        return sep.join(arr)
+        _pac_name = Fnc.sh_pac_name(fnc)
+        _mod_name = Fnc.sh_mod_name(fnc)
+        _cls_name = Fnc.sh_cls_name(fnc)
+        _args = cls.sh_args_str(*args)
+        _kwargs = cls.sh_kwargs_str(**kwargs)
+        _sep = kwargs.get('sep', '.')
+        task_id: TyStr = _sep.join([_pac_name, _mod_name, _cls_name, _args, _kwargs])
+        return task_id
 
     @classmethod
-    def start(cls, class_id: TyAny, parms: TnAny = None, sep: TyStr = ".") -> None:
-        """ Start Timer
+    def start(cls, fnc: TyAny, *args, **kwargs) -> None:
+        """
+        Start Timer
         """
-        task_id = cls.sh_task_id(Com.d_app_pacmod, class_id, parms, sep)
+        task_id = cls.sh_task_id(fnc, *args, **kwargs)
         Com.d_timer[task_id] = datetime.now()
 
     @classmethod
-    def end(cls, class_id: TyAny, parms: TnAny = None, sep: TyStr = ".") -> None:
-        """ End Timer
+    def end(cls, fnc: TyAny, *args, **kwargs) -> None:
+        """
+        End Timer
         """
-        task_id = cls.sh_task_id(Com.d_app_pacmod, class_id, parms, sep)
+        task_id = cls.sh_task_id(fnc, *args, **kwargs)
         start = Com.d_timer.get(task_id)
         end = datetime.now()
         elapse_time_sec = Timestamp.sh_elapse_time_sec(end, start)

ka_uts_com-4.0.0.250510.dist-info/METADATA

@@ -0,0 +1,880 @@
+Metadata-Version: 2.4
+Name: ka_uts_com
+Version: 4.0.0.250510
+Summary: Utilities for Communication and CLI Processing
+Author-email: Bernd Stroehle <bernd.stroehle@gmail.com>
+Maintainer-email: Bernd Stroehle <bernd.stroehle@gmail.com>
+Project-URL: Source Code, https://github.com/bs29/ka_uts_com/tree/master
+Project-URL: Homepage, https://kosakya.de/
+Project-URL: Documentation, https://ka-com.readthedocs.io/en/latest
+Project-URL: Apache-2.0 License, https://apache.org/licenses/LICENSE-2.0
+Project-URL: GPLv3 License, https://www.gnu.org/licenses/gpl-3.0.en.html
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Natural Language :: English
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.10
+Description-Content-Type: text/x-rst
+License-File: LICENSE.txt
+Requires-Dist: ka_uts_arr>=4.0.0.250510
+Requires-Dist: ka_uts_log>=4.0.0.250510
+Requires-Dist: ka_uts_uts>=4.0.0.250510
+Requires-Dist: numpy>=2.2.5
+Dynamic: license-file
+
+##########
+ka_uts_com
+##########
+
+Overview
+********
+
+.. start short_desc
+
+**Utilities for Communication and CLI Processing**
+
+.. end short_desc
+
+Installation
+************
+
+.. start installation
+
+The package ``ka_uts_com`` can be installed from PyPI or Anaconda.
+
+To install with ``pip``:
+
+.. code-block:: shell
+
+	$ python -m pip install ka_uts_com
+
+To install with ``conda``:
+
+.. code-block:: shell
+
+	$ conda install -c conda-forge ka_uts_com
+
+.. end installation
+
+Package logging 
+***************
+
+(c.f.: **Appendix**: `Package Logging`)
+
+Package files
+*************
+
+Classification
+==============
+
+The Package ``ka_uts_com`` consist of the following file types (c.f.: **Appendix**):
+
+#. **Special files:** (c.f.: **Appendix:** *Special python package files*)
+
+#. **Dunder modules:** (c.f.: **Appendix:** *Special python package modules*)
+
+#. **Decorator modules**
+
+   a. *dec.py*
+
+#. **Modules**
+
+   #. **Communication Modules**
+
+      a. *com.py*
+      #. *timer.py*
+
+   #. **Base Modules**
+
+      a. *app.py*
+      #. *cfg.py*
+      #. *exit.py*
+
+Decorator Modules
+*****************
+
+Overview
+========
+
+  .. Decorator Modules-label:
+  .. table:: *Decorator Modules*
+
+   +------+-----------------+
+   |Name  |Decription       |
+   +======+=================+
+   |dec.py|Decorators module|
+   +------+-----------------+
+
+Communication Modules
+*********************
+
+Overview
+========
+
+  .. Communication Modules-label:
+  .. table:: *Communication Modules*
+
+   +--------+-----------------------------+
+   |Name    |Decription                   |
+   +========+=============================+
+   |com.py  |Communication handling module|
+   +--------+-----------------------------+
+   |timer.py|Timer management module      |
+   +--------+-----------------------------+
+
+Communication module: com.py
+============================
+
+The Communication Module ``com.py`` contains the single static class ``Com``.
+
+com.py Class: Com
+-----------------
+
+The static Class ``Com`` contains the subsequent variables and methods.
+
+Com: Variables
+^^^^^^^^^^^^^^
+
+  .. Com-Variables-label:
+  .. table:: *Com: Variables*
+
+   +------------+-----------+-------+---------------------------------------+
+   |Name        |Type       |Default|Description                            |
+   +============+===========+=======+=======================================+
+   |sw_init     |TyBool     |None   |Initialisation switch                  |
+   +------------+-----------+-------+---------------------------------------+
+   |d_com_pacmod|TyDic      |{}     |Communication package module dictionary|
+   +------------+-----------+-------+---------------------------------------+
+   |d_app_pacmod|TyDic      |{}     |Application package module dictionary  |
+   +------------+-----------+-------+---------------------------------------+
+   |**Timestamp fields**                                                    |
+   +------------+-----------+-------+---------------------------------------+
+   |ts          |TnTimeStamp|None   |Timestamp                              |
+   +------------+-----------+-------+---------------------------------------+
+   |ts_start    |TnDateTime |None   |start timestamp in date time format    |
+   +------------+-----------+-------+---------------------------------------+
+   |ts_end      |TnDateTime |None   |end timestamp in date time format      |
+   +------------+-----------+-------+---------------------------------------+
+   |ts_etime    |TnDateTime |None   |elapse Time                            |
+   +------------+-----------+-------+---------------------------------------+
+   |d_timer     |TyDic      |False  |Timer dictionary                       |
+   +------------+-----------+-------+---------------------------------------+
+   |**Links to other Classes**                                              |
+   +------------+-----------+-------+---------------------------------------+
+   |App         |TyAny      |False  |Application class                      |
+   +------------+-----------+-------+---------------------------------------+
+   |cfg         |TyDic      |None   |Configuration dictionary               |
+   +------------+-----------+-------+---------------------------------------+
+   |Log         |TyLogger   |False  |Log class                              |
+   +------------+-----------+-------+---------------------------------------+
+   |Exit        |TyAny      |False  |Exit class                             |
+   +------------+-----------+-------+---------------------------------------+
+
+Com: Methods
+^^^^^^^^^^^^
+
+  .. Com-Methods-label:
+  .. table:: *Com Methods*
+
+   +---------+-------------------------------------------------------+
+   |Name     |Description                                            |
+   +=========+=======================================================+
+   |init     |Initialise static variables if they are not initialized|
+   +---------+-------------------------------------------------------+
+   |sh_kwargs|Show keyword arguments                                 |
+   +---------+-------------------------------------------------------+
+
+Com Method: init
+^^^^^^^^^^^^^^^^
+        
+Parameter
+"""""""""
+
+  ..Com-Method-init-Parameter-label:
+  .. table:: *Com Method init: Parameter*
+
+   +---------+-----+-----------------+
+   |Name     |Type |Description      |
+   +=========+=====+=================+
+   |cls      |class|current class    |
+   +---------+-----+-----------------+
+   |\**kwargs|TyAny|keyword arguments|
+   +---------+-----+-----------------+
+
+Com Method: sh_kwargs
+^^^^^^^^^^^^^^^^^^^^^
+        
+Parameter
+"""""""""
+
+  .. Com-Method-sh_kwargs-Parameter-label:
+  .. table:: *Com Method sh_kwargs: Parameter*
+
+   +--------+-----+--------------------+
+   |Name    |Type |Description         |
+   +========+=====+====================+
+   |cls     |class|current class       |
+   +--------+-----+--------------------+
+   |root_cls|class|root lass           |
+   +--------+-----+--------------------+
+   |d_parms |TyDic|parameter dictionary|
+   +--------+-----+--------------------+
+   |\*args  |list |arguments array     |
+   +--------+-----+--------------------+
+
+Communication module: timer.py
+==============================
+
+timer.py: Classes
+-----------------
+
+The Module ``timer.py`` contains the following classes
+
+
+  .. timer.py-Classes-label:
+  .. table:: *timer.py classes*
+
+   +---------+------+---------------+
+   |Name     |Type  |Description    |
+   +=========+======+===============+
+   |Timestamp|static|Timestamp class|
+   +---------+------+---------------+
+   |Timer    |static|Timer class    |
+   +---------+------+---------------+
+
+timer.py Class: Timer
+---------------------
+
+Timer: Methods
+^^^^^^^^^^^^^^
+
+  .. Timer-Methods-label:
+  .. table:: *Timer Methods*
+
+   +----------+------------------------------------+
+   |Name      |Description                         |
+   +==========+====================================+
+   |sh_task_id|Show task id                        |
+   +----------+------------------------------------+
+   |start     |Start Timer                         |
+   +----------+------------------------------------+
+   |end       |End Timer and Log Timer info message|
+   +----------+------------------------------------+
+
+Timer Method: sh_task_id
+^^^^^^^^^^^^^^^^^^^^^^^^
+        
+Show task id, which is created by the concatination of the following items if they are defined:
+#. package,
+#. module,
+#. class_name,
+#. parms
+The items package and module are get from the package-module directory;
+The item class_name is the class_id if its a string, otherwise the attribute
+__qualname__ is used.
+        
+Parameter
+"""""""""
+
+  .. Parameter-of-Timer-Method-sh_task_id-label:
+  .. table:: *Parameter of: Timer Method sh_task_id*
+
+   +--------+-----+-----------------+
+   |Name    |Type |Description      |
+   +========+=====+=================+
+   |d_pacmod|TyDic|pacmod dictionary|
+   +--------+-----+-----------------+
+   |class_id|TyAny|Class Id         |
+   +--------+-----+-----------------+
+   |parms   |TnAny|Parameters       |
+   +--------+-----+-----------------+
+   |sep     |TyStr|Separator        |
+   +--------+-----+-----------------+
+
+Return Value
+""""""""""""
+
+  .. Timer-Method-sh_task_id-Return-Value-label:
+  .. table:: *Timer Method sh_task_id: Return Value*
+
+   +----+-----+-----------+
+   |Name|Type |Description|
+   +====+=====+===========+
+   |    |TyStr|Task Id    |
+   +----+-----+-----------+
+
+Timer Method: start
+^^^^^^^^^^^^^^^^^^^
+        
+Parameter
+"""""""""
+
+  .. Parameter-of-Timer-Method-start-Parameter-label:
+  .. table:: *Timer Method start: Parameter*
+
+   +--------+-----+-------------+
+   |Name    |Type |Description  |
+   +========+=====+=============+
+   |cls     |class|current class|
+   +--------+-----+-------------+
+   |class_id|TyAny|Class Id     |
+   +--------+-----+-------------+
+   |parms   |TnAny|Parameter    |
+   +--------+-----+-------------+
+   |sep     |TyStr|Separator    |
+   +--------+-----+-------------+
+
+Timer Method: end
+^^^^^^^^^^^^^^^^^
+        
+Parameter
+"""""""""
+
+  .. Parameter-of-Timer-Method-end-label:
+  .. table:: *Parameter of: Timer Method end*
+
+   +--------+-----+-------------+
+   |Name    |Type |Description  |
+   +========+=====+=============+
+   |cls     |class|current class|
+   +--------+-----+-------------+
+   |class_id|TyAny|Class Id     |
+   +--------+-----+-------------+
+   |parms   |TnAny|Parameter    |
+   +--------+-----+-------------+
+   |sep     |TyStr|Separator    |
+   +--------+-----+-------------+
+
+Base Modules
+************
+
+Overview
+========
+
+  .. Base Modules-label:
+  .. table:: *Base Modules*
+
+   +---------+----------------------------+
+   |Name     |Decription                  |
+   +=========+============================+
+   |app\_.py |Application setup module    |
+   +---------+----------------------------+
+   |cfg\_.py |Configuration setup module  |
+   +---------+----------------------------+
+   |exit\_.py|Exit Manafement setup module|
+   +---------+----------------------------+
+
+Base module: app\_.py
+=====================
+
+The Module ``app.py`` contains a single static class ``App_``.
+
+Class: App\_
+------------
+
+The static class ``App_`` contains the subsequent static variables and methods
+
+App\_: Static Variables
+^^^^^^^^^^^^^^^^^^^^^^^
+
+  .. Appl\_ Static-Variables-label:
+  .. table:: *Appl\_ tatic Variables*
+
+   +---------------+-------+-------+---------------------+
+   |Name           |Type   |Default|Description          |
+   +===============+=======+=======+=====================+
+   |sw_init        |TyBool |False  |initialisation switch|
+   +---------------+-------+-------+---------------------+
+   |httpmod        |TyDic  |None   |http modus           |
+   +---------------+-------+-------+---------------------+
+   |sw_replace_keys|TnBool |False  |replace keys switch  |
+   +---------------+-------+-------+---------------------+
+   |keys           |TnArr  |None   |Keys array           |
+   +---------------+-------+-------+---------------------+
+   |reqs           |TyDic  |None   |Requests dictionary  |
+   +---------------+-------+-------+---------------------+
+   |app            |TyDic  |None   |Appliction dictionary|
+   +---------------+-------+-------+---------------------+
+
+App\_: Methods
+^^^^^^^^^^^^^^
+
+  .. App\_-Methods-label:
+  .. table:: *App\_ Methods*
+
+   +----+------+------------------------------------+
+   |Name|Type  |Description                         |
+   +====+======+====================================+
+   |init|class |initialise static variables of class|
+   |    |      |if they are not allready initialized|
+   +----+------+------------------------------------+
+   |sh  |class |show (return) class                 |
+   +----+------+------------------------------------+
+
+App\_ Method: init
+^^^^^^^^^^^^^^^^^^
+        
+Parameter
+"""""""""
+
+  .. Parameter-of-App\_-Method-init-label:
+  .. table:: *Parameter of: App\_ Method init*
+
+   +---------+-----+-----------------+
+   |Name     |Type |Description      |
+   +=========+=====+=================+
+   |cls      |class|Current class    |
+   +---------+-----+-----------------+
+   |\**kwargs|TyAny|Keyword arguments|
+   +---------+-----+-----------------+
+
+App\_ Method: sh
+^^^^^^^^^^^^^^^^
+        
+  .. App\_-Method-sh-label:
+  .. table:: *App\_ Method: sh*
+
+   +---------+-----+-----------------+
+   |Name     |Type |Description      |
+   +=========+=====+=================+
+   |cls      |class|Current class    |
+   +---------+-----+-----------------+
+   |\**kwargs|TyAny|Keyword arguments|
+   +---------+-----+-----------------+
+
+Return Value
+""""""""""""
+
+  .. App\_-Method-sh-Return-Value-label:
+  .. table:: *App\_ Method sh: Return Value*
+
+   +----+--------+-----------+
+   |Name|Type    |Description|
+   +====+========+===========+
+   |log |TyLogger|Logger     |
+   +----+--------+-----------+
+
+Base module: cfg\_.py
+=====================
+
+The Base module cfg\_.py contains a single static class ``Cfg_``.
+
+cfg\_.py Class Cfg\_
+---------------------
+
+The static class ``Cfg_`` contains the subsequent static variables and methods
+
+Cfg\_Static Variables
+^^^^^^^^^^^^^^^^^^^^^
+
+  .. Cfg\_-Static-Variables-label:
+  .. table:: *Cfg\_ Static Variables*
+
+   +----+-----+-------+--------------------+
+   |Name|Type |Default|Description         |
+   +====+=====+=======+====================+
+   |cfg |TyDic|None   |Configuration object|
+   +----+-----+-------+--------------------+
+
+Cfg\_ Methods
+^^^^^^^^^^^^^
+
+  .. Cfg\_-Methods-label:
+  .. table:: *Cfg\_ Methods*
+
+   +----+------+-----------------------------------+
+   |Name|Type  |Description                        |
+   +====+======+===================================+
+   |sh  |class |read pacmod yaml file into class   |
+   |    |      |variable cls.dic and return cls.cfg|
+   +----+------+-----------------------------------+
+
+Cfg\_ Method: sh
+^^^^^^^^^^^^^^^^
+        
+Parameter
+"""""""""
+
+  .. Cfg\_-Method-sh-Parameter-label:
+  .. table:: *Cfg\_ Method sh: Parameter*
+
+   +--------+--------+-----------------+
+   |Name    |Type    |Description      |
+   +========+========+=================+
+   |cls     |class   |Current class    |
+   +--------+--------+-----------------+
+   |log     |TyLogger|Logger           |
+   +--------+--------+-----------------+
+   |d_pacmod|TyDic   |pacmod dictionary|
+   +--------+--------+-----------------+
+
+Return Value
+""""""""""""
+
+  .. Cfg\_-Method-sh-Return-Value-label:
+  .. table:: *Cfg\_ Method sh: Return Value*
+
+   +-------+-----+-----------+
+   |Name   |Type |Description|
+   +=======+=====+===========+
+   |cls.cfg|TyDic|           |
+   +-------+-----+-----------+
+
+Base Modul: exit\_.py
+=====================
+
+The Base module exit\_.py contains a single static class ``Ext_``.
+
+exit\_.py class: Exit\_
+-----------------------
+
+The static Class ``Exit_`` of Module exit\_.py contains the subsequent static variables and methods.
+
+Exit\_: Variables
+^^^^^^^^^^^^^^^^^
+
+  .. Exit\_-Variables-label:
+  .. table:: *Exit\_ Variables*
+
+   +--------------+------+-------+---------------------+
+   |Name          |Type  |Default|Description          |
+   +==============+======+=======+=====================+
+   |sw_init       |TyBool|False  |initialisation switch|
+   +--------------+------+-------+---------------------+
+   |sw_critical   |TyBool|False  |critical switch      |
+   +--------------+------+-------+---------------------+
+   |sw_stop       |TyBool|False  |stop switch          |
+   +--------------+------+-------+---------------------+
+   |sw_interactive|TyBool|False  |interactive switch   |
+   +--------------+------+-------+---------------------+
+
+Exit\_: Methods
+^^^^^^^^^^^^^^^
+
+  .. Exit\_-Methods-label:
+  .. table:: *Exit\_ Methods*
+
+   +----+------+------------------------------------+
+   |Name|Method|Description                         |
+   +====+======+====================================+
+   |init|class |initialise static variables of class|
+   |    |      |if they are not allready initialized|
+   +----+------+------------------------------------+
+   |sh  |class |show (return) class                 |
+   +----+------+------------------------------------+
+
+Exit\_: Method: init
+^^^^^^^^^^^^^^^^^^^^
+        
+Parameter
+"""""""""
+
+  .. Exit\_-Method-init-Parameter:
+  .. table:: *Exit\_ Method init: Parameter*
+
+   +---------+-----+-----------------+
+   |Name     |Type |Description      |
+   +=========+=====+=================+
+   |cls      |class|Current class    |
+   +---------+-----+-----------------+
+   |\**kwargs|TyAny|Keyword arguments|
+   +---------+-----+-----------------+
+
+Exit\_: Method: sh
+^^^^^^^^^^^^^^^^^^
+        
+Parameter
+"""""""""
+
+  .. Exit\_-Method-sh-Parameter:
+  .. table:: *Exit\_ Method sh: Parameter*
+
+   +---------+-----+-----------------+
+   |Name     |Type |Description      |
+   +=========+=====+=================+
+   |cls      |class|Current class    |
+   +---------+-----+-----------------+
+   |\**kwargs|TyAny|Keyword arguments|
+   +---------+-----+-----------------+
+
+Return Value
+""""""""""""
+
+  .. Exit\_-Method-sh-Return-Value:
+  .. table:: *Exit\_ Method sh: Return Value*
+
+   +----+-----+-------------+
+   |Name|Type |Description  |
+   +====+=====+=============+
+   |cls |class|Current class|
+   +----+-----+-------------+
+
+Appendix
+********
+
+Package Logging
+===============
+
+Description
+-----------
+
+The Standard or user specifig logging is carried out by the log.py module of the logging
+package ka_uts_log using the configuration files **ka_std_log.yml** or **ka_usr_log.yml**
+in the configuration directory **cfg** of the logging package **ka_uts_log**.
+The Logging configuration of the logging package could be overriden by yaml files with
+the same names in the configuration directory **cfg** of the application packages.
+
+Log message types
+-----------------
+
+Logging defines log file path names for the following log message types: .
+
+#. *debug*
+#. *info*
+#. *warning*
+#. *error*
+#. *critical*
+
+Application parameter for logging
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+  .. Application-parameter-used-in-log-naming-label:
+  .. table:: *Application parameter used in log naming*
+
+   +-----------------+---------------------------+----------+------------+
+   |Name             |Decription                 |Values    |Example     |
+   +=================+===========================+==========+============+
+   |dir_dat          |Application data directory |          |/otev/data  |
+   +-----------------+---------------------------+----------+------------+
+   |tenant           |Application tenant name    |          |UMH         |
+   +-----------------+---------------------------+----------+------------+
+   |package          |Application package name   |          |otev_xls_srr|
+   +-----------------+---------------------------+----------+------------+
+   |cmd              |Application command        |          |evupreg     |
+   +-----------------+---------------------------+----------+------------+
+   |pid              |Process ID                 |          |æevupreg    |
+   +-----------------+---------------------------+----------+------------+
+   |log_ts_type      |Timestamp type used in     |ts,       |ts          |
+   |                 |logging files|ts, dt       |dt        |            |
+   +-----------------+---------------------------+----------+------------+
+   |log_sw_single_dir|Enable single log directory|True,     |True        |
+   |                 |or multiple log directories|False     |            |
+   +-----------------+---------------------------+----------+------------+
+
+Log type and Log directories
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Single or multiple Application log directories can be used for each message type:
+
+  .. Log-types-and-Log-directories-label:
+  .. table:: *Log types and directoriesg*
+
+   +--------------+---------------+
+   |Log type      |Log directory  |
+   +--------+-----+--------+------+
+   |long    |short|multiple|single|
+   +========+=====+========+======+
+   |debug   |dbqs |dbqs    |logs  |
+   +--------+-----+--------+------+
+   |info    |infs |infs    |logs  |
+   +--------+-----+--------+------+
+   |warning |wrns |wrns    |logs  |
+   +--------+-----+--------+------+
+   |error   |errs |errs    |logs  |
+   +--------+-----+--------+------+
+   |critical|crts |crts    |logs  |
+   +--------+-----+--------+------+
+
+Log files naming
+^^^^^^^^^^^^^^^^
+
+Naming Conventions
+""""""""""""""""""
+
+  .. Naming-conventions-for-logging-file-paths-label:
+  .. table:: *Naming conventions for logging file paths*
+
+   +--------+-------------------------------------------------------+-------------------------+
+   |Type    |Directory                                              |File                     |
+   +========+=======================================================+=========================+
+   |debug   |/<dir_dat>/<tenant>/RUN/<package>/<cmd>/<Log directory>|<Log type>_<ts>_<pid>.log|
+   +--------+-------------------------------------------------------+-------------------------+
+   |info    |/<dir_dat>/<tenant>/RUN/<package>/<cmd>/<Log directory>|<Log type>_<ts>_<pid>.log|
+   +--------+-------------------------------------------------------+-------------------------+
+   |warning |/<dir_dat>/<tenant>/RUN/<package>/<cmd>/<Log directory>|<Log type>_<ts>_<pid>.log|
+   +--------+-------------------------------------------------------+-------------------------+
+   |error   |/<dir_dat>/<tenant>/RUN/<package>/<cmd>/<Log directory>|<Log type>_<ts>_<pid>.log|
+   +--------+-------------------------------------------------------+-------------------------+
+   |critical|/<dir_dat>/<tenant>/RUN/<package>/<cmd>/<Log directory>|<Log type>_<ts>_<pid>.log|
+   +--------+-------------------------------------------------------+-------------------------+
+
+Naming Examples
+"""""""""""""""
+
+  .. Naming-examples-for-logging-file-paths-label:
+  .. table:: *Naming examples for logging file paths*
+
+   +--------+--------------------------------------------+------------------------+
+   |Type    |Directory                                   |File                    |
+   +========+============================================+========================+
+   |debug   |/data/otev/umh/RUN/otev_xls_srr/evupreg/logs|debs_1737118199_9470.log|
+   +--------+--------------------------------------------+------------------------+
+   |info    |/data/otev/umh/RUN/otev_xls_srr/evupreg/logs|infs_1737118199_9470.log|
+   +--------+--------------------------------------------+------------------------+
+   |warning |/data/otev/umh/RUN/otev_xls_srr/evupreg/logs|wrns_1737118199_9470.log|
+   +--------+--------------------------------------------+------------------------+
+   |error   |/data/otev/umh/RUN/otev_xls_srr/evupreg/logs|errs_1737118199_9470.log|
+   +--------+--------------------------------------------+------------------------+
+   |critical|/data/otev/umh/RUN/otev_xls_srr/evupreg/logs|crts_1737118199_9470.log|
+   +--------+--------------------------------------------+------------------------+
+
+Python Terminology
+==================
+
+Python packages
+---------------
+
+  .. Python packages-label:
+  .. table:: *Python packages*
+
+   +-----------+-----------------------------------------------------------------+
+   |Name       |Definition                                                       |
+   +===========+==========+======================================================+
+   |Python     |Python packages are directories that contains the special module |
+   |package    |``__init__.py`` and other modules, packages files or directories.|
+   +-----------+-----------------------------------------------------------------+
+   |Python     |Python sub-packages are python packages which are contained in   |
+   |sub-package|another pyhon package.                                           |
+   +-----------+-----------------------------------------------------------------+
+
+Python package Sub-directories
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+  .. Python package-Sub-directories-label:
+  .. table:: *Python packages Sub-directories*
+
+   +----------------------+-------------------------------+
+   |Name                  |Definition                     |
+   +======================+==========+====================+
+   |Python package        |Sub-directories are directories|
+   |sub-directory         |contained in python packages.  |
+   +----------------------+-------------------------------+
+   |Special Python package|Python package sub-directories |
+   |sub-directory         |with a special meaning.        |
+   +----------------------+-------------------------------+
+
+Special python package Sub-directories
+""""""""""""""""""""""""""""""""""""""
+
+  .. Special-python-package-Sub-directories-label:
+  .. table:: *Special python Sub-directories*
+
+   +-------+------------------------------------------+
+   |Name   |Description                               |
+   +=======+==========================================+
+   |bin    |Directory for package scripts.            |
+   +-------+------------------------------------------+
+   |cfg    |Directory for package configuration files.|
+   +-------+------------------------------------------+
+   |data   |Directory for package data files.         |
+   +-------+------------------------------------------+
+   |service|Directory for systemd service scripts.    |
+   +-------+------------------------------------------+
+
+Python package files
+^^^^^^^^^^^^^^^^^^^^
+
+  .. Python-package-files-label:
+  .. table:: *Python package files*
+
+   +--------------+---------------------------------------------------------+
+   |Name          |Definition                                               |
+   +==============+==========+==============================================+
+   |Python        |Files within a python package.                           |
+   |package files |                                                         |
+   +--------------+---------------------------------------------------------+
+   |Special python|Package files which are not modules and used as python   |
+   |package files |and used as python marker files like ``__init__.py``.    |
+   +--------------+---------------------------------------------------------+
+   |Python package|Files with suffix ``.py``; they could be empty or contain|
+   |module        |python code; other modules can be imported into a module.|
+   +--------------+---------------------------------------------------------+
+   |Special python|Modules like ``__init__.py`` or ``main.py`` with special |
+   |package module|names and functionality.                                 |
+   +--------------+---------------------------------------------------------+
+
+Special python package files
+""""""""""""""""""""""""""""
+
+  .. Special-python-package-files-label:
+  .. table:: *Special python package files*
+
+   +--------+--------+---------------------------------------------------------------+
+   |Name    |Type    |Description                                                    |
+   +========+========+===============================================================+
+   |py.typed|Type    |The ``py.typed`` file is a marker file used in Python packages |
+   |        |checking|to indicate that the package supports type checking. This is a |
+   |        |marker  |part of the PEP 561 standard, which provides a standardized way|
+   |        |file    |to package and distribute type information in Python.          |
+   +--------+--------+---------------------------------------------------------------+
+
+Special python package modules
+""""""""""""""""""""""""""""""
+
+  .. Special-Python-package-modules-label:
+  .. table:: *Special Python package modules*
+
+   +--------------+-----------+-----------------------------------------------------------------+
+   |Name          |Type       |Description                                                      |
+   +==============+===========+=================================================================+
+   |__init__.py   |Package    |The dunder (double underscore) module ``__init__.py`` is used to |
+   |              |directory  |execute initialisation code or mark the directory it contains as |
+   |              |marker     |a package. The Module enforces explicit imports and thus clear   |
+   |              |file       |namespace use and call them with the dot notation.               |
+   +--------------+-----------+-----------------------------------------------------------------+
+   |__main__.py   |entry point|The dunder module ``__main__.py`` serves as an entry point for   |
+   |              |for the    |the package. The module is executed when the package is called by|
+   |              |package    |the interpreter with the command **python -m <package name>**.   |
+   +--------------+-----------+-----------------------------------------------------------------+
+   |__version__.py|Version    |The dunder module ``__version__.py`` consist of assignment       |
+   |              |file       |statements used in Versioning.                                   |
+   +--------------+-----------+-----------------------------------------------------------------+
+
+Python elements
+---------------
+
+  .. Python elements-label:
+  .. table:: *Python elements*
+
+   +---------------------+--------------------------------------------------------+
+   |Name                 |Description                                             |
+   +=====================+========================================================+
+   |Python method        |Python functions defined in python modules.             |
+   +---------------------+--------------------------------------------------------+
+   |Special python method|Python functions with special names and functionalities.|
+   +---------------------+--------------------------------------------------------+
+   |Python class         |Classes defined in python modules.                      |
+   +---------------------+--------------------------------------------------------+
+   |Python class method  |Python methods defined in python classes                |
+   +---------------------+--------------------------------------------------------+
+
+Special python methods
+^^^^^^^^^^^^^^^^^^^^^^
+
+  .. Special-python-methods-label:
+  .. table:: *Special python methods*
+
+   +--------+------------+----------------------------------------------------------+
+   |Name    |Type        |Description                                               |
+   +========+============+==========================================================+
+   |__init__|class object|The special method ``__init__`` is called when an instance|
+   |        |constructor |(object) of a class is created; instance attributes can be|
+   |        |method      |defined and initalized in the method.                     |
+   +--------+------------+----------------------------------------------------------+
+
+Table of Contents
+=================
+
+.. contents:: **Table of Content**

ka_uts_com-4.0.0.250510.dist-info/RECORD

@@ -0,0 +1,14 @@
+ka_uts_com/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+ka_uts_com/__version__.py,sha256=cDeKJoJXH0P7QinCjk6rgnqE1iSbzwkcXPtGuFPor-g,365
+ka_uts_com/app.py,sha256=XrMhqQI9YHzw1XmC8zGgCJwrwxzkHtHDEQIo9gP07DI,1151
+ka_uts_com/cfg.py,sha256=RNWxOz3XtP0HgH0z1e6tAQA_L0alEh82_EOPOoyv3R4,768
+ka_uts_com/com.py,sha256=DdL9754luzZqmHq_r6YKG4gxSSsxOGoVMohF5jaJZ8Q,1943
+ka_uts_com/exit.py,sha256=RIpFKwEGeBCBBPPQXIcLsrYeNY2dTF8BDlESe6UhdMo,791
+ka_uts_com/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+ka_uts_com/timer.py,sha256=qVKanfNBnsU3B6C-Y5mjHWnS056GiYlRmFwEnX6BAU0,2546
+ka_uts_com/decorators/dec.py,sha256=8oKf3yvJSEakjr0HuQKcc3F0qgRmDskxr6hnQaw4r_I,841
+ka_uts_com-4.0.0.250510.dist-info/licenses/LICENSE.txt,sha256=BiT3QGI_2iRbdvgS3HDig57lnXJVk60Pj4xM9eeCczI,814
+ka_uts_com-4.0.0.250510.dist-info/METADATA,sha256=Z8KlB7LZ_ali-3r6BaJtudD4nKansscm0MISiGBl4k8,32001
+ka_uts_com-4.0.0.250510.dist-info/WHEEL,sha256=DnLRTWE75wApRYVsjgc6wsVswC54sMSJhAEd4xhDpBk,91
+ka_uts_com-4.0.0.250510.dist-info/top_level.txt,sha256=cWCIrm1g6Jn-FbCQuB3wBrrNH1YwqVlc6mE0jV6vg74,21
+ka_uts_com-4.0.0.250510.dist-info/RECORD,,

{ka_uts_com-3.0.2.250508.dist-info → ka_uts_com-4.0.0.250510.dist-info}/WHEEL

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

ka_uts_com-3.0.2.250508.dist-info/METADATA

@@ -1,24 +0,0 @@
-Metadata-Version: 2.1
-Name: ka-uts-com
-Version: 3.0.2.250508
-Summary: Communication and CLIs Utilities
-Author-email: Bernd Stroehle <bernd.stroehle@gmail.com>
-Maintainer-email: Bernd Stroehle <bernd.stroehle@gmail.com>
-Project-URL: Source Code, https://github.com/bs29/ka_uts_com/tree/master
-Project-URL: Homepage, https://kosakya.de/
-Project-URL: Documentation, https://ka-com.readthedocs.io/en/latest
-Project-URL: Apache-2.0 License, https://apache.org/licenses/LICENSE-2.0
-Project-URL: GPLv3 License, https://www.gnu.org/licenses/gpl-3.0.en.html
-Classifier: Development Status :: 5 - Production/Stable
-Classifier: Intended Audience :: Developers
-Classifier: Operating System :: OS Independent
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Natural Language :: English
-Classifier: Topic :: Software Development :: Libraries :: Python Modules
-Requires-Python: >=3.10
-Description-Content-Type: text/x-rst
-License-File: LICENSE.txt
-Requires-Dist: ka-uts-arr>=3.0.1.250507
-Requires-Dist: ka-uts-log>=3.0.0.250505
-Requires-Dist: ka-uts-uts>=3.0.2.250507
-

ka_uts_com-3.0.2.250508.dist-info/RECORD

@@ -1,14 +0,0 @@
-ka_uts_com/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-ka_uts_com/__version__.py,sha256=6nh1rvCvZPhiDXbv8-IqXc77fGRLA3W8Bcit_j03-w8,365
-ka_uts_com/app.py,sha256=XrMhqQI9YHzw1XmC8zGgCJwrwxzkHtHDEQIo9gP07DI,1151
-ka_uts_com/cfg.py,sha256=RNWxOz3XtP0HgH0z1e6tAQA_L0alEh82_EOPOoyv3R4,768
-ka_uts_com/com.py,sha256=PmbQ46Ecneuh9DHuJ40yFcrwCJYfx_Uqlw4NyliVovY,1937
-ka_uts_com/exit.py,sha256=RIpFKwEGeBCBBPPQXIcLsrYeNY2dTF8BDlESe6UhdMo,791
-ka_uts_com/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-ka_uts_com/timer.py,sha256=hSNDh5qV6stSRLLEv-G_eMRoglsOU9N2HvRPUQ-s7yU,2153
-ka_uts_com/decorators/dec.py,sha256=NHerkpjOYpJXz2CIh9HlN3_YCyLv-SbyQL4ldyGUSpM,217
-ka_uts_com-3.0.2.250508.dist-info/LICENSE.txt,sha256=BiT3QGI_2iRbdvgS3HDig57lnXJVk60Pj4xM9eeCczI,814
-ka_uts_com-3.0.2.250508.dist-info/METADATA,sha256=H5kplnyF66eoLluuBDmYDD5VPncA4CFQllqG-gMK_DI,1068
-ka_uts_com-3.0.2.250508.dist-info/WHEEL,sha256=tZoeGjtWxWRfdplE7E3d45VPlLNQnvbKiYnx7gwAy8A,92
-ka_uts_com-3.0.2.250508.dist-info/top_level.txt,sha256=cWCIrm1g6Jn-FbCQuB3wBrrNH1YwqVlc6mE0jV6vg74,21
-ka_uts_com-3.0.2.250508.dist-info/RECORD,,