ka-uts-com 2.0.0.250407__py3-none-any.whl → 2.1.1.250415__py3-none-any.whl

build/lib/ka_uts_com/utils/str.py

@@ -1,265 +0,0 @@
-# coding=utf-8
-from typing import Any
-import traceback
-
-from datetime import datetime
-import re
-import orjson
-import simplejson
-
-TyArr = list[Any]
-TyDic = dict[Any, Any]
-TyAoA = list[TyArr]
-
-TnInt = None | int
-TnFloat = None | float
-TnStr = None | str
-TnAoA = None | TyAoA
-TnArr = None | TyArr
-TnDic = None | TyDic
-TnDatetime = None | datetime
-
-
-class Str:
-    """ Manage String Class
-    """
-    @staticmethod
-    def sh_date(string: str, fmt: TnStr = None) -> TnDatetime:
-        """ show string as date using the format string
-        """
-        try:
-            if fmt is None:
-                fmt = "%m/%d/%Y"
-            _date: TnDatetime = datetime.strptime(string, fmt)
-            return _date
-        except Exception:
-            print(traceback.format_exc())
-            return None
-
-    @staticmethod
-    def lchop(string: str, prefix: str) -> str:
-        """ return substring of string which starts at the
-            end of the contained prefix
-        """
-        if string.startswith(prefix):
-            return string[len(prefix):]
-        return string
-
-    @staticmethod
-    def rchop(string: str, suffix: str) -> str:
-        """ return substring of string which ends at the
-            beginning of the contained suffix
-        """
-        if suffix and string.endswith(suffix):
-            return string[:-len(suffix)]
-        return string
-
-    @staticmethod
-    def strip_multiple_chars(string: str, chars: str) -> str:
-        """ replace multiple characters in string
-        """
-        return string.translate(str.maketrans("", "", chars))
-
-    @staticmethod
-    def is_odd(string: str) -> bool:
-        """ check if string is odd number
-        """
-        if string.isnumeric():
-            if int(string) % 2 == 0:
-                return False
-            return True
-        return False
-
-    @staticmethod
-    def is_integer(string: str) -> bool:
-        """ check if string is integer
-        """
-        if string[0] in ('-', '+'):
-            return string[1:].isdigit()
-        return string.isdigit()
-
-    @staticmethod
-    def is_boolean(string: str) -> bool:
-        """ check if string is boolean
-        """
-        if string.strip().lower() in ['true', 'false']:
-            return True
-        return False
-
-    @staticmethod
-    def is_undefined(string: TnStr) -> bool:
-        """ check if string is undefined (None or empty)
-        """
-        if string is None or string == '':
-            return True
-        return False
-
-    @staticmethod
-    def nvl(string: TnStr) -> TnStr:
-        """ nvl function similar to SQL NVL function
-        """
-        if string is None:
-            return ''
-        return string
-
-    @staticmethod
-    def strip_n(string: str) -> str:
-        """ Replace new line characters by Blanks and strip Blanks
-        """
-        return string.replace('\n', ' ').strip()
-
-    @staticmethod
-    def remove(string: str, a_to_remove: TyArr) -> str:
-        """ remove all character of a list
-        """
-        for to_remove in a_to_remove:
-            string = string.replace(to_remove, '')
-        return string
-
-    @staticmethod
-    def sh_boolean(string: str) -> bool:
-        """ Show string as boolean if string is a boolean
-        """
-        match string.lower():
-            case 'true':
-                return True
-            case 'false':
-                return False
-            case _:
-                raise ValueError
-
-    @staticmethod
-    def sh_float(string: str) -> TnFloat:
-        """ Returns Float if string is of Type Float
-            otherwise None
-        """
-        try:
-            return float(string)
-        except Exception:
-            print(traceback.format_exc())
-            return None
-
-    @staticmethod
-    def sh_int(string: str) -> TnInt:
-        """ Returns Int if string is of Type Int
-            otherwise None
-        """
-        try:
-            return int(string)
-        except ValueError:
-            return None
-
-    @staticmethod
-    def sh_dic(string: str, sw_decimal=False) -> Any:
-        """ Returns Dic if string is of Type Json-String
-            otherwise None
-        """
-        try:
-            if sw_decimal:
-                return simplejson.loads(string, use_decimal=True)
-            else:
-                return orjson.loads(string)
-        except Exception:
-            print(traceback.format_exc())
-            return None
-
-    @staticmethod
-    def sh_arr(string: str) -> Any:
-        """ Show valid Array string as Array
-        """
-        try:
-            return orjson.loads(string)
-        except Exception:
-            print(traceback.format_exc())
-            return None
-
-    @staticmethod
-    def sh_aoa(string: str) -> Any:
-        """ Show valid Array string as Array
-        """
-        try:
-            return orjson.loads(string)
-        except Exception:
-            print(traceback.format_exc())
-            return None
-
-    @staticmethod
-    def sh_first_item(string: str) -> Any:
-        """ Show first substring of string
-        """
-        return string.split()[0]
-
-    @classmethod
-    def sh_a_int(cls, string: str, sep: str) -> TyArr:
-        """ Show first substring of string
-        """
-        # arr = string.split(sep)
-        arr = re.split(sep, string)
-        arr_new = []
-        for item in arr:
-            _item = item.strip()
-            if not isinstance(_item, str):
-                continue
-            if not _item.isdigit():
-                continue
-            arr_new.append(cls.sh_int(_item))
-        return arr_new
-
-    @classmethod
-    def sh_a_str(
-            cls, string: str, sep: str, a_exclude: TnArr = None) -> Any:
-        """ Show first substring of string
-        """
-        # arr = string.split(sep)
-        arr = re.split(sep, string)
-
-        if a_exclude is None:
-            _arr = arr
-        else:
-            _arr = []
-            for item in arr:
-                _item = item.strip()
-                if _item not in a_exclude:
-                    _arr.append(_item)
-
-        arr_new = []
-        for item in _arr:
-            if isinstance(item, str):
-                arr_new.append(item.strip())
-            elif isinstance(item, int):
-                arr_new.append(str(item))
-            else:
-                arr_new.append(item)
-
-        return arr_new
-
-    @classmethod
-    def sh_a_obj(
-            cls, string: str, sep: str, a_exclude: TnArr = None) -> Any:
-        """ Show first substring of string
-        """
-        # arr = string.split(sep)
-        arr = re.split(sep, string)
-
-        if a_exclude is None:
-            _arr = arr
-        else:
-            _arr = []
-            for item in arr:
-                _item = item.strip()
-                if _item not in a_exclude:
-                    _arr.append(_item)
-
-        arr_new: TyArr = []
-        for item in _arr:
-            if isinstance(item, str):
-                _item = item.strip()
-                if _item.isdigit():
-                    _item = cls.sh_int(_item)
-                    arr_new.append(_item)
-                else:
-                    arr_new.append(_item)
-            else:
-                arr_new.append(item)
-
-        return arr_new

ka_uts_com/base/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/base/log_.py

@@ -1,131 +0,0 @@
-# coding=utf-8
-from collections.abc import Callable
-from typing import Any
-
-import os
-import logging
-import logging.config
-from logging import Logger
-from datetime import datetime
-import psutil
-
-# from ka_uts_com.com import Com
-from ka_uts_com.ioc.jinja2_ import Jinja2_
-
-TyAny = Any
-TyCallable = Callable[..., Any]
-TyDateTime = datetime
-TyTimeStamp = int
-TyArr = list[Any]
-TyBool = bool
-TyDic = dict[Any, Any]
-TyDir = str
-TyPath = str
-TyLogger = Logger
-
-TnAny = None | Any
-TnArr = None | TyArr
-TnBool = None | bool
-TnDic = None | TyDic
-TnTimeStamp = None | TyTimeStamp
-TnDateTime = None | TyDateTime
-
-
-class Log_:
-
-    sw_init: bool = False
-    log: TyLogger = logging.getLogger('dummy_logger')
-    username: str = psutil.Process().username()
-
-    @classmethod
-    def sh_dir_run(cls, com) -> TyDir:
-        """Show run_dir
-        """
-        # print(f"sh_dir_run com.dir_dat = {com.dir_dat}")
-        # print(f"sh_dir_run com.cmd = {com.cmd}")
-        # print(f"sh_dir_run com.tenant = {com.tenant}")
-        # print(f"sh_dir_run com = {com}")
-        dir_dat: str = com.dir_dat
-        tenant: str = com.tenant
-        cmd: str = com.cmd
-        package: str = com.d_app_pacmod['package']
-        # module: str = com.d_app_pacmod['module']
-        if tenant is not None:
-            path = f"{dir_dat}/{tenant}/RUN/{package}"
-        else:
-            path = f"{dir_dat}/RUN/{package}"
-        if com.log_type == "usr":
-            path = f"{path}/{cls.username}"
-        if cmd is not None:
-            path = f"{path}/{cmd}"
-        # print(f"sh_dir_run path = {path}")
-        # print("==================================")
-        return path
-
-    @classmethod
-    def sh_d_log_cfg(cls, com, **kwargs) -> TyDic:
-        """Read log file path with jinja2
-        """
-        dir_run = cls.sh_dir_run(com)
-        if kwargs.get('sw_single_dir_run', True):
-            # print("---sw_single_dir_run = True --------------")
-            dir_run_errs = f"{dir_run}/logs"
-            dir_run_wrns = f"{dir_run}/logs"
-            dir_run_infs = f"{dir_run}/logs"
-            dir_run_logs = f"{dir_run}/logs"
-            dir_run_debs = f"{dir_run}/logs"
-            if kwargs.get('sw_mk_dir_run', True):
-                os.makedirs(dir_run_logs, exist_ok=True)
-        else:
-            # print("---sw_single_dir_run = False -------------")
-            dir_run_errs = f"{dir_run}/errs"
-            dir_run_wrns = f"{dir_run}/wrns"
-            dir_run_infs = f"{dir_run}/infs"
-            dir_run_logs = f"{dir_run}/logs"
-            dir_run_debs = f"{dir_run}/debs"
-            if kwargs.get('sw_mk_dir_run', True):
-                os.makedirs(dir_run_errs, exist_ok=True)
-                os.makedirs(dir_run_wrns, exist_ok=True)
-                os.makedirs(dir_run_infs, exist_ok=True)
-                os.makedirs(dir_run_logs, exist_ok=True)
-                os.makedirs(dir_run_debs, exist_ok=True)
-        # path_log_cfg: TyPath = PacMod.sh_path_log_cfg(com)
-        module = com.d_app_pacmod['module']
-        # print(f"sh_d_log_cfg cls.path_log_cfg = {cls.path_log_cfg}")
-        d_log_cfg: TyDic = Jinja2_.read(
-                com.path_log_cfg, com.Log,
-                dir_run_errs=dir_run_errs,
-                dir_run_wrns=dir_run_wrns,
-                dir_run_infs=dir_run_infs,
-                dir_run_logs=dir_run_logs,
-                dir_run_debs=dir_run_debs,
-                module=module,
-                pid=com.pid,
-                ts=com.ts)
-        # print(f"sh_d_log_cfg d_log_cfg = {d_log_cfg}")
-        sw_debug: TyBool = kwargs.get('sw_debug', False)
-        if sw_debug:
-            level = logging.DEBUG
-        else:
-            level = logging.INFO
-        logger_name = com.log_type
-        d_log_cfg['handlers'][f"{logger_name}_debug_console"]['level'] = level
-        d_log_cfg['handlers'][f"{logger_name}_debug_file"]['level'] = level
-
-        return d_log_cfg
-
-    @classmethod
-    def init(cls, com, **kwargs) -> None:
-        """Set static variable log level in log configuration handlers
-        """
-        cls.sw_init = True
-        d_log_cfg = cls.sh_d_log_cfg(com, **kwargs)
-        logging.config.dictConfig(d_log_cfg)
-        cls.log = logging.getLogger(com.log_type)
-
-    @classmethod
-    def sh(cls, com, **kwargs) -> TyLogger:
-        if cls.sw_init:
-            return cls.log
-        cls.init(com, **kwargs)
-        return cls.log

ka_uts_com/data/log.std.yml

@@ -1,107 +0,0 @@
-version: 1
-
-disable_existing_loggers: False
-
-# root:
-#     level: DEBUG
-#     handlers:
-#         - debug_console
-#         - debug_file
-
-loggers:
-
-    # standard logger
-    std:
-        # level: NOTSET
-        level: DEBUG
-        handlers:
-            - std_debug_console
-            - std_error_file
-            - std_warning_file
-            - std_debug_file
-            - std_info_file
-            - std_log_file
-
-handlers:
-
-    std_debug_console:
-        class: 'logging.StreamHandler'
-        level: DEBUG
-        formatter: std_debug
-        stream: 'ext://sys.stderr'
-
-#   std_info_rotating_file_handler:
-#       class: 'logging.handlers.RotatingFileHandler'
-#       level: INFO
-#       formatter: info
-#       filename: 'info.rotating.log'
-#       mode: 'a'
-#       maxBytes: 1048576  # 1MB
-#       backupCount: 10
-#       encoding: utf8
-
-    std_error_file:
-        class: 'logging.FileHandler'
-        level: ERROR
-        formatter: std_error
-        filename: '{{dir_run_errs}}/errs_{{pid}}_{{ts}}.log'
-        mode: 'a'
-
-    std_warning_file:
-        class: 'logging.FileHandler'
-        level: WARNING
-        formatter: std_warning
-        filename: '{{dir_run_wrns}}/wrns_{{pid}}_{{ts}}.log'
-        mode: 'a'
-
-    std_debug_file:
-        class: 'logging.FileHandler'
-        level: DEBUG
-        formatter: std_debug
-        filename: '{{dir_run_debs}}/debs_{{pid}}_{{ts}}.log'
-        mode: 'a'
-
-    std_info_file:
-        class: 'logging.FileHandler'
-        level: INFO
-        formatter: std_info
-        filename: '{{dir_run_infs}}/infs_{{pid}}_{{ts}}.log'
-        mode: 'a'
-
-    std_log_file:
-        class: 'logging.FileHandler'
-        level: INFO
-        formatter: std_log
-        filename: '{{dir_run_logs}}/logs_{{pid}}_{{ts}}.log'
-        mode: 'a'
-
-    std_critical_mail:
-        class: 'logging.handlers.SMTPHandler'
-        level: CRITICAL
-        formatter: std_critical
-        mailhost : localhost
-        fromaddr: 'monitoring@domain.com'
-        toaddrs:
-            - 'dev@domain.com'
-            - 'qa@domain.com'
-        subject: 'Critical error with application name'
-
-
-formatters:
-
-    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_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)s-%(levelname)s-%(name)s::%(module)s|%(lineno)s:: %(message)s'
-    std_log:
-        format: '%(asctime)s-%(levelname)s-%(name)s::%(module)s|%(lineno)s:: %(message)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'

ka_uts_com/data/log.usr.yml

@@ -1,106 +0,0 @@
-version: 1
-disable_existing_loggers: False
-
-# root:
-#     level: DEBUG
-#     handlers:
-#         - debug_console
-#         - debug_file
-
-loggers:
-
-    # user logger
-    usr:
-        # level: NOTSET
-        level: DEBUG
-        handlers:
-            - usr_debug_console
-            - usr_error_file
-            - usr_warning_file
-            - usr_debug_file
-            - usr_info_file
-            - usr_log_file
-
-handlers:
-
-    usr_debug_console:
-        class: 'logging.StreamHandler'
-        level: DEBUG
-        formatter: usr_debug
-        stream: 'ext://sys.stderr'
-
-#   person_info_rotating_file_handler:
-#       class: 'logging.handlers.RotatingFileHandler'
-#       level: INFO
-#       formatter: info
-#       filename: 'info.rotating.log'
-#       mode: 'a'
-#       maxBytes: 1048576  # 1MB
-#       backupCount: 10
-#       encoding: utf8
-
-    usr_error_file:
-        class: 'logging.FileHandler'
-        level: ERROR
-        formatter: usr_error
-        filename: '{{dir_run_errs}}/errs_{{pid}}_{{ts}}.log'
-        mode: 'a'
-
-    usr_warning_file:
-        class: 'logging.FileHandler'
-        level: ERROR
-        formatter: usr_warning
-        filename: '{{dir_run_wrns}}/wrns_{{pid}}_{{ts}}.log'
-        mode: 'a'
-
-    usr_debug_file:
-        class: 'logging.FileHandler'
-        level: DEBUG
-        formatter: usr_debug
-        filename: '{{dir_run_debs}}/debs_{{pid}}_{{ts}}.log'
-        mode: 'a'
-
-    usr_info_file:
-        class: 'logging.FileHandler'
-        level: INFO
-        formatter: usr_info
-        filename: '{{dir_run_infs}}/infs_{{pid}}_{{ts}}.log'
-        mode: 'a'
-
-    usr_log_file:
-        class: 'logging.FileHandler'
-        level: INFO
-        formatter: usr_log
-        filename: '{{dir_run_logs}}/logs_{{pid}}_{{ts}}.log'
-        mode: 'a'
-
-    usr_critical_mail:
-        class: 'logging.handlers.SMTPHandler'
-        level: CRITICAL
-        formatter: usr_critical
-        mailhost : localhost
-        fromaddr: 'monitoring@domain.com'
-        toaddrs:
-            - 'dev@domain.com'
-            - 'qa@domain.com'
-        subject: 'Critical error with application name'
-
-
-formatters:
-
-    usr_errs:
-        format: '%(asctime)-15s %(levelname)s-%(name)s-%(process)d::%(module)s.%(funcName)s|%(lineno)s:: %(message)s'
-        datefmt: '%Y-%m-%d %H:%M:%S'
-    usr_wrns:
-        format: '%(asctime)-15s %(levelname)s-%(name)s-%(process)d::%(module)s.%(funcName)s|%(lineno)s:: %(message)s'
-        datefmt: '%Y-%m-%d %H:%M:%S'
-    usr_debs:
-        format: '%(asctime)-15s %(levelname)s-%(name)s-%(process)d::%(module)s.%(funcName)s|%(lineno)s:: %(message)s'
-        datefmt: '%Y-%m-%d %H:%M:%S'
-    usr_infs:
-        format: '%(asctime)s-%(levelname)s-%(name)s::%(module)s|%(lineno)s:: %(message)s'
-    usr_logs:
-        format: '%(asctime)s-%(levelname)s-%(name)s::%(module)s|%(lineno)s:: %(message)s'
-    usr_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'

ka_uts_com/fnc.py

@@ -1,42 +0,0 @@
-# coding=utf-8
-from collections.abc import Callable
-from typing import Any
-
-TyArr = list[Any]
-TyCallable = Callable[..., Any]
-TyDic = dict[Any, Any]
-TyArrDic = TyArr | TyDic
-TyDoC = dict[str, TyCallable]
-TyMsg = str
-
-TnStr = None | str
-TnDoC = None | TyDoC
-TnCallable = None | TyCallable
-
-
-class Fnc:
-    """
-    Functions
-    """
-    @staticmethod
-    def identity(obj: Any) -> Any:
-        return obj
-
-    @staticmethod
-    def sh(doc: TnDoC, key: TnStr) -> TyCallable:
-        if not doc:
-            msg = f"function table: {doc} is not defined"
-            raise Exception(msg)
-        if not key:
-            msg = f"key: {key} is not defined"
-            raise Exception(msg)
-        fnc: TnCallable = doc.get(key)
-        if not fnc:
-            msg = f"key: {key} is not defined in function table: {doc}"
-            raise Exception(msg)
-        return fnc
-
-    @classmethod
-    def ex(cls, doc: TnDoC, key: TnStr, args_kwargs: TyArrDic) -> Any:
-        fnc: TyCallable = cls.sh(doc, key)
-        return fnc(args_kwargs)