ka-uts-com 2.2.0.250427__py3-none-any.whl → 2.2.3.250502__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__ = '2.2.0.250427'
+__version__ = '2.2.3.250502'
 __build__ = 0x022200
 __author__ = 'Bernd Stroehle'
 __author_email__ = 'bernd.stroehle@gmail.com'

ka_uts_com/app.py

@@ -35,7 +35,7 @@ class App:
         cls.sw_replace_keys = kwargs.get('sw_replace_keys', False)
         if cls.sw_replace_keys:
             try:
-                cls.keys = Yaml_.read_with_safeloader(PacMod.sh_path_keys(cls_com))
+                cls.keys = Yaml_.read_with_safeloader(PacMod.sh_path_keys_yml(cls_com))
             except Exception as exc:
                 Log.error(exc, exc_info=True)
                 raise

ka_uts_com/cfg.py

@@ -2,6 +2,7 @@
 from typing import Any
 
 from ka_uts_uts.ioc.yaml_ import Yaml_
+from ka_uts_uts.utils.pacmod import PacMod
 
 TyAny = Any
 TyTimeStamp = int
@@ -21,7 +22,8 @@ class Cfg:
         if cls.sw_init:
             return
         cls.sw_init = True
-        _path = cls_com.sh_path_cfg_yaml()
+        _cls_app = kwargs.get('cls_app')
+        _path = PacMod.sh_path_cfg_yml(_cls_app)
         if _path:
             cls.cfg = Yaml_.read_with_safeloader(_path)
 

ka_uts_com/com.py

@@ -1,13 +1,11 @@
-# coding=utf-8
 from typing import Any
 
-import os
+# import os
 import time
 import calendar
 from datetime import datetime
 
 from ka_uts_equ.equ import AoEqu
-from ka_uts_uts.utils.pac import Pac
 from ka_uts_uts.utils.pacmod import PacMod
 
 from ka_uts_com.app import App
@@ -36,16 +34,10 @@ class Com:
     Communication Class
     """
     sw_init: bool = False
-    dir_dat: TnStr = None
     tenant: TnStr = None
-    log_type: TnStr = None
     cmd: TnStr = None
     d_com_pacmod: TyDic = {}
     d_app_pacmod: TyDic = {}
-    path_bin = None
-    path_log_cfg = None
-
-    pid = None
 
     ts: TnTimeStamp
     ts_start: TnDateTime = None
@@ -67,17 +59,12 @@ class Com:
         if cls.sw_init:
             return
         cls.sw_init = True
-        cls.dir_dat = kwargs.get('dir_dat', '/data')
         cls.tenant = kwargs.get('tenant')
-        cls.log_type = kwargs.get('log_type', 'std')
         cls.cmd = kwargs.get('cmd')
         cls_app = kwargs.get('cls_app')
         cls.d_com_pacmod = PacMod.sh_d_pacmod(cls)
         cls.d_app_pacmod = PacMod.sh_d_pacmod(cls_app)
         cls.ts = calendar.timegm(time.gmtime())
-        cls.pid = os.getpid()
-
-        cls.path_bin = cls.sh_path_bin()
 
         cls.Log = Log.sh(**kwargs)
         cls.Cfg = Cfg.sh(cls, **kwargs)
@@ -91,33 +78,7 @@ class Com:
         """
         _kwargs: TyDic = AoEqu.sh_d_eq(*args, d_parms=d_parms)
         _kwargs['cls_app'] = cls_app
-        cls.init(_kwargs)
         _kwargs['com'] = cls
-        return _kwargs
 
-    @classmethod
-    def sh_path_bin(cls) -> Any:
-        """
-        show path to bin directory in package
-        """
-        _package = cls.d_app_pacmod['package']
-        _path = 'bin'
-        return Pac.sh_path_by_package(_package, _path)
-
-    @classmethod
-    def sh_path_data(cls) -> Any:
-        """
-        show path to data directory in package
-        """
-        _package = cls.d_app_pacmod['package']
-        _path = 'data'
-        return Pac.sh_path_by_package(_package, _path)
-
-    @classmethod
-    def sh_path_cfg_yaml(cls) -> Any:
-        """
-        show path to configuration yaml-file in data directory of package
-        """
-        _package = cls.d_app_pacmod['package']
-        _path = os.path.join('data', 'cfg.yml')
-        return Pac.sh_path_by_package(_package, _path)
+        cls.init(_kwargs)
+        return _kwargs

{ka_uts_com-2.2.0.250427.dist-info → ka_uts_com-2.2.3.250502.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ka_uts_com
-Version: 2.2.0.250427
+Version: 2.2.3.250502
 Summary: Communication and CLIs Utilities
 Author-email: Bernd Stroehle <bernd.stroehle@gmail.com>
 Maintainer-email: Bernd Stroehle <bernd.stroehle@gmail.com>
@@ -18,8 +18,8 @@ Requires-Python: >=3.10
 Description-Content-Type: text/x-rst
 License-File: LICENSE.txt
 Requires-Dist: ka_uts_equ>=2.2.0.250427
-Requires-Dist: ka_uts_log>=2.1.1.250415
-Requires-Dist: ka_uts_uts>=2.1.1.250415
+Requires-Dist: ka_uts_log>=2.2.0.250427
+Requires-Dist: ka_uts_uts>=2.2.1.250429
 Dynamic: license-file
 
 ##########
@@ -56,19 +56,39 @@ To install with ``conda``:
 
 .. end installation
 
+Package logging 
+***************
+
+(c.f.: **Appendix**: `Package Logging`)
+
 Package files
 *************
 
 Classification
 ==============
 
-The Files of Package ``ka_uts_com`` could be classified into the follwing file types:
+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*
 
-#. *Special files*
-#. *Dunder modules*
-#. *Decorator modules*
-#. *Package modules*
-#. *Data files*
+   #. **Base Modules**
+
+      a. *app.py*
+      #. *cfg.py*
+      #. *exit.py*
 
 Decorator Modules
 *****************
@@ -85,34 +105,9 @@ Overview
    |dec.py|Decorators module|
    +------+-----------------+
 
-Data Files
-**********
-
-Overview
-========
-
-  .. Data-Files-label:
-  .. table:: *Data Files*
-
-   +-----------+--------------------------------------------+
-   |Name       |Description                                 |
-   +===========+============================================+
-   |log.std.yml|Yaml configuration file for standard logging|
-   +-----------+--------------------------------------------+
-   |log.usr.yml|Yaml configuration file for user logging    |
-   +-----------+--------------------------------------------+
-
 Package Files
 *************
 
-Classification
-==============
-
-The Modules of Package ``ka_uts_com`` could be classified into the following module types:
-
-#. **Communication Modules**
-#. **Base Modules**
-
 Communication Modules
 =====================
 
@@ -135,54 +130,54 @@ Communication module com.py
 
 The Communication Module ``com.py`` contains the single static class ``Com``.
 
-Class Com
----------
+com.py Class: Com
+-----------------
 
 The static Class ``Com`` contains the subsequent variables and methods.
 
-Variables
-^^^^^^^^^
-
-  .. Variables-of-class-Com-label:
-  .. table:: *Variables of class Com*
-
-   +--------+-----------+-------+-----------------------------------+
-   |Name    |Type       |Default|Description                        |
-   +========+===========+=======+===================================+
-   |d_pacmod|TyDic      |{}     |pacmod dictionary                  |
-   +--------+-----------+-------+-----------------------------------+
-   |pid     |TyInt      |None   |current Process id                 |
-   +--------+-----------+-------+-----------------------------------+
-   |sw_init |TyBool     |None   |Initialisation switch              |
-   +--------+-----------+-------+-----------------------------------+
-   |**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                         |
-   +--------+-----------+-------+-----------------------------------+
-
-Methods
-^^^^^^^
-
-  .. Methods-of-class-Com-label:
-  .. table:: *Methods-of-class-Com*
+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                                            |
@@ -192,14 +187,14 @@ Methods
    |sh_kwargs|Show keyword arguments                                 |
    +---------+-------------------------------------------------------+
 
-Method init
-^^^^^^^^^^^
+Com Method: init
+^^^^^^^^^^^^^^^^
         
 Parameter
 """""""""
 
-  .. Parameter-of-method-init-label:
-  .. table:: *Parameter-of-method-init*
+  ..Com-Method-init-Parameter-label:
+  .. table:: *Com Method init: Parameter*
 
    +---------+-----+-----------------+
    |Name     |Type |Description      |
@@ -209,14 +204,14 @@ Parameter
    |\**kwargs|TyAny|keyword arguments|
    +---------+-----+-----------------+
 
-Method sh_kwargs
-^^^^^^^^^^^^^^^^
+Com Method: sh_kwargs
+^^^^^^^^^^^^^^^^^^^^^
         
 Parameter
 """""""""
 
-  .. Parameter-of-method-sh_kwargs-label:
-  .. table:: *Parameter of method sh_kwargs*
+  .. Com-Method-sh_kwargs-Parameter-label:
+  .. table:: *Com Method sh_kwargs: Parameter*
 
    +--------+-----+--------------------+
    |Name    |Type |Description         |
@@ -233,14 +228,14 @@ Parameter
 Time management Module timer.py
 ===============================
 
-Classes
--------
+timer.py: Classes
+-----------------
 
 The Module ``timer.py`` contains the following classes
 
 
-  .. Static-classes-of-module-timer.py-label:
-  .. table:: *Static classes of module timer.py*
+  .. timer.py-Classes-label:
+  .. table:: *timer.py classes*
 
    +---------+------+---------------+
    |Name     |Type  |Description    |
@@ -251,14 +246,14 @@ The Module ``timer.py`` contains the following classes
    +---------+------+---------------+
 
 
-Class Timer
------------
+timer.py Class: Timer
+---------------------
 
-Methods
-^^^^^^^
+Timer: Methods
+^^^^^^^^^^^^^^
 
-  .. Methods-of-class-Timer-label:
-  .. table:: *Methods of class Timer*
+  .. Timer-Methods-label:
+  .. table:: *Timer Methods*
 
    +----------+------------------------------------+
    |Name      |Description                         |
@@ -270,8 +265,8 @@ Methods
    |end       |End Timer and Log Timer info message|
    +----------+------------------------------------+
 
-Method sh_task_id
-^^^^^^^^^^^^^^^^^
+Timer Method: sh_task_id
+^^^^^^^^^^^^^^^^^^^^^^^^
         
 Show task id, which is created by the concatination of the following items if they are defined:
 #. package,
@@ -285,8 +280,8 @@ __qualname__ is used.
 Parameter
 """""""""
 
-  .. Parameter-of-method-sh_task_id-label:
-  .. table:: *Parameter-of-method-sh_task_id*
+  .. Timer-Method-sh_task_id-Parameter-label:
+  .. table:: *Timer Method sh_task_id: Parameter*
 
    +--------+-----+-----------------+
    |Name    |Type |Description      |
@@ -303,8 +298,8 @@ Parameter
 Return Value
 """"""""""""
 
-  .. Return-value-of-method-sh_task_id-label:
-  .. table:: *Return value of method sh_task_id*
+  .. Timer-Method-sh_task_id-Return-Value-label:
+  .. table:: *Timer Method sh_task_id: Return Value*
 
    +----+-----+-----------+
    |Name|Type |Description|
@@ -312,14 +307,14 @@ Return Value
    |    |TyStr|Task Id    |
    +----+-----+-----------+
 
-Method start
-^^^^^^^^^^^^
+Timer Method: start
+^^^^^^^^^^^^^^^^^^^
         
 Parameter
 """""""""
 
-  .. Parameter-of-method-start-label:
-  .. table:: *Parameter of method start*
+  .. Timer-Method-start-Parameter-label:
+  .. table:: *Timer Method start: Parameter*
 
    +--------+-----+-------------+
    |Name    |Type |Description  |
@@ -333,14 +328,14 @@ Parameter
    |sep     |TyStr|Separator    |
    +--------+-----+-------------+
 
-Method: end
-^^^^^^^^^^^
+Timer Method: end
+^^^^^^^^^^^^^^^^^
         
 Parameter
 """""""""
 
-  .. Parameter-of-end-method-label:
-  .. table:: *Parameter of end method*
+  .. Timer-Method-end-Parameter-label:
+  .. table:: *Timer Method end: Parameter*
 
    +--------+-----+-------------+
    |Name    |Type |Description  |
@@ -373,8 +368,8 @@ Overview
    |exit\_.py|Exit Manafement setup module|
    +---------+----------------------------+
 
-Application setup module: app\_.py
-==================================
+Base module: app\_.py
+=====================
 
 The Module ``app.py`` contains a single static class ``App_``.
 
@@ -383,11 +378,11 @@ Class: App\_
 
 The static class ``App_`` contains the subsequent static variables and methods
 
-Static Variables
-^^^^^^^^^^^^^^^^
+App\_: Static Variables
+^^^^^^^^^^^^^^^^^^^^^^^
 
-  .. Static-variables-of-class-App_-label:
-  .. table:: *Static Variables of class App_*
+  .. Appl\_ Static-Variables-label:
+  .. table:: *Appl\_ tatic Variables*
 
    +---------------+-------+-------+---------------------+
    |Name           |Type   |Default|Description          |
@@ -405,11 +400,11 @@ Static Variables
    |app            |TyDic  |None   |Appliction dictionary|
    +---------------+-------+-------+---------------------+
 
-Methods
-^^^^^^^
+App\_: Methods
+^^^^^^^^^^^^^^
 
-  .. Methods-of-class-App_-label:
-  .. table:: *Methods of class App_*
+  .. App\_-Methods-label:
+  .. table:: *App\_ Methods*
 
    +----+------+------------------------------------+
    |Name|Type  |Description                         |
@@ -420,14 +415,14 @@ Methods
    |sh  |class |show (return) class                 |
    +----+------+------------------------------------+
 
-Method: init
-^^^^^^^^^^^^
+App\_ Method: init
+^^^^^^^^^^^^^^^^^^
         
 Parameter
 """""""""
 
-  .. Parameter-of-method-init-label:
-  .. table:: *Parameter of method init*
+  .. App\_-Method-init-label:
+  .. table:: *App\_ Method: init*
 
    +---------+-----+-----------------+
    |Name     |Type |Description      |
@@ -437,11 +432,11 @@ Parameter
    |\**kwargs|TyAny|Keyword arguments|
    +---------+-----+-----------------+
 
-Method: sh
-^^^^^^^^^^
+App\_ Method: sh
+^^^^^^^^^^^^^^^^
         
-  .. Parameter-of-method-sh-label:
-  .. table:: *Parameter of method sh*
+  .. App\_-Method-sh-label:
+  .. table:: *App\_ Method: sh*
 
    +---------+-----+-----------------+
    |Name     |Type |Description      |
@@ -454,8 +449,8 @@ Method: sh
 Return Value
 """"""""""""
 
-  .. Return-values-of-method-sh-label:
-  .. table:: *Return values of method sh*
+  .. App\_-Method-sh-Return-Value-label:
+  .. table:: *App\_ Method sh: Return Value*
 
    +----+--------+-----------+
    |Name|Type    |Description|
@@ -463,21 +458,21 @@ Return Value
    |log |TyLogger|Logger     |
    +----+--------+-----------+
 
-cfg\_.py
-========
+Base module: cfg\_.py
+=====================
 
 The Base module cfg\_.py contains a single static class ``Cfg_``.
 
-Class Cfg\_
------------
+cfg\_.py Class Cfg\_
+---------------------
 
 The static class ``Cfg_`` contains the subsequent static variables and methods
 
-Static Variables
-^^^^^^^^^^^^^^^^
+Cfg\_Static Variables
+^^^^^^^^^^^^^^^^^^^^^
 
-  .. Static-variables-of-Cfg_-label:
-  .. table:: *Static Variables of Cfg_*
+  .. Cfg\_-Static-Variables-label:
+  .. table:: *Cfg\_ Static Variables*
 
    +----+-----+-------+--------------------+
    |Name|Type |Default|Description         |
@@ -485,11 +480,11 @@ Static Variables
    |cfg |TyDic|None   |Configuration object|
    +----+-----+-------+--------------------+
 
-Methods
-^^^^^^^
+Cfg\_ Methods
+^^^^^^^^^^^^^
 
-  .. Methods-of-class-Cfg_-label:
-  .. table:: *Methods of class Cfg_*
+  .. Cfg\_-Methods-label:
+  .. table:: *Cfg\_ Methods*
 
    +----+------+-----------------------------------+
    |Name|Type  |Description                        |
@@ -498,14 +493,14 @@ Methods
    |    |      |variable cls.dic and return cls.cfg|
    +----+------+-----------------------------------+
 
-Method: sh
-^^^^^^^^^^
+Cfg\_ Method: sh
+^^^^^^^^^^^^^^^^
         
 Parameter
 """""""""
 
-  .. Parameter-of-method-init-label:
-  .. table:: *Parameter of method sh*
+  .. Cfg\_-Method-sh-Parameter-label:
+  .. table:: *Cfg\_ Method sh: Parameter*
 
    +--------+--------+-----------------+
    |Name    |Type    |Description      |
@@ -520,8 +515,8 @@ Parameter
 Return Value
 """"""""""""
 
-  .. Return-values-of-method-sh-label:
-  .. table:: *Return values of method sh*
+  .. Cfg\_-Method-sh-Return-Value-label:
+  .. table:: *Cfg\_ Method sh: Return Value*
 
    +-------+-----+-----------+
    |Name   |Type |Description|
@@ -529,21 +524,21 @@ Return Value
    |cls.cfg|TyDic|           |
    +-------+-----+-----------+
 
-Base Modul ext\_.py
-===================
+Base Modul: exit\_.py
+=====================
 
 The Base module exit\_.py contains a single static class ``Ext_``.
 
-class Exit\_
-------------
+exit\_.py class: Exit\_
+-----------------------
 
-The static Class ``Exit_`` contains the subsequent static variables and methods.
+The static Class ``Exit_`` of Module exit\_.py contains the subsequent static variables and methods.
 
-Static Variables
-^^^^^^^^^^^^^^^^
+Exit\_: Variables
+^^^^^^^^^^^^^^^^^
 
-  .. Static variables-of-class-Ext_-label:
-  .. table:: *Static variables of class Ext_*
+  .. Exit\_-Variables-label:
+  .. table:: *Exit\_ Variables*
 
    +--------------+------+-------+---------------------+
    |Name          |Type  |Default|Description          |
@@ -557,11 +552,11 @@ Static Variables
    |sw_interactive|TyBool|False  |interactive switch   |
    +--------------+------+-------+---------------------+
 
-Methods
-^^^^^^^
+Exit\_: Methods
+^^^^^^^^^^^^^^^
 
-  .. Methods-of-class-Ext_-label:
-  .. table:: *Methods of class Ext_*
+  .. Exit\_-Methods-label:
+  .. table:: *Exit\_ Methods*
 
    +----+------+------------------------------------+
    |Name|Method|Description                         |
@@ -572,14 +567,14 @@ Methods
    |sh  |class |show (return) class                 |
    +----+------+------------------------------------+
 
-Method: init
-^^^^^^^^^^^^
+Exit\_: Method: init
+^^^^^^^^^^^^^^^^^^^^
         
 Parameter
 """""""""
 
-  .. Parameter-of-method-init-label:
-  .. table:: *Parameter of method init*
+  .. Exit\_-Method-init-Parameter:
+  .. table:: *Exit\_ Method init: Parameter*
 
    +---------+-----+-----------------+
    |Name     |Type |Description      |
@@ -589,14 +584,14 @@ Parameter
    |\**kwargs|TyAny|Keyword arguments|
    +---------+-----+-----------------+
 
-Method: sh
-^^^^^^^^^^
+Exit\_: Method: sh
+^^^^^^^^^^^^^^^^^^
         
 Parameter
 """""""""
 
-  .. Parameter-of-method-sh-label:
-  .. table:: *Parameter of method sh*
+  .. Exit\_-Method-sh-Parameter:
+  .. table:: *Exit\_ Method sh: Parameter*
 
    +---------+-----+-----------------+
    |Name     |Type |Description      |
@@ -609,8 +604,8 @@ Parameter
 Return Value
 """"""""""""
 
-  .. Return-values-of-method-sh-label:
-  .. table:: *Return values of method sh*
+  .. Exit\_-Method-sh-Return-Value:
+  .. table:: *Exit\_ Method sh: Return Value*
 
    +----+-----+-------------+
    |Name|Type |Description  |
@@ -650,33 +645,25 @@ Application parameter for logging
   .. Application-parameter-used-in-log-naming-label:
   .. table:: *Application parameter used in log naming*
 
-   +-----------------+--------------------------+-----------------+------------+
-   |Name             |Decription                |Values           |Example     |
-   |                 |                          +-----------------+            |
-   |                 |                          |Value|Type       |            |
-   +=================+==========================+=====+===========+============+
-   |dir_dat          |Application data directory|     |Path       |/otev/data  |
-   +-----------------+--------------------------+-----+-----------+------------+
-   |tenant           |Application tenant name   |     |str        |UMH         |
-   +-----------------+--------------------------+-----+-----------+------------+
-   |package          |Application package name  |     |str        |otev_xls_srr|
-   +-----------------+--------------------------+-----+-----------+------------+
-   |cmd              |Application command       |     |str        |evupreg     |
-   +-----------------+--------------------------+-----+-----------+------------+
-   |pid              |Process ID                |     |str        |evupreg     |
-   +-----------------+--------------------------+-----+-----------+------------+
-   |log_ts_type      |Timestamp type used in    |ts   |Timestamp  |ts          |
-   |                 |loggin files              +-----+-----------+------------+
-   |                 |                          |dt   |Datetime   |            |
-   +-----------------+--------------------------+-----+-----------+------------+
-   |log_sw_single_dir|Enable single log         |True |Bool       |True        |
-   |                 |directory or multiple     +-----+-----------+            |
-   |                 |log directories           |False|Bool       |            |
-   +-----------------+--------------------------+-----+-----------+------------+
-   |log_sw_pid       |Enable display of pid     |True |Bool       |True        |
-   |                 |in log file name          +-----+-----------+            |
-   |                 |                          |False|Bool       |            |
-   +-----------------+--------------------------+-----+-----------+------------+
+   +-----------------+---------------------------+----------+------------+
+   |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
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^
@@ -705,8 +692,8 @@ Single or multiple Application log directories can be used for each message type
 Log files naming
 ^^^^^^^^^^^^^^^^
 
-Conventions
-"""""""""""
+Naming Conventions
+""""""""""""""""""
 
   .. Naming-conventions-for-logging-file-paths-label:
   .. table:: *Naming conventions for logging file paths*
@@ -725,47 +712,34 @@ Conventions
    |critical|/<dir_dat>/<tenant>/RUN/<package>/<cmd>/<Log directory>|<Log type>_<ts>_<pid>.log|
    +--------+-------------------------------------------------------+-------------------------+
 
-Examples (with log_ts_type = 'ts')
-""""""""""""""""""""""""""""""""""
-
-The examples use the following parameter values.
-
-#. dir_dat = '/data/otev'
-#. tenant = 'UMH'
-#. package = 'otev_srr'
-#. cmd = 'evupreg'
-#. log_sw_single_dir = True
-#. log_sw_pid = True
-#. log_ts_type = 'ts'
+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_srr/evupreg/logs|debs_1737118199_9470.log|
-   +--------+----------------------------------------+------------------------+
-   |info    |/data/otev/umh/RUN/otev_srr/evupreg/logs|infs_1737118199_9470.log|
-   +--------+----------------------------------------+------------------------+
-   |warning |/data/otev/umh/RUN/otev_srr/evupreg/logs|wrns_1737118199_9470.log|
-   +--------+----------------------------------------+------------------------+
-   |error   |/data/otev/umh/RUN/otev_srr/evupreg/logs|errs_1737118199_9470.log|
-   +--------+----------------------------------------+------------------------+
-   |critical|/data/otev/umh/RUN/otev_srr/evupreg/logs|crts_1737118199_9470.log|
-   +--------+----------------------------------------+------------------------+
+   +--------+--------------------------------------------+------------------------+
+   |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 package
---------------
-
-Overview
-^^^^^^^^
+Python packages
+---------------
 
-  .. Python package-label:
-  .. table:: *Python package*
+  .. Python packages-label:
+  .. table:: *Python packages*
 
    +-----------+-----------------------------------------------------------------+
    |Name       |Definition                                                       |
@@ -777,47 +751,42 @@ Overview
    |sub-package|another pyhon package.                                           |
    +-----------+-----------------------------------------------------------------+
 
-Python package sub-directories
-------------------------------
-
-Overview
-^^^^^^^^
-
-  .. Python package sub-direcories-label:
-  .. table:: *Python package sub-directories*
-
-   +---------------------+----------------------------------------+
-   |Name                 |Definition                              |
-   +=====================+========================================+
-   |Python               |directory contained in a python package.|
-   |package sub-directory|                                        |
-   +---------------------+----------------------------------------+
-   |Special python       |Python package sub-directories with a   |
-   |package sub-directory|special meaning like data or cfg.       |
-   +---------------------+----------------------------------------+
-
-Special python package sub-directories
---------------------------------------
-
-Overview
-^^^^^^^^
-
-  .. Special-python-package-sub-directories-label:
-  .. table:: *Special python sun-directories*
+Python package Sub-directories
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-   +----+------------------------------------------+
-   |Name|Description                               |
-   +====+==========================================+
-   |data|Directory for package data files.         |
-   +----+------------------------------------------+
-   |cfg |Directory for package configuration files.|
-   +----+------------------------------------------+
+  .. 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
---------------------
-
-Overview
-^^^^^^^^
+^^^^^^^^^^^^^^^^^^^^
 
   .. Python-package-files-label:
   .. table:: *Python package files*
@@ -825,24 +794,21 @@ Overview
    +--------------+---------------------------------------------------------+
    |Name          |Definition                                               |
    +==============+==========+==============================================+
-   |Python        |File within a python package.                            |
-   |package file  |                                                         |
+   |Python        |Files within a python package.                           |
+   |package files |                                                         |
    +--------------+---------------------------------------------------------+
-   |Special python|Python package file which are not modules and used as    |
-   |package file  |python marker files like ``__init__.py``.                |
+   |Special python|Package files which are not modules and used as python   |
+   |package files |and used as python marker files like ``__init__.py``.    |
    +--------------+---------------------------------------------------------+
-   |Python        |File with suffix ``.py`` which could be empty or contain |
-   |package module|python code; Other modules can be imported into a module.|
+   |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|Python package module with special name and functionality|
-   |package module|like ``main.py`` or ``__init__.py``.                     |
+   |Special python|Modules like ``__init__.py`` or ``main.py`` with special |
+   |package module|names and functionality.                                 |
    +--------------+---------------------------------------------------------+
 
 Special python package files
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-Overview
-°°°°°°°°
+""""""""""""""""""""""""""""
 
   .. Special-python-package-files-label:
   .. table:: *Special python package files*
@@ -857,10 +823,7 @@ Overview
    +--------+--------+---------------------------------------------------------------+
 
 Special python package modules
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-Overview
-°°°°°°°°
+""""""""""""""""""""""""""""""
 
   .. Special-Python-package-modules-label:
   .. table:: *Special Python package modules*
@@ -884,34 +847,24 @@ Overview
 Python elements
 ---------------
 
-Overview
-°°°°°°°°
-
   .. Python elements-label:
   .. table:: *Python elements*
 
-   +-------------------+---------------------------------------------+
-   |Name               |Definition                                   |
-   +===================+=============================================+
-   |Python method      |Function defined in a python module.         |
-   +-------------------+---------------------------------------------+
-   |Special            |Python method with special name and          |
-   |python method      |functionality like ``init``.                 |
-   +-------------------+---------------------------------------------+
-   |Python class       |Python classes are defined in python modules.|
-   +-------------------+---------------------------------------------+
-   |Python class method|Python method defined in a python class.     |
-   +-------------------+---------------------------------------------+
-   |Special            |Python class method with special name and    |
-   |Python class method|functionality like ``init``.                 |
-   +-------------------+---------------------------------------------+
+   +---------------------+--------------------------------------------------------+
+   |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
 ^^^^^^^^^^^^^^^^^^^^^^
 
-Overview
-°°°°°°°°
-
   .. Special-python-methods-label:
   .. table:: *Special python methods*
 

ka_uts_com-2.2.3.250502.dist-info/RECORD

@@ -0,0 +1,14 @@
+ka_uts_com/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+ka_uts_com/__version__.py,sha256=t_0Kx0fHmWQPmaQ0lBYRU1WhrCePgyKr1kpAoor2xzI,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=CQIsrDEe8soZ41PxW2YN1s1NvagVa3PUo8DgiczUQc0,1938
+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-2.2.3.250502.dist-info/licenses/LICENSE.txt,sha256=BiT3QGI_2iRbdvgS3HDig57lnXJVk60Pj4xM9eeCczI,814
+ka_uts_com-2.2.3.250502.dist-info/METADATA,sha256=7aAoUwJnNqpU81-5PieL2DtaBE-ZcUWOBMcEvwbZbJ0,31847
+ka_uts_com-2.2.3.250502.dist-info/WHEEL,sha256=wXxTzcEDnjrTwFYjLPcsW_7_XihufBwmpiBeiXNBGEA,91
+ka_uts_com-2.2.3.250502.dist-info/top_level.txt,sha256=cWCIrm1g6Jn-FbCQuB3wBrrNH1YwqVlc6mE0jV6vg74,21
+ka_uts_com-2.2.3.250502.dist-info/RECORD,,

{ka_uts_com-2.2.0.250427.dist-info → ka_uts_com-2.2.3.250502.dist-info}/WHEEL

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

ka_uts_com-2.2.0.250427.dist-info/RECORD

@@ -1,14 +0,0 @@
-ka_uts_com/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-ka_uts_com/__version__.py,sha256=X178HytYJn2nJ_3u7ZEbA14WN68VJsJ-_HnHbi62DTE,365
-ka_uts_com/app.py,sha256=3ns3q-nmPArmKEwitIp4xHR5cEl5tU-Q6QM1NHkM9Wc,1147
-ka_uts_com/cfg.py,sha256=RQoOwiPRyElO40lu7GqXDcOV-G0Sx_9i09sxkZVK6mI,678
-ka_uts_com/com.py,sha256=DvlZo5FBtVPJlNa4LIX_7x4kgFpRsPBPa0OGOre7aK0,3075
-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-2.2.0.250427.dist-info/licenses/LICENSE.txt,sha256=BiT3QGI_2iRbdvgS3HDig57lnXJVk60Pj4xM9eeCczI,814
-ka_uts_com-2.2.0.250427.dist-info/METADATA,sha256=8NKVY_1kbxdJnkEAxJrbpYdftQpl29nzfS_aALTE8gM,32848
-ka_uts_com-2.2.0.250427.dist-info/WHEEL,sha256=ck4Vq1_RXyvS4Jt6SI0Vz6fyVs4GWg7AINwpsaGEgPE,91
-ka_uts_com-2.2.0.250427.dist-info/top_level.txt,sha256=cWCIrm1g6Jn-FbCQuB3wBrrNH1YwqVlc6mE0jV6vg74,21
-ka_uts_com-2.2.0.250427.dist-info/RECORD,,