Log Management
The package ka_uts_log can be installed from PyPI or Anaconda.
To install with pip:
$ python -m pip install ka_uts_log
To install with conda:
$ conda install -c conda-forge ka_uts_log
c.f.: Appendix: Package Logging
The Package ka_uts_log consist of the following file types (c.f.: Appendix):
Special Sub directory cfg: Files Name Description log.std.yml Yaml definition file for standard logging log.usr.yml Yaml definition file for user logging
The Package ka_uts_log contains the following modules.
ka_uts_log Modules Name Decription log.py Logging management module
The Module log.py contains the following static classes.
log.py classes Name Description LogEq Management of Log Equate message, generated from a key-, value-pair. LogDic Management of Log Equate messages, generated from the key-, value-pairs of a dictionary. Log Management of Log messages
The static Class Log contains the subsequent display- and management-methods.
Log Display Methods Name Description debug Log debug message to debug destination. info Log info message to info destination. warning Log warnning message to warning destination. error Log error message to error destination. critcial Log critical message to critical destination.
Log Management Methods Name Description init initialise current class. sh_calendar_ts Show timestamp or datetime. sh_dir_run Show run directory. sh_d_dir_run Show dictionary of run directories. sh_d_log_cfg Show log configuration directory. sh_path_log_cfg Show path of log configuration file. sh initialise and show current class.
Log method init: Parameter Name Type Description cls class current class **kwargs TyAny keyword arguments
The static Class LogEq of Module log.py contains the subsequent methods
LogEq Methods Name Description debug Log generated equate message "<key> = <value>" to the debug destination. info Log generated equate message "<key> = <value>" to the info destination. warning Log generated equate message "<key> = <value>" to the warning destination. error Log generated equate message "<key> = <value>" to the error destination. critcial Log generated equate message "<key> = <value>" to the critical destination.
All Methods use the following Parameter:
LogEq Methods parameter Name Type Description cls class current class key TyAny Key value TyAny Value
The static Class LogDic of Module log.py contains the subsequent methods
LogDic Methods Name Description debug Log generated equate messages for all dictionary entries to the debug destination. info Log generated equate messages for all dictionary entries to the info destination. warning Log generated equate messages for all dictionary entries to the warning destination. error Log generated equate messages for all dictionary entries to the error destination. critical Log generated equate messages for all dictionary entries to the critical destination.
All LogDic Methods use the following Parameters:
LogDic Methods Parameter Name Type Description cls class current class dic TyDic Dictionary
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.
Logging defines log file path names for the following log message types: .
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 loggin files ts Timestamp ts dt Datetime log_sw_single_dir Enable single log directory or multiple log directories True Bool True False Bool log_sw_pid Enable display of pid in log file name True Bool True False Bool
Single or multiple Application log directories can be used for each message type:
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
Naming conventions for logging file paths Type Directory File debug /<dir_dat>/<tenant>/RUN/<package>/<cmd>/<Log directory> <Log type>_<ts>_<pid>.log info /<dir_dat>/<tenant>/RUN/<package>/<cmd>/<Log directory> <Log type>_<ts>_<pid>.log warning /<dir_dat>/<tenant>/RUN/<package>/<cmd>/<Log directory> <Log type>_<ts>_<pid>.log error /<dir_dat>/<tenant>/RUN/<package>/<cmd>/<Log directory> <Log type>_<ts>_<pid>.log critical /<dir_dat>/<tenant>/RUN/<package>/<cmd>/<Log directory> <Log type>_<ts>_<pid>.log
The examples use the following parameter values.
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
Python package 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 sub-directories Name Definition Python package sub-directory directory contained in a python package. Special python package sub-directory Python package sub-directories with a special meaning like data or cfg.
Special python sun-directories Name Description data Directory for package data files. cfg Directory for package configuration files.
Python package files Name Definition Python package file File within a python package. Special python package file Python package file which are not modules and used as python marker files like __init__.py. Python package module File with suffix .py which could be empty or contain python code; Other modules can be imported into a module. Special python package module Python package module with special name and functionality like main.py or __init__.py.
Special python package files Name Type Description py.typed Type checking marker file The py.typed file is a marker file used in Python packages to indicate that the package supports type checking. This is a part of the PEP 561 standard, which provides a standardized way to package and distribute type information in Python.
Special Python package modules Name Type Description __init__.py Package directory marker file The dunder (double underscore) module __init__.py is used to execute initialisation code or mark the directory it contains as a package. The Module enforces explicit imports and thus clear namespace use and call them with the dot notation. __main__.py entry point for the package The dunder module __main__.py serves as an entry point for the package. The module is executed when the package is called by the interpreter with the command python -m <package name>. __version__.py Version file The dunder module __version__.py consist of assignment statements used in Versioning.
Python elements Name Definition Python method Function defined in a python module. Special python method Python method with special name and 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 Python class method with special name and functionality like init.
Special python methods Name Type Description __init__ class object constructor method The special method __init__ is called when an instance (object) of a class is created; instance attributes can be defined and initalized in the method.