ut-wdp 1.0.0.20250816__py3-none-any.whl

ut_wdp/__version__.py

@@ -0,0 +1,26 @@
+"""Version module
+Attributes:
+    __title__: package title
+    __description__: package description
+    __url__: project url
+    __version__: package version'
+    __build__: package build id
+    __author__: package author
+    __author_email__: email of package author'
+    __license__: package license
+    __copyright__: package copyright
+    __cake__: package cake
+"""
+from datetime import datetime
+_now = datetime.now().strftime("%Y%m%d")
+
+__title__ = 'ut_wdp'
+__description__ = 'Utilities for Watch Dog Processors.'
+__url__ = 'https://ut-wdp.readthedocs.io/en/latest'
+__version__ = f'1.0.0.{_now}'
+__build__ = _now
+__author__ = 'Bernd Stroehle'
+__author_email__ = 'bernd.stroehle@gmail.com'
+__license__ = 'GPL-3.0-only WITH Classpath-Exception-2.0 OR BSD-3-Clause'
+__copyright__ = 'Copyright 2025 Bernd Stroehle'
+__cake__ = u'\u2728 \U0001f370 \u2728'

ut_wdp/pmeh/wdp.py

@@ -0,0 +1,151 @@
+"""
+This module provides task scheduling classes for the management of OmniTracker
+SRR (NHRR) processing for Department UMH.
+    SRR: Sustainability Risk Rating
+    NHRR: Nachhaltigkeits Risiko Rating
+"""
+import os
+import glob
+import time
+
+from ut_log.log import LogEq, Log
+from ut_dic.dic import Dic
+from ut_path.pathnm import PathNm
+from ut_path.path import Path, AoPath
+from ut_ctl.journalctl import Journalctl
+
+from watchdog.observers import Observer
+from watchdog.events import PatternMatchingEventHandler
+
+from typing import Any
+TyArr = list[Any]
+TyDic = dict[Any, Any]
+TyStr = str
+TyPath = str
+TyAoPath = list[str]
+
+TnPath = None | TyPath
+
+
+class PmeHandler(PatternMatchingEventHandler):
+    """
+    WatchDog Event Handler for pattern matching of files paths
+    """
+    msg_evt: TyStr = "Watchdog received {E} - {P}"
+    msg_exe: TyStr = "Watchdog executes script: {S}"
+
+    def __init__(self, patterns, scripts):
+        # Set the patterns for PatternMatchingEventHandler
+        # self.kwargs = kwargs
+        super().__init__(
+                patterns=patterns,
+                ignore_patterns=None,
+                ignore_directories=True,
+                case_sensitive=False)
+        self.scripts = scripts
+
+    def ex(self):
+        """
+        Process created or modified event
+        """
+        Log.debug(f"Watchdog executes scripts: {self.scripts}")
+        for _script in self.scripts:
+            Log.debug(f"Watchdog executes script: {_script}")
+            if os.path.exists(_script):
+                os.system(_script)
+            else:
+                Log.error(f"Script {_script} not found")
+
+    def on_created(self, event):
+        """
+        Process 'files paths are created' event
+        """
+        _path = event.src_path
+        Log.debug(f"Watchdog received created event = {event} for path = {_path}")
+        self.ex()
+
+    def on_modified(self, event):
+        """
+        Process 'files paths are modified' event
+        """
+        _path = event.src_path
+        Log.debug(f"Watchdog received modified event = {event} for path = {_path}")
+        self.ex()
+
+
+class WdP:
+    """
+    Watch Dog Processor
+    """
+    @staticmethod
+    def sh_scripts(kwargs: TyDic) -> TyArr:
+        """
+        WatchDog Task for pattern matching of files paths
+        """
+        _scripts: TyArr = Dic.get_as_array(kwargs, 'scripts')
+        LogEq.debug("_scripts", _scripts)
+
+        _scripts_new = []
+        for _script in _scripts:
+            LogEq.debug("_script", _script)
+            _script = Path.sh_path_by_tpl_pac_sep(_script, kwargs)
+            LogEq.debug("_script", _script)
+            _scripts_new.append(_script)
+        LogEq.debug("_scripts_new", _scripts_new)
+        return _scripts_new
+
+    @classmethod
+    def sh_a_path_gt_threshold(
+            cls, in_dir, in_patterns, kwargs: TyDic) -> TyAoPath:
+        """
+        WatchDog Task for pattern matching of files paths
+        """
+        _a_path: TyAoPath = []
+        _service_name = kwargs.get('service_name', '')
+        # _last_stop_ts = Journalctl.get_last_stop_ts_s(_service_name)
+        _last_stop_ts = Journalctl.get_last_stop_ts_s(_service_name)
+        Log.debug(f"_last_stop_ts: {_last_stop_ts} for service: {_service_name}")
+        if not _last_stop_ts:
+            return _a_path
+
+        for _path in in_patterns:
+            _path_new = os.path.join(in_dir, _path)
+            _a_path = _a_path + glob.glob(_path_new)
+        msg = f"_a_path: {_a_path} for in_dir: {in_dir}, _in_patterns: {in_patterns}"
+        Log.debug(msg)
+        _a_path = AoPath.sh_aopath_mtime_gt_threshold(_a_path, _last_stop_ts)
+        Log.debug(f"_a_path: {_a_path} after selection by threshhold: {_last_stop_ts}")
+        return _a_path
+
+    @classmethod
+    def pmeh(cls, kwargs: TyDic) -> None:
+        """
+        WatchDog Task for pattern matching of files paths
+        """
+        _in_dir = PathNm.sh_path('in_dir', kwargs)
+        _in_patterns: TyArr = Dic.get_as_array(kwargs, 'in_patterns')
+        _scripts: TyArr = cls.sh_scripts(kwargs)
+
+        LogEq.debug("_in_dir", _in_dir)
+        LogEq.debug("_in_patterns", _in_patterns)
+        LogEq.debug("_scripts", _scripts)
+
+        _pmehandler = PmeHandler(_in_patterns, _scripts)
+
+        _sw_ex_gt_threshold = kwargs.get('sw_ex_gt_threshold', False)
+        if _sw_ex_gt_threshold:
+            _a_path = cls.sh_a_path_gt_threshold(_in_dir, _in_patterns, kwargs)
+            if len(_a_path) > 0:
+                _pmehandler.ex()
+
+        _observer = Observer()
+        _observer.schedule(_pmehandler, path=_in_dir, recursive=False)
+        _observer.start()
+
+        _sleep: int = kwargs.get('sleep', 1)
+        try:
+            while True:
+                time.sleep(_sleep)
+        except KeyboardInterrupt:
+            _observer.stop()
+        _observer.join()

ut_wdp-1.0.0.20250816.dist-info/METADATA

@@ -0,0 +1,778 @@
+Metadata-Version: 2.4
+Name: ut_wdp
+Version: 1.0.0.20250816
+Summary: Utilities for Watchdog Processors
+Author-email: Bernd Stroehle <bernd.stroehle@gmail.com>
+Maintainer-email: Bernd Stroehle <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/bs2910/ut_wdp/tree/master
+Project-URL: Homepage, https://kosakya.de/
+Project-URL: Documentation, https://ut_wdp.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
+Requires-Python: >=3.10
+Description-Content-Type: text/x-rst
+License-File: LICENSE.txt
+Requires-Dist: ut_ctl>=1.0.0.20250711
+Requires-Dist: ut_dic>=1.0.0.20250715
+Requires-Dist: ut_log>=1.0.0.20250715
+Requires-Dist: ut_path>=1.0.0.20250715
+Requires-Dist: watchdog>=6.0.0
+Dynamic: license-file
+
+######
+ut_wdp
+######
+
+********
+Overview
+********
+
+.. start short_desc
+
+**Watch Dog Processor 'Utilities'**
+
+.. end short_desc
+
+************
+Installation
+************
+
+.. start installation
+
+Package ``ut_wdp`` can be installed from PyPI.
+
+To install with ``pip``:
+
+.. code-block:: shell
+
+	$ python -m pip install ut_wdp
+
+.. end installation
+
+***************
+Package logging 
+***************
+
+(c.f.: **Appendix**: `Package Logging`)
+
+*************
+Package files
+*************
+
+Classification
+==============
+
+The Package ``ut_wdp`` consist of the following file types (c.f.: **Appendix**: `Python Terminology`):
+
+#. **Special files:**
+
+   a. *py.typed*
+
+#. **Special modules:**
+
+   a. *__init__.py*
+   #. *__version__.py*
+
+#. **Sub-packages**
+
+   a. **pmeh**
+
+      #. **Special files:**
+
+         a. *py.typed*
+
+      #. **Special modules:**
+      
+         a. *__init__.py*
+
+      #. **Modules**
+
+         #. modules: wdp.py
+
+Sub-package: `pmeh`
+===================
+
+Modules
+-------
+
+The Sub-package ``pmeh`` contains the following modules.
+
+  .. pmeh-Modules-label:
+  .. table:: *pmeh Modules*
+
+   +------+-------------------+
+   |Name  |Decription         |
+   +======+===================+
+   |wdp.py|Watch Dog Processor|
+   +------+-------------------+
+
+Module: wdp.py
+--------------
+
+The Module ``wdp.py`` contains the following classes:
+
+   +-------------+------+---------------------------------------------+
+   |Name         |Type  |Description                                  |
+   +=============+======+=============================================+
+   |CustomHandler|normal|Custom Handler of PatternMatchingEventHandler|
+   +-------------+------+---------------------------------------------+
+   |WdP          |static|Watch Dog Processor                          |
+   +-------------+------+---------------------------------------------+
+
+wdp.py Class: CustomHandler
+---------------------------
+
+The class ``CustomHandler`` contains the subsequent methods.
+
+CustomHandler Methods
+^^^^^^^^^^^^^^^^^^^^^
+
+  .. Methods-of-class-CustomHandler-label:
+  .. table:: *Methods of class CustomHandler*
+
+   +-----------+--------+------------------------------------------------------+
+   |Name       |Type    |Description                                           |
+   +===========+========+======================================================+
+   |__init__   |instance|Initialise class CustomHandler                        |
+   +-----------+--------+------------------------------------------------------+
+   |on_created |instance|Process event 'File. refered by file path is created' |
+   +-----------+--------+------------------------------------------------------+
+   |on_modified|instance|Process 'File referred by file path is modified' event|
+   +-----------+--------+------------------------------------------------------+
+
+wdp.py Class: WdP
+-----------------
+
+The static class ``WdP`` contains the subsequent methods.
+
+WdP Methods
+^^^^^^^^^^^
+
+  .. Methods-of-class-WdP-label:
+  .. table:: *Methods-of-class-WdP*
+
+   +----+------+-------------------------------------------------+
+   |Name|Type  |Description                                      |
+   +====+======+=================================================+
+   |pmeh|static|WatchDog Task for pattern matching of files paths|
+   +----+------+-------------------------------------------------+
+
+########
+Appendix
+########
+
+***************
+Package Logging
+***************
+
+Description
+===========
+
+Logging use the module **log.py** of the logging package **ut_log**.
+The module supports two Logging types:
+
+#. **Standard Logging** (std) or 
+#. **User Logging** (usr).
+
+The Logging type can be defined by one of the values 'std' or 'usr' of the parameter log_type; 'std' is the default.
+The different Logging types are configured by one of the following configuration files:
+
+#. **log.std.yml** or 
+#. **log.usr.yml** 
+  
+The configuration files can be stored in different configuration directories (ordered by increased priority):
+
+#. <package directory of the log package **ut_log**>/**cfg**,
+#. <package directory of the application package **ui_eviq_srr**>/**cfg**,
+#. <application directory of the application **eviq**>/**cfg**,
+
+The active configuration file is the configuration file in the directory with the highest priority.
+
+Examples
+========
+  
+Site-packages-path = **/appl/eviq/.pyenv/versions/3.11.12/lib/python3.11/site-packages**
+Log-package = **ut_log**
+Application-package = **ui_eviq_srr**
+Application-home-path = **/appl/eviq**
+  
+.. Examples-of-log-configuration-files-label:
+.. table:: **Examples of log configuration-files**
+
+   +-----------------------------------------------------------------------------------+
+   |Log Configuration                                                                  |
+   +----+-------------------+----------------------------------------------+-----------+
+   |Type|Directory Type     |Directory                                     |File       |
+   +====+===================+==============================================+===========+
+   |std |Log package        |<Site-packages-path>/<Log-package>/cfg        |log.std.yml|
+   |    +-------------------+----------------------------------------------+           |
+   |    |Application package|<Site-packages-path>/<application-package>/cfg|           |
+   |    +-------------------+----------------------------------------------+           |
+   |    |Application        |<application-home-path>/cfg                   |           |
+   +----+-------------------+----------------------------------------------+-----------+
+   |usr |Log package        |<site-packages-path>/ut_log/cfg               |log.usr.yml|
+   |    +-------------------+----------------------------------------------+           |
+   |    |Application package|<site-packages-path>/ui_eviq_srr/cfg          |           |
+   |    +-------------------+----------------------------------------------+           |
+   |    |Application        |<application-path>/cfg                        |           |
+   +----+-------------------+----------------------------------------------+-----------+
+
+Log message types
+=================
+
+Logging defines log file path names for the following log message types: .
+
+#. *debug*
+#. *info*
+#. *warning*
+#. *error*
+#. *critical*
+
+Log types 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  |
+   +--------+-----+--------+------+
+
+Application parameter for logging
+---------------------------------
+
+.. Application-parameter-used-in-log-naming-label:
+.. table:: *Application parameter used in log naming*
+
+   +-----------------+--------------+-----+------------------+-------+-----------+
+   |Name             |Decription    |Value|Description       |Default|Example    |
+   +=================+==============+=====+==================+=======+===========+
+   |appl_data        |data directory|     |                  |       |/data/eviq |
+   +-----------------+--------------+-----+------------------+-------+-----------+
+   |tenant           |tenant name   |UMH  |                  |       |UMH        |
+   +-----------------+--------------+-----+------------------+-------+-----------+
+   |package          |package name  |     |                  |       |ui_eviq_srr|
+   +-----------------+--------------+-----+------------------+-------+-----------+
+   |cmd              |command       |     |                  |       |evupreg    |
+   +-----------------+--------------+-----+------------------+-------+-----------+
+   |log_type         |Logging Type  |std: |Standard logging  |std    |std        |
+   |                 |              +-----+------------------+       |           |
+   |                 |              |usr: |User Logging      |       |           |
+   +-----------------+--------------+-----+------------------+-------+-----------+
+   |log_ts_type      |Logging       |ts:  |Sec since 1.1.1970|ts     |ts         |
+   |                 |timestamp     +-----+------------------+       |           |
+   |                 |type          |dt:  |Datetime          |       |           |
+   +-----------------+--------------+-----+------------------+-------+-----------+
+   |log_sw_single_dir|Use single log|True |use single dir.   |True   |True       |
+   |                 |directory     +-----+------------------+       |           |
+   |                 |              |False|use muliple dir.  |       |           |
+   +-----------------+--------------+-----+------------------+-------+-----------+
+
+Log files naming
+----------------
+
+Naming Conventions (table format)
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+.. Naming-conventions-for-logging-file-paths-label:
+.. table:: *Naming conventions for logging file paths*
+
+   +--------+----------------------------------------------+-------------------+
+   |Type    |Directory                                     |File               |
+   +========+==============================================+===================+
+   |debug   |/<appl_data>/<tenant>/RUN/<package>/<cmd>/debs|debs_<ts>_<pid>.log|
+   +--------+----------------------------------------------+-------------------+
+   |critical|/<appl_data>/<tenant>/RUN/<package>/<cmd>/logs|crts_<ts>_<pid>.log|
+   +--------+----------------------------------------------+-------------------+
+   |error   |/<appl_data>/<tenant>/RUN/<package>/<cmd>/logs|errs_<ts>_<pid>.log|
+   +--------+----------------------------------------------+-------------------+
+   |info    |/<appl_data>/<tenant>/RUN/<package>/<cmd>/logs|infs_<ts>_<pid>.log|
+   +--------+----------------------------------------------+-------------------+
+   |warning |/<appl_data>/<tenant>/RUN/<package>/<cmd>/logs|rnsg_<ts>_<pid>.log|
+   +--------+----------------------------------------------+-------------------+
+
+Naming Conventions (tree format)
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+::
+
+ <appl_data>   Application data folder
+ │
+ └── <tenant>  Application tenant folder
+     │
+     └── RUN  Applications RUN folder for Application log files
+         │
+         └── <package>  RUN folder of Application package: <package>
+             │
+             └── <cmd>  RUN folder of Application command <cmd>
+                 │
+                 ├── debs  Application command debug messages folder
+                 │   │
+                 │   └── debs_<ts>_<pid>.log  debug messages for
+                 │                            run of command <cmd>
+                 │                            with pid <pid> at <ts>
+                 │
+                 └── logs  Application command log messages folder
+                     │
+                     ├── crts_<ts>_<pid>.log  critical messages for
+                     │                        run of command <cmd>
+                     │                        with pid <pid> at <ts>
+                     ├── errs_<ts>_<pid>.log  error messages for
+                     │                        run of command <cmd>
+                     │                        with pid <pid> at <ts>
+                     ├── infs_<ts>_<pid>.log  info messages for
+                     │                        run of command <cmd>
+                     │                        with pid <pid> at <ts>
+                     └── wrns_<ts>_<pid>.log  warning messages for
+                                              run of command <cmd>
+                                              with pid <pid> at <ts>
+
+Naming Examples (table format)
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+.. Naming-conventions-for-logging-file-paths-label:
+.. table:: *Naming conventions for logging file paths*
+
+   +--------+--------------------------------------------+--------------------------+
+   |Type    |Directory                                   |File                      |
+   +========+============================================+==========================+
+   |debug   |/appl/eviq/UMH/RUN/ui_eviq_srr/evdomap/debs/|debs_1750096540_354710.log|
+   +--------+--------------------------------------------+--------------------------+
+   |critical|/appl/eviq/UMH/RUN/ui_eviq_srr/evdomap/logs/|crts_1749971151_240257.log|
+   +--------+                                            +--------------------------+
+   |error   |                                            |errs_1749971151_240257.log|
+   +--------+                                            +--------------------------+
+   |info    |                                            |infs_1750096540_354710.log|
+   +--------+                                            +--------------------------+
+   |warning |                                            |wrns_1749971151_240257.log|
+   +--------+--------------------------------------------+--------------------------+
+
+Naming Examples (tree format)
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+.. code-block:: text
+
+  /data/eviq/UMH/RUN/ui_eviq_srr/evdomap  Run folder of
+  │                                       of function evdomap
+  │                                       of package ui_eviq_srr
+  │                                       for teanant UMH
+  │                                       of application eviq
+  │
+  ├── debs  debug folder of Application function: evdomap
+  │   │
+  │   └── debs_1748609414_314062.log  debug messages for run 
+  │                                   of function evdomap     
+  │                                   using pid: 314062 at: 1748609414
+  │
+  └── logs  log folder of Application function: evdomap
+      │
+      ├── errs_1748609414_314062.log  error messages for run
+      │                               of function evdomap     
+      │                               with pid: 314062 at: 1748609414
+      ├── infs_1748609414_314062.log  info messages for run
+      │                               of function evdomap     
+      │                               with pid: 314062 at: 1748609414
+      └── wrns_1748609414_314062.log  warning messages for run
+                                      of function evdomap     
+                                      with pid: 314062 at: 1748609414
+
+Configuration files
+===================
+
+log.std.yml (jinja2 yml file)
+-----------------------------
+
+Content
+^^^^^^^
+
+.. log.std.yml-label:
+.. code-block:: jinja
+
+ version: 1
+
+ disable_existing_loggers: False
+
+ loggers:
+
+     # standard logger
+     std:
+         # level: NOTSET
+         level: DEBUG
+         handlers:
+             - std_debug_console
+             - std_debug_file
+             - std_info_file
+             - std_warning_file
+             - std_error_file
+             - std_critical_file
+
+ handlers:
+ 
+     std_debug_console:
+         class: 'logging.StreamHandler'
+         level: DEBUG
+         formatter: std_debug
+         stream: 'ext://sys.stderr'
+
+     std_debug_file:
+         class: 'logging.FileHandler'
+         level: DEBUG
+         formatter: std_debug
+         filename: '{{dir_run_debs}}/debs_{{ts}}_{{pid}}.log'
+         mode: 'a'
+         delay: true
+
+     std_info_file:
+         class: 'logging.FileHandler'
+         level: INFO
+         formatter: std_info
+         filename: '{{dir_run_infs}}/infs_{{ts}}_{{pid}}.log'
+         mode: 'a'
+         delay: true
+
+     std_warning_file:
+         class: 'logging.FileHandler'
+         level: WARNING
+         formatter: std_warning
+         filename: '{{dir_run_wrns}}/wrns_{{ts}}_{{pid}}.log'
+         mode: 'a'
+         delay: true
+
+     std_error_file:
+         class: 'logging.FileHandler'
+         level: ERROR
+         formatter: std_error
+         filename: '{{dir_run_errs}}/errs_{{ts}}_{{pid}}.log'
+         mode: 'a'
+         delay: true
+ 
+     std_critical_file:
+         class: 'logging.FileHandler'
+         level: CRITICAL
+         formatter: std_critical
+         filename: '{{dir_run_crts}}/crts_{{ts}}_{{pid}}.log'
+         mode: 'a'
+         delay: true
+
+     std_critical_mail:
+         class: 'logging.handlers.SMTPHandler'
+         level: CRITICAL
+         formatter: std_critical_mail
+         mailhost : localhost
+         fromaddr: 'monitoring@domain.com'
+         toaddrs:
+             - 'dev@domain.com'
+             - 'qa@domain.com'
+         subject: 'Critical error with application name'
+ 
+ formatters:
+
+     std_debug:
+         format: '%(asctime)-15s %(levelname)s-%(name)s-%(process)d::%(module)s.%(funcName)s|%(lineno)s:: %(message)s'
+         datefmt: '%Y-%m-%d %H:%M:%S'
+     std_info:
+         format: '%(asctime)-15s %(levelname)s-%(name)s-%(process)d::%(module)s.%(funcName)s|%(lineno)s:: %(message)s'
+         datefmt: '%Y-%m-%d %H:%M:%S'
+     std_warning:
+         format: '%(asctime)-15s %(levelname)s-%(name)s-%(process)d::%(module)s.%(funcName)s|%(lineno)s:: %(message)s'
+         datefmt: '%Y-%m-%d %H:%M:%S'
+     std_error:
+         format: '%(asctime)-15s %(levelname)s-%(name)s-%(process)d::%(module)s.%(funcName)s|%(lineno)s:: %(message)s'
+         datefmt: '%Y-%m-%d %H:%M:%S'
+     std_critical:
+         format: '%(asctime)-15s %(levelname)s-%(name)s-%(process)d::%(module)s.%(funcName)s|%(lineno)s:: %(message)s'
+         datefmt: '%Y-%m-%d %H:%M:%S'
+     std_critical_mail:
+         format: '%(asctime)-15s %(levelname)s-%(name)s-%(process)d::%(module)s.%(funcName)s|%(lineno)s:: %(message)s'
+         datefmt: '%Y-%m-%d %H:%M:%S'
+
+Jinja2-variables
+^^^^^^^^^^^^^^^^
+
+.. log.std.yml-Jinja2-variables-label:
+.. table:: *log.std.yml Jinja2 variables*
+
+   +------------+-----------------------------+-------------------------------------------+
+   |Name        |Definition                   |Example                                    |
+   +============+=============================+===========================================+
+   |dir_run_debs|debug run directory          |/data/eviq/UMH/RUN/ui_eviq_srr/evupreg/debs|
+   +------------+-----------------------------+-------------------------------------------+
+   |dir_run_infs|info run directory           |/data/eviq/UMH/RUN/ui_eviq_srr/evupreg/logs|
+   +------------+-----------------------------+                                           |
+   |dir_run_wrns|warning run directory        |                                           |
+   +------------+-----------------------------+                                           |
+   |dir_run_errs|error run directory          |                                           |
+   +------------+-----------------------------+                                           |
+   |dir_run_crts|critical error run directory |                                           |
+   +------------+-----------------------------+-------------------------------------------+
+   |ts          |Timestamp since 1970 in [sec]|1749483509                                 |
+   |            |if log_ts_type == 'ts'       |                                           |
+   |            +-----------------------------+-------------------------------------------+
+   |            |Datetime in timezone Europe/ |20250609 17:38:29 GMT+0200                 |
+   |            |Berlin if log_ts_type == 'dt'|                                           |
+   +------------+-----------------------------+-------------------------------------------+
+   |pid         |Process ID                   |79133                                      |
+   +------------+-----------------------------+-------------------------------------------+
+
+***************
+Python Glossary
+***************
+
+.. _python-modules:
+
+Python Modules
+==============
+
+Overview
+--------
+
+  .. Python-Modules-label:
+  .. table:: *Python Modules*
+
+   +--------------+---------------------------------------------------------+
+   |Name          |Definition                                               |
+   +==============+==========+==============================================+
+   |Python modules|Files with suffix ``.py``; they could be empty or contain|
+   |              |python code; other modules can be imported into a module.|
+   +--------------+---------------------------------------------------------+
+   |special Python|Modules like ``__init__.py`` or ``main.py`` with special |
+   |modules       |names and functionality.                                 |
+   +--------------+---------------------------------------------------------+
+
+.. _python-functions:
+
+Python Function
+===============
+
+Overview
+--------
+
+  .. Python-Function-label:
+  .. table:: *Python Function*
+
+   +---------------+---------------------------------------------------------+
+   |Name           |Definition                                               |
+   +===============+==========+==============================================+
+   |Python function|Files with suffix ``.py``; they could be empty or contain|
+   |               |python code; other modules can be imported into a module.|
+   +---------------+---------------------------------------------------------+
+   |special Python |Modules like ``__init__.py`` or ``main.py`` with special |
+   |modules        |names and functionality.                                 |
+   +---------------+---------------------------------------------------------+
+
+.. _python-packages:
+
+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, sub packages, files or directories. |
+   +---------------------+---------------------------------------------+
+   |Python sub-package   |Python sub-packages are python packages which|
+   |                     |are contained in another python package.     |
+   +---------------------+---------------------------------------------+
+   |Python package       |directory contained in a python package.     |
+   |sub-directory        |                                             |
+   +---------------------+---------------------------------------------+
+   |Python package       |Python package sub-directories with a special|
+   |special sub-directory|meaning like data or cfg                     |
+   +---------------------+---------------------------------------------+
+
+Special python package sub-directories
+--------------------------------------
+
+  .. Special-python-package-sub-directory-Examples-label:
+  .. table:: *Special python package 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-files:
+
+Python Files
+============
+
+Overview
+--------
+
+  .. Python-files-label:
+  .. table:: *Python files*
+
+   +--------------+---------------------------------------------------------+
+   |Name          |Definition                                               |
+   +==============+==========+==============================================+
+   |Python modules|Files with suffix ``.py``; they could be empty or contain|
+   |              |python code; other modules can be imported into a module.|
+   +--------------+---------------------------------------------------------+
+   |Python package|Files within a python package.                           |
+   |files         |                                                         |
+   +--------------+---------------------------------------------------------+
+   |Python dunder |Python modules which are named with leading and trailing |
+   |modules       |double underscores.                                      |
+   +--------------+---------------------------------------------------------+
+   |special       |Files which are not modules and used as python marker    |
+   |Python files  |files like ``py.typed``.                                 |
+   +--------------+---------------------------------------------------------+
+   |special Python|Modules like ``__init__.py`` or ``main.py`` with special |
+   |modules       |names and functionality.                                 |
+   +--------------+---------------------------------------------------------+
+
+.. _python-special-files:
+
+Python Special Files
+--------------------
+
+  .. Python-special-files-label:
+  .. table:: *Python special 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   |
+   |        |file    |way to package and distribute type information in Python.     |
+   +--------+--------+--------------------------------------------------------------+
+
+.. _python-special-modules:
+
+Python Special Modules
+----------------------
+
+  .. Python-special-modules-label:
+  .. table:: *Python special 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   |
+   |              |marker     |as a package. The Module enforces explicit imports and thus     |
+   |              |file       |clear namespace use and call them with the dot notation.        |
+   +--------------+-----------+----------------------------------------------------------------+
+   |__main__.py   |entry point|The dunder module ``__main__.py`` serves as package entry point |
+   |              |for the    |point. The module is executed when the package is called by the |
+   |              |package    |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 classes
+==============
+
+Overview
+--------
+
+  .. Python-classes-overview-label:
+  .. table:: *Python classes overview*
+
+   +-------------------+---------------------------------------------------+
+   |Name               |Description                                        |
+   +===================+===================================================+
+   |Python class       |A class is a container to group related methods and|
+   |                   |variables together, even if no objects are created.|
+   |                   |This helps in organizing code logically.           |
+   +-------------------+---------------------------------------------------+
+   |Python static class|A class which contains only @staticmethod or       |
+   |                   |@classmethod methods and no instance-specific      |
+   |                   |attributes or methods.                             |
+   +-------------------+---------------------------------------------------+
+
+Python methods
+==============
+
+Overview
+--------
+
+  .. Python-methods-overview-label:
+  .. table:: *Python methods overview*
+
+   +--------------+-------------------------------------------+
+   |Name          |Description                                |
+   +==============+===========================================+
+   |Python method |Python functions defined in python modules.|
+   +--------------+-------------------------------------------+
+   |Python class  |Python functions defined in python classes.|
+   |method        |                                           |
+   +--------------+-------------------------------------------+
+   |Python special|Python class methods with special names and|
+   |class method  |functionalities.                           |
+   +--------------+-------------------------------------------+
+
+Python class methods
+--------------------
+
+  .. Python-class-methods-label:
+  .. table:: *Python class methods*
+
+   +--------------+----------------------------------------------+
+   |Name          |Description                                   |
+   +==============+==============================================+
+   |Python no     |Python function defined in python classes and |
+   |instance      |decorated with @classmethod or @staticmethod. |
+   |class method  |The first parameter conventionally called cls |
+   |              |is a reference to the current class.          |
+   +--------------+----------------------------------------------+
+   |Python        |Python function defined in python classes; the|
+   |instance      |first parameter conventionally called self is |
+   |class method  |a reference to the current class object.      |
+   +--------------+----------------------------------------------+
+   |special Python|Python class functions with special names and |
+   |class method  |functionalities.                              |
+   +--------------+----------------------------------------------+
+
+Python special class methods
+----------------------------
+
+  .. Python-methods-examples-label:
+  .. table:: *Python methods examples*
+
+   +--------+-----------+--------------------------------------------------------------+
+   |Name    |Type       |Description                                                   |
+   +========+===========+==============================================================+
+   |__init__|class      |The special method ``__init__`` is called when an instance    |
+   |        |object     |(object) of a class is created; instance attributes can be    |
+   |        |constructor|defined and initalized in the method. The method us a single  |
+   |        |method     |parameter conventionally called ``self`` to access the object.|
+   +--------+-----------+--------------------------------------------------------------+
+
+#################
+Table of Contents
+#################
+
+.. contents:: **Table of Content**

ut_wdp-1.0.0.20250816.dist-info/RECORD

@@ -0,0 +1,10 @@
+ut_wdp/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+ut_wdp/__version__.py,sha256=1F5SgsDkL0Wsfv--aIg60TX07Musv5-mfJBDUhyopZg,855
+ut_wdp/pmeh/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+ut_wdp/pmeh/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+ut_wdp/pmeh/wdp.py,sha256=5e4pZ6ULoikpW39xSeXIKROacnzQjnlDMHP60G7-F7I,4821
+ut_wdp-1.0.0.20250816.dist-info/licenses/LICENSE.txt,sha256=J_iuINKTDamw5ae3f9kSe4pHFmUHQAn8FL_bWQfJgcg,850
+ut_wdp-1.0.0.20250816.dist-info/METADATA,sha256=mW2F6YKiGY6lEYfRyl3-F4_vJDIrSHTy1-PovO4XII4,32687
+ut_wdp-1.0.0.20250816.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+ut_wdp-1.0.0.20250816.dist-info/top_level.txt,sha256=8DGyc0kJPvjla4PLttEyuCBMSXkHz3y_18J9ri0ca0k,7
+ut_wdp-1.0.0.20250816.dist-info/RECORD,,

ut_wdp-1.0.0.20250816.dist-info/WHEEL

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

ut_wdp-1.0.0.20250816.dist-info/licenses/LICENSE.txt

@@ -0,0 +1,19 @@
+#
+# Copyright (c) 2022 Kosakya, GmbH. All rights reserved.
+#
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more detail.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program.  If not, see <http://www.gnu.org/licenses/>.
+#
+# Person:           		Role:           Email:
+# Bernd Stroehle            Author          bernd.stroehle@kosakya.de
+#                           Maintainer

ut_wdp-1.0.0.20250816.dist-info/top_level.txt

@@ -0,0 +1 @@
+ut_wdp