ka-uts-com 4.0.2.250519__py3-none-any.whl → 4.1.0.250525__py3-none-any.whl

ka_uts_com/__version__.py

@@ -1,10 +1,10 @@
 __title__ = 'ka_uts_com'
 __description__ = 'Communication and CLI Utilities.'
 __url__ = 'https://ka-ut-com.readthedocs.io/en/latest'
-__version__ = '4.0.2.250519'
+__version__ = '4.1.0.250525'
 __build__ = 0x022200
 __author__ = 'Bernd Stroehle'
 __author_email__ = 'bernd.stroehle@gmail.com'
-__license__ = 'Apache-2.0'
+__license__ = 'GPL-3.0-only WITH Classpath-Exception-2.0 OR BSD-3-Clause'
 __copyright__ = 'Copyright 2025 Bernd Stroehle'
 __cake__ = u'\u2728 \U0001f370 \u2728'

ka_uts_com/com.py

@@ -52,15 +52,13 @@ class Com:
         """
         if cls.sw_init:
             return
+        cls.sw_init = True
         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.com_a_mod = cls.__module__.split(".")
         cls.com_pac = cls.com_a_mod[0]
+        _cls_app = kwargs.get('cls_app')
         cls.app_a_mod = _cls_app.__module__.split(".")
         cls.app_pac = cls.app_a_mod[0]
-        cls.sw_init = True
         cls.tenant = kwargs.get('tenant')
         cls.ts = calendar.timegm(time.gmtime())
 

ka_uts_com/dec.py

@@ -1,6 +1,8 @@
 """
 Decorators Module
 """
+import os
+import sys
 import numpy as np
 from datetime import datetime
 from ka_uts_uts.utils.fnc import Fnc
@@ -11,7 +13,7 @@ def timer(fnc):
     """
     Timer Decorator
     """
-    def wrapper(*args, **kwargs):
+    def dec_timer(*args, **kwargs):
         start = datetime.now()
         fnc(*args, **kwargs)
         _fnc_name = Fnc.sh_fnc_name(fnc)
@@ -19,5 +21,31 @@ def timer(fnc):
         elapse_time = end.timestamp() - start.timestamp()
         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)
-    return wrapper
+        # Log.info(msg, stacklevel=2)
+        Log.info(msg)
+    return dec_timer
+
+
+def handle_exception(exc_type, exc_value, exc_traceback):
+    if issubclass(exc_type, KeyboardInterrupt):
+        sys.__excepthook__(exc_type, exc_value, exc_traceback)
+        return
+    Log.critical(exc_value, exc_info=(exc_type, exc_value, exc_traceback))
+
+
+def handle_error(fnc):
+    """
+    Error Decorator
+    """
+    def dec_handle_error(*args, **kwargs):
+        try:
+            fnc(*args, **kwargs)
+            os._exit(0)
+        except Exception:
+            exc_type, exc_value, exc_traceback = sys.exc_info()
+            if issubclass(exc_type, KeyboardInterrupt):
+                sys.__excepthook__(exc_type, exc_value, exc_traceback)
+            else:
+                Log.critical(exc_value, exc_info=(exc_type, exc_value, exc_traceback))
+                os._exit(99)
+    return dec_handle_error

{ka_uts_com-4.0.2.250519.dist-info → ka_uts_com-4.1.0.250525.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ka_uts_com
-Version: 4.0.2.250519
+Version: 4.1.0.250525
 Summary: Communication and CLI Utilities
 Author: Bernd Stroehle
 Author-email: bernd.stroehle@gmail.com
@@ -21,9 +21,9 @@ 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.1.250513
-Requires-Dist: ka_uts_log>=4.0.1.250513
-Requires-Dist: ka_uts_uts>=4.0.2.250518
+Requires-Dist: ka_uts_arr>=4.1.0.250525
+Requires-Dist: ka_uts_log>=4.1.0.250525
+Requires-Dist: ka_uts_uts>=4.1.0.250525
 Requires-Dist: numpy>=2.2.6
 Dynamic: license-file
 
@@ -31,6 +31,7 @@ Dynamic: license-file
 ka_uts_com
 ##########
 
+********
 Overview
 ********
 
@@ -40,6 +41,7 @@ Overview
 
 .. end short_desc
 
+************
 Installation
 ************
 
@@ -61,11 +63,13 @@ To install with ``conda``:
 
 .. end installation
 
+***************
 Package logging 
 ***************
 
 (c.f.: **Appendix**: `Package Logging`)
 
+*************
 Package files
 *************
 
@@ -98,6 +102,7 @@ The Package ``ka_uts_com`` consist of the following file types (c.f.: **Appendix
       #. *cfg.py*
       #. *exit.py*
 
+****************
 Decorator Module
 ****************
 
@@ -113,19 +118,33 @@ Overview
    |dec.py|Decorator module|
    +------+----------------+
 
-Decorstor module: dec.py
+Decorator module: dec.py
 ========================
 
-The Decorator Module ``dec.py`` contains the single decorator function ``timer``.
+Decorator functions of modul: dec
+---------------------------------
+
+The Decorator Module ``dec.py`` contains the follwing decorator functions.
+
+  .. Decorator-functions-of-module-dec-label:
+  .. table:: *Decorator functions of module dec*
 
-dec.py Method: timer
---------------------
+   +------------+-----------------+
+   |Name        |Description      |
+   +============+=================+
+   |timer       |Timer            |
+   +------------+-----------------+
+   |handle_error|Handle exceptions|
+   +------------+-----------------+
+
+Decorator functions: timer of modul: dec
+----------------------------------------
         
 Parameter
 ^^^^^^^^^
 
-  ..dec.py-Method-timer-Parameter-label:
-  .. table:: *dec.py Method timer: Parameter*
+  .. Parameter-of-decorator-function-timer-label:
+  .. table:: *Parameter of decorator function timer*
 
    +----+----------+-----------+
    |Name|Type      |Description|
@@ -133,6 +152,7 @@ Parameter
    |fnc |TyCallable|function   |
    +----+----------+-----------+
 
+********************
 Communication Module
 ********************
 
@@ -194,8 +214,8 @@ Com: Variables
    |Exit        |TyAny      |None   |Exit class                             |
    +------------+-----------+-------+---------------------------------------+
 
-Com: Methods
-^^^^^^^^^^^^
+Methods of class: Com
+^^^^^^^^^^^^^^^^^^^^^
 
   .. Com-Methods-label:
   .. table:: *Com Methods*
@@ -246,6 +266,7 @@ Parameter
    |\*args  |list |arguments array     |
    +--------+-----+--------------------+
 
+************
 Timer Module
 ************
 
@@ -384,6 +405,7 @@ Parameter
    |sep     |TyStr|Separator    |
    +--------+-----+-------------+
 
+************
 Base Modules
 ************
 
@@ -648,23 +670,32 @@ Return Value
    |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.
+package **ka_uts_log** using the standard- or user-configuration files in the logging
+package configuration directory:
+
+* **<logging package directory>/cfg/ka_std_log.yml**,
+* **<logging package directory>/cfg/ka_usr_log.yml**.
+
+The Logging configuration of the logging package could be overriden by yaml files with the
+same names in the application package- or application data-configuration directories:
+
+* **<application package directory>/cfg**
+* **<application data directory>/cfg**.
 
 Log message types
------------------
+=================
 
 Logging defines log file path names for the following log message types: .
 
@@ -674,34 +705,8 @@ Logging defines log file path names for the following log message types: .
 #. *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
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+Log types and Log directories
+-----------------------------
 
 Single or multiple Application log directories can be used for each message type:
 
@@ -724,11 +729,37 @@ Single or multiple Application log directories can be used for each message type
    |critical|crts |crts    |logs  |
    +--------+-----+--------+------+
 
+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                 |      |681025      |
+   +-----------------+---------------------------+------+------------+
+   |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 files naming
-^^^^^^^^^^^^^^^^
+----------------
 
 Naming Conventions
-""""""""""""""""""
+^^^^^^^^^^^^^^^^^^
 
   .. Naming-conventions-for-logging-file-paths-label:
   .. table:: *Naming conventions for logging file paths*
@@ -748,7 +779,7 @@ Naming Conventions
    +--------+-------------------------------------------------------+-------------------------+
 
 Naming Examples
-"""""""""""""""
+^^^^^^^^^^^^^^^
 
   .. Naming-examples-for-logging-file-paths-label:
   .. table:: *Naming examples for logging file paths*
@@ -767,46 +798,41 @@ Naming Examples
    |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*
+******************
+
+Python Packages
+===============
+
+Overview
+--------
+
+  .. Python Packages-Overview-label:
+  .. table:: *Python Packages Overview*
+
+   +---------------------+-----------------------------------------------------------------+
+   |Name                 |Definition                                                       |
+   +=====================+=================================================================+
+   |Python package       |Python packages are directories that contains the special module |
+   |                     |``__init__.py`` and other modules, packages files or directories.|
+   +---------------------+-----------------------------------------------------------------+
+   |Python sub-package   |Python sub-packages are python packages which are contained in   |
+   |                     |another pyhon package.                                           |
+   +---------------------+-----------------------------------------------------------------+
+   |Python package       |directory contained in a python package.                         |
+   |sub-directory        |                                                                 |
+   +---------------------+-----------------------------------------------------------------+
+   |Python package       |Python package sub-directories with a special meaning like data  |
+   |special sub-directory|or cfg                                                           |
+   +---------------------+-----------------------------------------------------------------+
+
+
+Examples
+--------
+
+  .. Python-Package-sub-directory-Examples-label:
+  .. table:: *Python Package sub-directory-Examples*
 
    +-------+------------------------------------------+
    |Name   |Description                               |
@@ -821,10 +847,13 @@ Special python package Sub-directories
    +-------+------------------------------------------+
 
 Python package files
-^^^^^^^^^^^^^^^^^^^^
+====================
+
+Overview
+--------
 
-  .. Python-package-files-label:
-  .. table:: *Python package files*
+  .. Python-package-files-overview-label:
+  .. table:: *Python package overview files*
 
    +--------------+---------------------------------------------------------+
    |Name          |Definition                                               |
@@ -842,48 +871,41 @@ Python package files
    |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.          |
-   +--------+--------+---------------------------------------------------------------+
+Examples
+--------
 
-Special python package modules
-""""""""""""""""""""""""""""""
-
-  .. Special-Python-package-modules-label:
-  .. table:: *Special Python package modules*
+  .. Python-package-files-examples-label:
+  .. table:: *Python package examples files*
 
    +--------------+-----------+-----------------------------------------------------------------+
    |Name          |Type       |Description                                                      |
    +==============+===========+=================================================================+
+   |py.typed      |Type       |The ``py.typed`` file is a marker file used in Python packages to|
+   |              |checking   |indicate that the package supports type checking. This is a part |
+   |              |marker     |of the PEP 561 standard, which provides a standardized way to    |
+   |              |file       |package and distribute type information in Python.               |
+   +--------------+-----------+-----------------------------------------------------------------+
    |__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>**.   |
+   |              |for the    |the package. The module is executed when the package is called   |
+   |              |package    |by 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 methods
+==============
+
+Overview
+--------
 
-  .. Python elements-label:
-  .. table:: *Python elements*
+  .. Python-methods-overview-label:
+  .. table:: *Python methods overview*
 
    +---------------------+--------------------------------------------------------+
    |Name                 |Description                                             |
@@ -897,11 +919,11 @@ Python elements
    |Python class method  |Python methods defined in python classes                |
    +---------------------+--------------------------------------------------------+
 
-Special python methods
-^^^^^^^^^^^^^^^^^^^^^^
+Examples
+--------
 
-  .. Special-python-methods-label:
-  .. table:: *Special python methods*
+  .. Python-methods-examples-label:
+  .. table:: *Python methods examples*
 
    +--------+------------+----------------------------------------------------------+
    |Name    |Type        |Description                                               |
@@ -911,7 +933,8 @@ Special python methods
    |        |method      |defined and initalized in the method.                     |
    +--------+------------+----------------------------------------------------------+
 
+#################
 Table of Contents
-=================
+#################
 
 .. contents:: **Table of Content**

ka_uts_com-4.1.0.250525.dist-info/RECORD

@@ -0,0 +1,11 @@
+ka_uts_com/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+ka_uts_com/__version__.py,sha256=9XmDK3D7ksJO1AEWTUVSAp5jvMxxLH3bQc-IYu3biVQ,420
+ka_uts_com/com.py,sha256=zTyWPFuxopUEfrhwn9736hzln6NDas0J3YuCV6YA64c,1816
+ka_uts_com/dec.py,sha256=sfvykrzESPHRbLLjfRpaNfz07gEB8dIMRdZC-doAjgk,1478
+ka_uts_com/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+ka_uts_com/timer.py,sha256=qVKanfNBnsU3B6C-Y5mjHWnS056GiYlRmFwEnX6BAU0,2546
+ka_uts_com-4.1.0.250525.dist-info/licenses/LICENSE.txt,sha256=BiT3QGI_2iRbdvgS3HDig57lnXJVk60Pj4xM9eeCczI,814
+ka_uts_com-4.1.0.250525.dist-info/METADATA,sha256=GnIiNuUQM4hWvQTiU-Z1ObXKVTKAZ2RvdsIi3sV73_A,32921
+ka_uts_com-4.1.0.250525.dist-info/WHEEL,sha256=zaaOINJESkSfm_4HQVc5ssNzHCPXhJm0kEUakpsEHaU,91
+ka_uts_com-4.1.0.250525.dist-info/top_level.txt,sha256=cWCIrm1g6Jn-FbCQuB3wBrrNH1YwqVlc6mE0jV6vg74,21
+ka_uts_com-4.1.0.250525.dist-info/RECORD,,

{ka_uts_com-4.0.2.250519.dist-info → ka_uts_com-4.1.0.250525.dist-info}/WHEEL

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

ka_uts_com-4.0.2.250519.dist-info/RECORD

@@ -1,11 +0,0 @@
-ka_uts_com/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-ka_uts_com/__version__.py,sha256=MnTyIshnEK9ysvQxq9S1sZHBeW0zVhmCMoy3sMtMSsM,373
-ka_uts_com/com.py,sha256=adNYxZIhPXLRLNyvJ772ZZRy70n2yKXPbrO5kFM3Bzk,1927
-ka_uts_com/dec.py,sha256=1qxjJI2Rem7ZyETP1z20SsYPSYQw0XHUAHa_JbachBE,615
-ka_uts_com/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-ka_uts_com/timer.py,sha256=qVKanfNBnsU3B6C-Y5mjHWnS056GiYlRmFwEnX6BAU0,2546
-ka_uts_com-4.0.2.250519.dist-info/licenses/LICENSE.txt,sha256=BiT3QGI_2iRbdvgS3HDig57lnXJVk60Pj4xM9eeCczI,814
-ka_uts_com-4.0.2.250519.dist-info/METADATA,sha256=nbt1ho98PUT5FQvo6JsfRQpOBggrA_TC6GWBRUV4P2M,32599
-ka_uts_com-4.0.2.250519.dist-info/WHEEL,sha256=Nw36Djuh_5VDukK0H78QzOX-_FQEo6V37m3nkm96gtU,91
-ka_uts_com-4.0.2.250519.dist-info/top_level.txt,sha256=cWCIrm1g6Jn-FbCQuB3wBrrNH1YwqVlc6mE0jV6vg74,21
-ka_uts_com-4.0.2.250519.dist-info/RECORD,,