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

ka_uts_com/__version__.py

@@ -1,10 +1,10 @@
 __title__ = 'ka_uts_com'
-__description__ = 'Communication Utilities.'
+__description__ = 'Communication and CLI Utilities.'
 __url__ = 'https://ka-ut-com.readthedocs.io/en/latest'
-__version__ = '4.0.0.250510'
+__version__ = '4.0.4.250522'
 __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

@@ -6,12 +6,6 @@ import calendar
 from datetime import datetime
 
 from ka_uts_arr.aoeq import AoEq
-from ka_uts_uts.utils.pacmod import PacMod
-
-from ka_uts_com.app import App
-from ka_uts_com.cfg import Cfg
-from ka_uts_com.exit import Exit
-
 from ka_uts_log.log import Log
 
 TyAny = Any
@@ -33,22 +27,22 @@ class Com:
     """
     Communication Class
     """
+    cmd: TnStr = None
     sw_init: bool = False
+
+    com_a_mod = None
+    com_pac = None
+    app_a_mod = None
+    app_pac = None
     tenant: TnStr = None
-    cmd: TnStr = None
-    d_com_pacmod: TyDic = {}
-    d_app_pacmod: TyDic = {}
 
     ts: TnTimeStamp
-    # ts_start: TnDateTime = None
-    # ts_end: TnDateTime = None
-    # ts_etime: TnDateTime = None
     d_timer: TyDic = {}
 
-    Cfg: TnDic = None
     Log: Any = None
-    App: Any = None
-    Exit: Any = None
+    # Cfg: TnDic = None
+    # App: Any = None
+    # Exit: Any = None
 
     @classmethod
     def init(cls, kwargs: TyDic):
@@ -59,17 +53,19 @@ class Com:
         if cls.sw_init:
             return
         cls.sw_init = True
-        cls.tenant = kwargs.get('tenant')
         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.tenant = kwargs.get('tenant')
         cls.ts = calendar.timegm(time.gmtime())
 
         cls.Log = Log.sh(**kwargs)
-        cls.Cfg = Cfg.sh(cls, **kwargs)
-        cls.App = App.sh(cls, **kwargs)
-        cls.Exit = Exit.sh(**kwargs)
+        # cls.Cfg = Cfg.sh(cls, **kwargs)
+        # cls.App = App.sh(cls, **kwargs)
+        # cls.Exit = Exit.sh(**kwargs)
 
     @classmethod
     def sh_kwargs(cls, cls_app, d_parms, *args) -> TyDic:

ka_uts_com/dec.py

@@ -0,0 +1,47 @@
+"""
+Decorators Module
+"""
+import os
+import sys
+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):
+    """
+    Timer Decorator
+    """
+    def __wrapper(*args, **kwargs):
+        start = datetime.now()
+        fnc(*args, **kwargs)
+        _fnc_name = Fnc.sh_fnc_name(fnc)
+        end = datetime.now()
+        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
+
+
+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.message, exc_info=(exc_type, exc_value, exc_traceback))
+
+
+def handle_error(fnc):
+    """
+    Error Decorator
+    """
+    def __wrapper(*args, **kwargs):
+        try:
+            fnc(*args, **kwargs)
+            os._exit(0)
+        except Exception:
+            exc_type, exc_value, exc_traceback = sys.exc_info()
+            handle_exception(exc_type, exc_value, exc_traceback)
+            os._exit(1)
+    return __wrapper

{ka_uts_com-4.0.0.250510.dist-info → ka_uts_com-4.0.4.250522.dist-info}/METADATA

@@ -1,9 +1,12 @@
 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>
+Version: 4.0.4.250522
+Summary: Communication and CLI Utilities
+Author: Bernd Stroehle
+Author-email: bernd.stroehle@gmail.com
+Maintainer: Bernd Stroehle
+Maintainer-email: bernd.stroehle@gmail.com
+License-Expression: GPL-3.0-only WITH Classpath-exception-2.0 OR BSD-3-Clause
 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
@@ -18,10 +21,10 @@ 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
+Requires-Dist: ka_uts_arr>=4.0.2.250519
+Requires-Dist: ka_uts_log>=4.0.6.250522
+Requires-Dist: ka_uts_uts>=4.0.3.250519
+Requires-Dist: numpy>=2.2.6
 Dynamic: license-file
 
 ##########
@@ -33,7 +36,7 @@ Overview
 
 .. start short_desc
 
-**Utilities for Communication and CLI Processing**
+**Communication and CLI Utilities**
 
 .. end short_desc
 
@@ -75,15 +78,18 @@ The Package ``ka_uts_com`` consist of the following file types (c.f.: **Appendix
 
 #. **Dunder modules:** (c.f.: **Appendix:** *Special python package modules*)
 
-#. **Decorator modules**
+#. **Modules**
 
-   a. *dec.py*
+   #. **Decorator Modules**
 
-#. **Modules**
+      a. *dec.py*
 
    #. **Communication Modules**
 
       a. *com.py*
+
+   #. **Timer Modules**
+
       #. *timer.py*
 
    #. **Base Modules**
@@ -92,37 +98,55 @@ The Package ``ka_uts_com`` consist of the following file types (c.f.: **Appendix
       #. *cfg.py*
       #. *exit.py*
 
-Decorator Modules
-*****************
+Decorator Module
+****************
 
 Overview
 ========
 
-  .. Decorator Modules-label:
-  .. table:: *Decorator Modules*
+  .. Decorator Module-label:
+  .. table:: *Decorator Module*
+
+   +------+----------------+
+   |Name  |Decription      |
+   +======+================+
+   |dec.py|Decorator module|
+   +------+----------------+
+
+Decorstor module: dec.py
+========================
+
+The Decorator Module ``dec.py`` contains the single decorator function ``timer``.
+
+dec.py Method: timer
+--------------------
+        
+Parameter
+^^^^^^^^^
+
+  ..dec.py-Method-timer-Parameter-label:
+  .. table:: *dec.py Method timer: Parameter*
 
-   +------+-----------------+
-   |Name  |Decription       |
-   +======+=================+
-   |dec.py|Decorators module|
-   +------+-----------------+
+   +----+----------+-----------+
+   |Name|Type      |Description|
+   +====+==========+===========+
+   |fnc |TyCallable|function   |
+   +----+----------+-----------+
 
-Communication Modules
-*********************
+Communication Module
+********************
 
 Overview
 ========
 
-  .. Communication Modules-label:
-  .. table:: *Communication Modules*
+  .. Communication Module-label:
+  .. table:: *Communication Module*
 
-   +--------+-----------------------------+
-   |Name    |Decription                   |
-   +========+=============================+
-   |com.py  |Communication handling module|
-   +--------+-----------------------------+
-   |timer.py|Timer management module      |
-   +--------+-----------------------------+
+   +------+-----------------------------+
+   |Name  |Decription                   |
+   +======+=============================+
+   |com.py|Communication handling module|
+   +------+-----------------------------+
 
 Communication module: com.py
 ============================
@@ -143,33 +167,31 @@ Com: Variables
    +------------+-----------+-------+---------------------------------------+
    |Name        |Type       |Default|Description                            |
    +============+===========+=======+=======================================+
-   |sw_init     |TyBool     |None   |Initialisation switch                  |
+   |cmd         |TyStr      |None   |Command                                |
    +------------+-----------+-------+---------------------------------------+
    |d_com_pacmod|TyDic      |{}     |Communication package module dictionary|
    +------------+-----------+-------+---------------------------------------+
    |d_app_pacmod|TyDic      |{}     |Application package module dictionary  |
    +------------+-----------+-------+---------------------------------------+
-   |**Timestamp fields**                                                    |
-   +------------+-----------+-------+---------------------------------------+
-   |ts          |TnTimeStamp|None   |Timestamp                              |
+   |sw_init     |TyBool     |None   |Initialisation switch                  |
    +------------+-----------+-------+---------------------------------------+
-   |ts_start    |TnDateTime |None   |start timestamp in date time format    |
+   |tenant      |TyStr      |None   |Tenant name                            |
    +------------+-----------+-------+---------------------------------------+
-   |ts_end      |TnDateTime |None   |end timestamp in date time format      |
+   |**Timestamp fields**                                                    |
    +------------+-----------+-------+---------------------------------------+
-   |ts_etime    |TnDateTime |None   |elapse Time                            |
+   |ts          |TnTimeStamp|None   |Timestamp                              |
    +------------+-----------+-------+---------------------------------------+
    |d_timer     |TyDic      |False  |Timer dictionary                       |
    +------------+-----------+-------+---------------------------------------+
    |**Links to other Classes**                                              |
    +------------+-----------+-------+---------------------------------------+
-   |App         |TyAny      |False  |Application class                      |
+   |App         |TyAny      |None   |Application class                      |
    +------------+-----------+-------+---------------------------------------+
    |cfg         |TyDic      |None   |Configuration dictionary               |
    +------------+-----------+-------+---------------------------------------+
-   |Log         |TyLogger   |False  |Log class                              |
+   |Log         |TyLogger   |None   |Log class                              |
    +------------+-----------+-------+---------------------------------------+
-   |Exit        |TyAny      |False  |Exit class                             |
+   |Exit        |TyAny      |None   |Exit class                             |
    +------------+-----------+-------+---------------------------------------+
 
 Com: Methods
@@ -224,8 +246,23 @@ Parameter
    |\*args  |list |arguments array     |
    +--------+-----+--------------------+
 
-Communication module: timer.py
-==============================
+Timer Module
+************
+
+Overview
+========
+
+  .. Timer Modules-label:
+  .. table:: *Timer Modules*
+
+   +--------+-----------------------------+
+   |Name    |Decription                   |
+   +========+=============================+
+   |timer.py|Timer management module      |
+   +--------+-----------------------------+
+
+Timer module: timer.py
+======================
 
 timer.py: Classes
 -----------------
@@ -369,7 +406,7 @@ Overview
 Base module: app\_.py
 =====================
 
-The Module ``app.py`` contains a single static class ``App_``.
+The Module ``app\_.py`` contains a single static class ``App_``.
 
 Class: App\_
 ------------

ka_uts_com-4.0.4.250522.dist-info/RECORD

@@ -0,0 +1,11 @@
+ka_uts_com/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+ka_uts_com/__version__.py,sha256=dA4tv1GGQrBxxQUCbrAy6C-PZyqPqTs10nl7kenTYzA,420
+ka_uts_com/com.py,sha256=zTyWPFuxopUEfrhwn9736hzln6NDas0J3YuCV6YA64c,1816
+ka_uts_com/dec.py,sha256=JCKNNVPISJtXJfScX3rFcS9CjD0Ck2IUyK_53Gbov8Q,1276
+ka_uts_com/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+ka_uts_com/timer.py,sha256=qVKanfNBnsU3B6C-Y5mjHWnS056GiYlRmFwEnX6BAU0,2546
+ka_uts_com-4.0.4.250522.dist-info/licenses/LICENSE.txt,sha256=BiT3QGI_2iRbdvgS3HDig57lnXJVk60Pj4xM9eeCczI,814
+ka_uts_com-4.0.4.250522.dist-info/METADATA,sha256=CnWw7YIGzK9Y54kq7pGCLhtTJzjNoteA53U_p07BXLo,32599
+ka_uts_com-4.0.4.250522.dist-info/WHEEL,sha256=zaaOINJESkSfm_4HQVc5ssNzHCPXhJm0kEUakpsEHaU,91
+ka_uts_com-4.0.4.250522.dist-info/top_level.txt,sha256=cWCIrm1g6Jn-FbCQuB3wBrrNH1YwqVlc6mE0jV6vg74,21
+ka_uts_com-4.0.4.250522.dist-info/RECORD,,

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

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

ka_uts_com/app.py

@@ -1,48 +0,0 @@
-# coding=utf-8
-from typing import Any
-
-from ka_uts_log.log import Log
-from ka_uts_uts.utils.pacmod import PacMod
-from ka_uts_uts.ioc.yaml_ import Yaml_
-
-TyAny = Any
-TyArr = list[Any]
-TyBool = bool
-TyDic = dict[Any, Any]
-
-TnAny = None | Any
-TnArr = None | TyArr
-TnBool = None | bool
-TnDic = None | TyDic
-
-
-class App:
-    """Aplication Class
-    """
-    sw_init: TyBool = False
-    sw_replace_keys: TnBool = None
-    keys: TnArr = None
-    httpmod: TyAny = None
-    reqs: TyDic = {}
-    app: TyDic = {}
-
-    @classmethod
-    def init(cls, cls_com, **kwargs) -> None:
-        if cls.sw_init:
-            return
-        cls.sw_init = True
-        cls.httpmod = kwargs.get('httpmod')
-        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_yml(cls_com))
-            except Exception as exc:
-                Log.error(exc, exc_info=True)
-                raise
-
-    @classmethod
-    def sh(cls, cls_com, **kwargs) -> Any:
-        if cls.sw_init:
-            return cls
-        cls.init(cls_com, **kwargs)
-        return cls

ka_uts_com/cfg.py

@@ -1,35 +0,0 @@
-# coding=utf-8
-from typing import Any
-
-from ka_uts_uts.ioc.yaml_ import Yaml_
-from ka_uts_uts.utils.pacmod import PacMod
-
-TyAny = Any
-TyTimeStamp = int
-TyArr = list[Any]
-TyBool = bool
-TyDic = dict[Any, Any]
-
-
-class Cfg:
-    """Configuration Class
-    """
-    sw_init: TyBool = False
-    cfg: Any = None
-
-    @classmethod
-    def init(cls, cls_com, **kwargs) -> None:
-        if cls.sw_init:
-            return
-        cls.sw_init = True
-        _cls_app = kwargs.get('cls_app')
-        _path = PacMod.sh_path_cfg_yml(_cls_app)
-        if _path:
-            cls.cfg = Yaml_.read_with_safeloader(_path)
-
-    @classmethod
-    def sh(cls, cls_com, **kwargs) -> Any:
-        if cls.sw_init:
-            return cls
-        cls.init(cls_com, **kwargs)
-        return cls.cfg

ka_uts_com/decorators/dec.py

@@ -1,26 +0,0 @@
-"""
-Decorators
-"""
-# coding=utf-8
-# 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, *args, **kwargs)
-        start = datetime.now()
-        fnc(*args, **kwargs)
-        _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/exit.py

@@ -1,37 +0,0 @@
-# coding=utf-8
-from typing import Any
-
-TyAny = Any
-TyArr = list[Any]
-TyBool = bool
-TyDic = dict[Any, Any]
-
-TnAny = None | Any
-TnArr = None | TyArr
-TnBool = None | bool
-TnDic = None | TyDic
-
-
-class Exit:
-    """Exit Class
-    """
-    sw_init: TyBool = False
-    sw_critical: bool = False
-    sw_stop: bool = False
-    sw_interactive: bool = False
-
-    @classmethod
-    def init(cls, **kwargs) -> None:
-        if cls.sw_init:
-            return
-        cls.sw_init = True
-        cls.sw_critical = kwargs.get('sw_critical', False)
-        cls.sw_stop = kwargs.get('sw_stop', False)
-        cls.sw_interactive = kwargs.get('sw_interactive', False)
-
-    @classmethod
-    def sh(cls, **kwargs) -> Any:
-        if cls.sw_init:
-            return cls
-        cls.init(**kwargs)
-        return cls

ka_uts_com-4.0.0.250510.dist-info/RECORD

@@ -1,14 +0,0 @@
-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,,