Path Utilities
Package ka_uts_path can be installed from PyPI or Anaconda.
To install with pip:
$ python -m pip install ka_uts_path
To install with conda:
$ conda install -c conda-forge ka_uts_path
(c.f.: Appendix: Package Logging)
The Package ka_uts_path consist of the following file types (c.f.: Appendix):
The Module Type Modules for Management of Array of Paths contains the following Modules:
Array of Paths Management Rodules Name Description aododopath.py Management of Array of Dictionaries of Dictionaries of Paths. aopath.py Management of Array of Paths.
The Module aopath.py contains the static Classes AoPath.
The static Class AoPath is used to manage Array of Paths; it contains the subsequent methods.
AoPath Methods Name Description join Join array of paths using the os separator mkdirs Make directories show functions sh_a_path Show array of paths for path template. sh_a_path_by_tpl Convert array of path template keys and kwargs Rto array of paths. sh_aopath_by_gl-ob sh_aopath_by_pac sh_aopath_mtime_gt sh_path_by_tpl_first_exist yield functions yield_path_kwargs_over_path yield_path_kwargs_over_dir_path yield_path_item_kwargs_over_path_arr
Parameter of: AoPath Method: join Name Type Default Description aopath TyAoPath array of paths
Return Value of: AoPath Method: join Name Type Description path TyPath Path
Convert path template to array of paths using glob function of module glob.py.
Parameter of: AoPath Method: sh_a_path Name Type Default Description path TyPath Path
Return Value of: AoPath Method: sh_a_path Name Type Description a_path TyAoPath Array of paths
Parameter of: AoPath Method: sh_a_path_by_tmpl Name Type Default Description a_path_tmpl_key TyAoPath array of path template keys kwargs TyDic keyword arguments
Return Value of: AoPath Method: sh_a_path_by_tmpl Name Type Default Description a_path TyAoPath Path
Parameter of: AoPath Method: yield_path_kwargs Name Type Default Description cls Tyclass current class a_path_tmpl_key TyAoPath array of path template keys kwargs TyDic keyword arguments
Return Value of: AoPath Method: yield_path_kwargs Name Type Description (path, kwargs) TyAoPath Path
sh_a_path_by_tmpl(a_path_tmpl_key, kwargs)
Parameter of: AoPath Method: yield_path_kwargs_new Name Type Default Description cls Tyclass Current class a_dir_tmpl_key TyAoPath Array of path template keys a_path_tmpl_key TyAoPath Array of path template keys sh_kwargs_new TyAoPath Show new keyword arguments function kwargs TyDic Keyword arguments
Return Value of: AoPath Method: yield_path_kwargs_new Name Type Description (path, kwargs_new) TyAoPath Path, new keyword arguments
Parameter of: AoPath Method: yield_path_item_kwargs Name Type Default Description cls Tyclass current class a_path_tmpl_key TyAoPath array of path template keys a_arr_key TyAoPath array of path template keys kwargs TyDic keyword arguments
Return Value of: AoPath Method: yield_path_item_kwargs Name Type Description (path, item, kwargs) TyAoPath Path, Item, keyword arguments
Parameter of: AoPath Method: yield_path_item_kwargs_new Name Type Default Description cls Tyclass current class a_dir_tmpl_key TyAoPath array of path template keys a_path_tmpl_key TyAoPath array of path template keys sh_kwargs_new TyAoPath show new keyword arguments function kwargs TyDic keyword arguments
Return Value of: AoPath Method: yield_path_item_kwargs_new Name Type Description (path, item, kwargs_new) TyAoPath Path, Item, new keyword arguments
The Module Type Modules for Management of Dictionary of Paths contains the following Modules:
Dictionaries of Paths Management Modules Name Description dodopath.py Management of Dictionary of Dictionaries of Paths. dopath.py Management of Dictionary of Paths.
The Module dodoath.py contains the static Classes DoDoPath.
The static Class DoDoPath is used to manage Dictionary of Dictionaries of Paths; it contains the subsequent methods.
DoDoPath Methods Name Description sh_path Show Path.
Module: dopath.py ==========-======
The Module doath.py contains the static Classes DoPath.
The static Class DoPath is used to manage Dictionary of Paths; it contains the subsequent methods.
DoDoPath Methods Name Description sh_path Show Path.
The Standard or user specifig logging is carried out by the log.py module of the logging package ka_uts_log using the standard- or user-configuration files in the logging package configuration directory:
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:
Logging defines log file path names for the following log message types: .
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
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 logging files|ts, dt ts, dt' ts log_sw_single_dir Enable single log directory or multiple log directories True, False True
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
Naming examples for logging file paths 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 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 sub-directory directory contained in a python package. Python package special sub-directory Python package sub-directories with a special meaning like data or cfg
Python Package sub-directory-Examples 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 overview files Name Definition Python package files Files within a python package. Special python package files Package files which are not modules and used as python and used as python marker files like __init__.py. Python package module Files with suffix .py; they could be empty or contain python code; other modules can be imported into a module. Special python package module Modules like __init__.py or main.py with special names and functionality.
Python package examples 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. __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 methods overview 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
Python methods examples 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.