ezKit 1.6.2__py3-none-any.whl → 1.7.1__py3-none-any.whl

ezKit/utils.py

@@ -1,17 +1,6 @@
 """
 Python Utils
 """
-"""
-函数
-
-- 明确 参数 和 返回值 的类型
-- 必须有返回值
-- 添加一个 debug 参数, 用于调试
-    - 如果 debug 为 True, 则输出相关信息, 否则一律不输出任何信息
-    - logger.exception(e) if v_true(debug, bool) else next
-- 必须有说明
-- 必须用 try ... except ... 包裹
-"""
 import csv
 import datetime
 import hashlib
@@ -25,7 +14,7 @@ from multiprocessing.pool import ThreadPool
 from pathlib import Path
 from shutil import rmtree
 from threading import Thread
-from typing import Callable
+from typing import Any, Callable, List, Optional, Union
 from urllib.parse import ParseResult, urlparse
 from uuid import uuid4
 
@@ -43,16 +32,15 @@ NoneType = type(None)
 
 
 def v_true(
-    v_instance: any,
-    v_type: any = None,
+    v_instance: Any,
+    v_type: Any = None,
     true_list: list | tuple | set | str | None = None,
     false_list: list | tuple | set | str | None = None,
     debug: bool = False
 ) -> bool:
     """
-    检查变量类型以及变量是否为True
-    """
-    """
+    检查变量类型以及变量是否为 True
+
     常见类型:
 
         Boolean     bool            False
@@ -63,65 +51,92 @@ def v_true(
 
     函数使用 callable(func) 判断
     """
+
     try:
+
         if isinstance(v_instance, v_type):
-            if true_list is not None and false_list is None and (
-                    isinstance(true_list, list) or
-                    isinstance(true_list, tuple) or
-                    isinstance(true_list, set) or
-                    isinstance(true_list, str)
+
+            if all(
+                [
+                    true_list is not None,
+                    false_list is None,
+                    isinstance(true_list, (list, tuple, set, str))
+                ]
             ):
-                return True if v_instance in true_list else False
-            elif true_list is None and false_list is not None and (
-                    isinstance(false_list, list) or
-                    isinstance(false_list, tuple) or
-                    isinstance(false_list, set) or
-                    isinstance(false_list, str)
+                return v_instance in true_list
+
+            if all(
+                [
+                    true_list is None,
+                    false_list is not None,
+                    isinstance(false_list, (list, tuple, set, str))
+                ]
             ):
-                return True if v_instance not in false_list else False
-            elif true_list is not None and false_list is not None and (
-                    isinstance(true_list, list) or
-                    isinstance(true_list, tuple) or
-                    isinstance(true_list, set) or
-                    isinstance(true_list, str)
-            ) and (
-                    isinstance(false_list, list) or
-                    isinstance(false_list, tuple) or
-                    isinstance(false_list, set) or
-                    isinstance(false_list, str)
+                return v_instance not in false_list
+
+            if all(
+                [
+                    true_list is not None,
+                    false_list is not None,
+                    isinstance(true_list, (list, tuple, set, str)),
+                    isinstance(false_list, (list, tuple, set, str))
+                ]
             ):
-                return True if (v_instance in true_list) and (v_instance not in false_list) else False
-            else:
-                return True if v_instance not in [False, None, 0, 0.0, '', (), [], {*()}, {*[]}, {*{}}, {}] else False
-        else:
-            return False
+                return (v_instance in true_list) and (v_instance not in false_list)
+
+            return v_instance not in [False, None, 0, 0.0, '', (), [], {*()}, {*[]}, {*{}}, {}]
+
+        return False
+
     except Exception as e:
-        logger.exception(e) if v_true(debug, bool) else next
+        if v_true(debug, bool):
+            logger.exception(e)
         return False
 
 
+# --------------------------------------------------------------------------------------------------
+
+
 def os_environ(
     name: str,
-    value: any = None,
+    value: Any = None,
     debug: bool = False
-) -> any:
-    """伪全局变量"""
+) -> Any:
     """
-    Python 没有全局变量, 多个文件无法调用同一个变量
-    为了解决这个问题, 将变量设置为系统变量, 从而实现多个文件调用同一个变量
+    系统变量
+
+    伪全局变量
+    Python 没有全局变量, 多个文件无法调用同一个变量.
+    为了解决这个问题, 将变量设置为系统变量, 从而实现多个文件调用同一个变量.
     """
     try:
+
         # 变量名添加一个前缀, 防止和系统中其它变量名冲突
-        variable_name = f'PYTHON_VARIABLE_{name}'
-        if value == None:
-            data = os.environ.get(variable_name)
-            return json.loads(data)
-        else:
-            data = json.dumps(value)
-            os.environ[variable_name] = data
-            return value
+        _variable_name = f'PYTHON_VARIABLE_{name}'
+
+        if value is None:
+
+            _data = os.environ.get(_variable_name)
+
+            # 判断是否有数据
+            if _data:
+                try:
+                    # 如果环境变量有值, 使用 json.loads() 解析
+                    parsed_data = json.loads(_data)
+                    return parsed_data
+                except json.JSONDecodeError:
+                    return None
+            else:
+                return None
+
+        _data = json.dumps(value)
+        os.environ[_variable_name] = _data
+
+        return value
+
     except Exception as e:
-        logger.exception(e) if v_true(debug, bool) else next
+        if v_true(debug, bool):
+            logger.exception(e)
         return None
 
 
@@ -134,10 +149,13 @@ def mam_of_numbers(
     debug: bool = False
 ) -> tuple[int | float, int | float, int | float] | tuple[None, None, None]:
     """
+    (maximum, average, minimum)
+
     返回一组数字中的 最大值(maximum), 平均值(average), 最小值(minimum)
     numbers 数字列表 (仅支持 list 和 tuple, 不支 set)
     dest_type 目标类型 (将数字列表中的数字转换成统一的类型)
     """
+
     try:
         _numbers = deepcopy(numbers)
         match True:
@@ -150,52 +168,60 @@ def mam_of_numbers(
         _num_min = min(_numbers)
         return _num_max, _num_avg, _num_min
     except Exception as e:
-        logger.exception(e) if v_true(debug, bool) else next
+        if v_true(debug, bool):
+            logger.exception(e)
         return None, None, None
 
 
+# --------------------------------------------------------------------------------------------------
+
+
 def step_number_for_split_equally(
     integer: int,
     split_equally_number: int,
     debug: bool = False
 ) -> int | None:
     """
+    step number for split equally
+
     平分数字的步长
-    integer 数字
-    split_equally_number 平分 integer 的数字
-    """
-    """
+
+      integer 数字
+      split_equally_number 平分 integer 的数字
+
     示例:
 
         [1, 2, 3, 4, 5, 6, 7, 8, 9]
 
-        分成 2 份 -> [[1, 2, 3, 4, 5], [6, 7, 8, 9]] -> 返回 5
-        分成 3 份 -> [[1, 2, 3], [4, 5, 6], [7, 8, 9]] -> 返回 3
-        分成 4 份 -> [[1, 2, 3], [4, 5], [6, 7], [8, 9]] -> 返回 3
-        分成 5 份 -> [[1, 2], [3, 4], [5, 6], [7, 8], [9]] -> 返回 2
+        分成 2 份 -> [[1, 2, 3, 4, 5], [6, 7, 8, 9]]        -> 返回 5
+        分成 3 份 -> [[1, 2, 3], [4, 5, 6], [7, 8, 9]]      -> 返回 3
+        分成 4 份 -> [[1, 2, 3], [4, 5], [6, 7], [8, 9]]    -> 返回 3
+        分成 5 份 -> [[1, 2], [3, 4], [5, 6], [7, 8], [9]]  -> 返回 2
     """
     try:
         if integer % split_equally_number == 0:
             return int(integer / split_equally_number)
-        else:
-            return int(integer / split_equally_number) + 1
+        return int(integer / split_equally_number) + 1
     except Exception as e:
-        logger.exception(e) if v_true(debug, bool) else next
+        if v_true(debug, bool):
+            logger.exception(e)
         return None
 
 
+# --------------------------------------------------------------------------------------------------
+
+
 def division(
     dividend: int | float,
     divisor: int | float,
     debug: bool = False
 ) -> float | None:
-    """
-    除法
-    """
+    """Division"""
     try:
         return dividend / divisor
     except Exception as e:
-        logger.exception(e) if v_true(debug, bool) else next
+        if v_true(debug, bool):
+            logger.exception(e)
         return None
 
 
@@ -203,13 +229,13 @@ def divisor_1000(
     dividend: int | float,
     debug: bool = False
 ) -> float | None:
-    """
-    除法, 除以 1000
-    """
+    """Division (divisor: 1000)"""
+    # 除法, 除以 1000
     try:
         return dividend / 1000
     except Exception as e:
-        logger.exception(e) if v_true(debug, bool) else next
+        if v_true(debug, bool):
+            logger.exception(e)
         return None
 
 
@@ -217,13 +243,13 @@ def divisor_1024(
     dividend: int | float,
     debug: bool = False
 ) -> float | None:
-    """
-    除法, 除以 1024
-    """
+    """Division (divisor: 1024)"""
+    # 除法, 除以 1024
     try:
         return dividend / 1024
     except Exception as e:
-        logger.exception(e) if v_true(debug, bool) else next
+        if v_true(debug, bool):
+            logger.exception(e)
         return None
 
 
@@ -231,13 +257,12 @@ def divisor_square_1000(
     dividend: int | float,
     debug: bool = False
 ) -> float | None:
-    """
-    除法, 除以 1000的次方
-    """
+    """Division (divisor: 1000*1000)"""
     try:
         return dividend / (1000 * 1000)
     except Exception as e:
-        logger.exception(e) if v_true(debug, bool) else next
+        if v_true(debug, bool):
+            logger.exception(e)
         return None
 
 
@@ -245,13 +270,12 @@ def divisor_square_1024(
     dividend: int | float,
     debug: bool = False
 ) -> float | None:
-    """
-    除法, 除以 1024的次方
-    """
+    """Division (divisor: 1024*1024)"""
     try:
         return dividend / (1024 * 1024)
     except Exception as e:
-        logger.exception(e) if v_true(debug, bool) else next
+        if v_true(debug, bool):
+            logger.exception(e)
         return None
 
 
@@ -262,41 +286,50 @@ def check_file_type(
     file_object: str,
     file_type: str,
     debug: bool = False
-) -> bool | None:
+) -> bool:
     """
+    check file type
+
     检查文件类型
-    file_object 文件对象
-    file_type 文件类型
+
+        file_object 文件对象
+        file_type 文件类型
     """
     try:
+
         _file_path = Path(file_object)
+
         match True:
             case True if _file_path.exists() is False:
-                return False
+                result = False
             case True if file_type == 'absolute' and _file_path.is_absolute() is True:
-                return True
+                result = True
             case True if file_type == 'block_device' and _file_path.is_block_device() is True:
-                return True
+                result = True
             case True if file_type == 'dir' and _file_path.is_dir() is True:
-                return True
+                result = True
             case True if file_type == 'fifo' and _file_path.is_fifo() is True:
-                return True
+                result = True
             case True if file_type == 'file' and _file_path.is_file() is True:
-                return True
+                result = True
             case True if file_type == 'mount' and _file_path.is_mount() is True:
-                return True
+                result = True
             case True if file_type == 'relative_to' and _file_path.is_relative_to() is True:
-                return True
+                result = True
             case True if file_type == 'reserved' and _file_path.is_reserved() is True:
-                return True
+                result = True
             case True if file_type == 'socket' and _file_path.is_socket() is True:
-                return True
+                result = True
             case True if file_type == 'symlink' and _file_path.is_symlink() is True:
-                return True
+                result = True
             case _:
-                return False
+                result = False
+
+        return result
+
     except Exception as e:
-        logger.exception(e) if v_true(debug, bool) else next
+        if v_true(debug, bool):
+            logger.exception(e)
         return False
 
 
@@ -309,14 +342,11 @@ def list_sort(
     debug: bool = False,
     **kwargs
 ) -> list | None:
-    """
-    列表排序, 示例: list_sort(['1.2.3.4', '2.3.4.5'], key=inet_aton)
-    """
-    """
-    参考文档:
-        https://stackoverflow.com/a/4183538
-        https://blog.csdn.net/u013541325/article/details/117530957
-    """
+    """list sort"""
+    # 列表排序, 示例: list_sort(['1.2.3.4', '2.3.4.5'], key=inet_aton)
+    # 参考文档:
+    #     https://stackoverflow.com/a/4183538
+    #     https://blog.csdn.net/u013541325/article/details/117530957
     try:
 
         # from ipaddress import ip_address
@@ -331,7 +361,8 @@ def list_sort(
         return _data
 
     except Exception as e:
-        logger.exception(e) if v_true(debug, bool) else next
+        if v_true(debug, bool):
+            logger.exception(e)
         return None
 
 
@@ -341,18 +372,15 @@ def list_dict_sorted_by_key(
     debug: bool = False,
     **kwargs
 ) -> list | None:
-    """
-    列表字典排序
-    """
-    """
-    参考文档:
-        https://stackoverflow.com/a/73050
-    """
+    """list dict sorted by key"""
+    # 列表字典排序
+    # 参考文档: https://stackoverflow.com/a/73050
     try:
         _data = deepcopy(data)
         return sorted(_data, key=lambda x: x[key], **kwargs)
     except Exception as e:
-        logger.exception(e) if v_true(debug, bool) else next
+        if v_true(debug, bool):
+            logger.exception(e)
         return None
 
 
@@ -362,74 +390,94 @@ def list_split(
     equally: bool = False,
     debug: bool = False
 ) -> list | None:
-    """
-    列表分割
-    """
-    """
-    默认: 将 list 以 number个元素为一个list 分割
-
-        data = [1, 2, 3, 4, 5, 6, 7]
+    """list split"""
+    # 列表分割
+    #
+    # 默认: 将 list 以 number个元素为一个list 分割
+    #
+    #     data = [1, 2, 3, 4, 5, 6, 7]
+    #
+    #     list_split(data, 2) -> 将 data 以 2个元素为一个 list 分割
+    #     [[1, 2], [3, 4], [5, 6], [7]]
+    #
+    #     list_split(data, 3) -> 将 data 以 3个元素为一个 list 分割
+    #     [[1, 2, 3], [4, 5, 6], [7]]
+    #
+    # equally 为 True 时, 将 data 平均分成 number 份
+    #
+    #     data = [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19]
+    #
+    #     list_split_equally(data, 5) -> 将 data 平均分成 5 份
+    #     [[1, 2, 3, 4], [5, 6, 7, 8], [9, 10, 11, 12], [13, 14, 15, 16], [17, 18, 19]]
+    #
+    #     list_split_equally(data, 6) -> 将 data 平均分成 6 份
+    #     [[1, 2, 3, 4], [5, 6, 7], [8, 9, 10], [11, 12, 13], [14, 15, 16], [17, 18, 19]]
+    #
+    #     list_split_equally(data, 7) -> 将 data 平均分成 7 份
+    #     [[1, 2, 3], [4, 5, 6], [7, 8, 9], [10, 11, 12], [13, 14, 15], [16, 17], [18, 19]]
 
-        list_split(data, 2) -> 将 data 以 2个元素为一个 list 分割
-        [[1, 2], [3, 4], [5, 6], [7]]
-
-        list_split(data, 3) -> 将 data 以 3个元素为一个 list 分割
-        [[1, 2, 3], [4, 5, 6], [7]]
-
-    equally 为 True 时, 将 data 平均分成 number 份
-
-        data = [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19]
-
-        list_split_equally(data, 5) -> 将 data 平均分成 5 份
-        [[1, 2, 3, 4], [5, 6, 7, 8], [9, 10, 11, 12], [13, 14, 15, 16], [17, 18, 19]]
-
-        list_split_equally(data, 6) -> 将 data 平均分成 6 份
-        [[1, 2, 3, 4], [5, 6, 7], [8, 9, 10], [11, 12, 13], [14, 15, 16], [17, 18, 19]]
-
-        list_split_equally(data, 7) -> 将 data 平均分成 7 份
-        [[1, 2, 3], [4, 5, 6], [7, 8, 9], [10, 11, 12], [13, 14, 15], [16, 17], [18, 19]]
-    """
     try:
 
         # 数据拷贝
         _data_object = deepcopy(data)
+
         # 数据长度
         _data_length = len(_data_object)
+
         # 数据平分后的结果
         _data_result = []
 
+        _step_number: Optional[int] = None
+
         if v_true(debug, bool):
             logger.info(f"data object: {_data_object}")
             logger.info(f"data length: {_data_length}")
 
         if _data_length < number:
-            logger.error('number must greater than data length') if v_true(debug, bool) else next
+            if v_true(debug, bool):
+                logger.error('number must greater than data length')
             return None
-        elif _data_length == number:
+
+        if _data_length == number:
+
             _data_result = [[i] for i in _data_object]
+
         else:
 
             if equally is True:
 
-                # 数据平分时, 每份数据的最大长度
                 _step_number = step_number_for_split_equally(_data_length, number, debug=debug)
-                logger.info(f"step number: {_step_number}") if v_true(debug, bool) else next
+
+                if v_true(debug, bool):
+                    logger.info(f"step number: {_step_number}")
+
                 if _data_length % number == 0:
+
                     index_number_list = list(range(0, _data_length, number))
-                    logger.info(f"index number list: {index_number_list}") if v_true(debug, bool) else next
+
+                    if v_true(debug, bool):
+                        logger.info(f"index number list: {index_number_list}")
+
                     for index_number in index_number_list:
-                        logger.info(f"index: {index_number}, data: {_data_object[index_number:index_number + number]}") if v_true(debug, bool) else next
+
+                        if v_true(debug, bool):
+                            logger.info(f"index: {index_number}, data: {_data_object[index_number:index_number + number]}")
+
                         _data_result.append(deepcopy(_data_object[index_number:index_number + number]))
+
                 else:
+
                     # 前一部分
-                    previous_end_number = (_data_length % number) * _step_number
-                    previous_index_number_list = list(range(0, previous_end_number, _step_number))
-                    for index_number in previous_index_number_list:
-                        _data_result.append(deepcopy(_data_object[index_number:index_number + _step_number]))
-                    # 后一部分
-                    next_number_list = list(range(previous_end_number, _data_length, _step_number - 1))
-                    for index_number in next_number_list:
-                        _data_result.append(deepcopy(_data_object[index_number:index_number + (_step_number - 1)]))
+                    if _step_number is not None:
+                        previous_end_number = (_data_length % number) * _step_number
+                        previous_index_number_list = list(range(0, previous_end_number, _step_number))
+                        for index_number in previous_index_number_list:
+                            _data_result.append(deepcopy(_data_object[index_number:index_number + _step_number]))
+
+                        # 后一部分
+                        next_number_list = list(range(previous_end_number, _data_length, _step_number - 1))
+                        for index_number in next_number_list:
+                            _data_result.append(deepcopy(_data_object[index_number:index_number + (_step_number - 1)]))
 
             else:
 
@@ -439,7 +487,8 @@ def list_split(
         return _data_result
 
     except Exception as e:
-        logger.exception(e) if v_true(debug, bool) else next
+        if v_true(debug, bool):
+            logger.exception(e)
         return None
 
 
@@ -450,15 +499,25 @@ def list_print_by_step(
     debug: bool = False
 ) -> bool:
     """
+    list print by step
+
     列表按照 步长 和 分隔符 有规律的输出
     """
     try:
+
         _data_list = list_split(data, number, debug=debug)
+
+        if _data_list is None:
+            return False
+
         for _item in _data_list:
             print(*_item, sep=separator)
+
         return True
+
     except Exception as e:
-        logger.exception(e) if v_true(debug, bool) else next
+        if v_true(debug, bool):
+            logger.exception(e)
         return False
 
 
@@ -467,12 +526,14 @@ def list_remove_list(
     remove: list,
     debug: bool = False
 ) -> list | None:
+    """List remove List"""
     try:
         _original = deepcopy(original)
         _remove = deepcopy(remove)
         return [i for i in _original if i not in _remove]
     except Exception as e:
-        logger.exception(e) if v_true(debug, bool) else next
+        if v_true(debug, bool):
+            logger.exception(e)
         return None
 
 
@@ -480,14 +541,16 @@ def list_merge(
     data: list,
     debug: bool = False
 ) -> list | None:
-    """合并 List 中的 List 为一个 List"""
+    """list merge"""
+    # 合并 List 中的 List 为一个 List
     try:
         _results = []
         for i in deepcopy(data):
             _results += i
         return _results
     except Exception as e:
-        logger.exception(e) if v_true(debug, bool) else next
+        if v_true(debug, bool):
+            logger.exception(e)
         return None
 
 
@@ -497,13 +560,15 @@ def list_to_file(
     encoding: str = 'utf-8-sig',
     debug: bool = False
 ) -> bool:
+    """list to file"""
     try:
         with open(file, 'w', encoding=encoding) as _file:
             for line in data:
                 _file.write(f"{line}\n")
         return True
     except Exception as e:
-        logger.exception(e) if v_true(debug, bool) else next
+        if v_true(debug, bool):
+            logger.exception(e)
         return False
 
 def list_to_csvfile(
@@ -514,17 +579,19 @@ def list_to_csvfile(
     debug: bool = False,
     **kwargs
 ) -> bool:
+    """list to csvfile"""
     try:
         with open(file, 'w', encoding=encoding) as _file:
             # CRLF replaced by LF
             # https://stackoverflow.com/a/29976091
             outcsv = csv.writer(_file, lineterminator=os.linesep, **kwargs)
-            if v_true(fields, list):
+            if v_true(fields, list) and fields is not None:
                 outcsv.writerow(fields)
             outcsv.writerows(data)
         return True
     except Exception as e:
-        logger.exception(e) if v_true(debug, bool) else next
+        if v_true(debug, bool):
+            logger.exception(e)
         return False
 
 def range_zfill(
@@ -534,7 +601,8 @@ def range_zfill(
     width: int,
     debug: bool = False
 ) -> list | None:
-    """生成长度相同的字符串的列表"""
+    """range zfill"""
+    # 生成长度相同的字符串的列表
     # 示例: range_zfill(8, 13, 1, 2) => ['08', '09', '10', '11', '12']
     # 生成 小时 列表: range_zfill(0, 24, 1, 2)
     # 生成 分钟和秒 列表: range_zfill(0, 60, 1, 2)
@@ -543,7 +611,8 @@ def range_zfill(
     try:
         return [str(i).zfill(width) for i in range(start, stop, step)]
     except Exception as e:
-        logger.exception(e) if v_true(debug, bool) else next
+        if v_true(debug, bool):
+            logger.exception(e)
         return None
 
 
@@ -555,12 +624,14 @@ def dict_remove_key(
     key: str,
     debug: bool = False
 ) -> None | dict:
+    """dict remove key"""
     try:
         data_copy: dict = deepcopy(data)
         data_copy.pop(key)
         return data_copy
     except Exception as e:
-        logger.exception(e) if v_true(debug, bool) else next
+        if v_true(debug, bool):
+            logger.exception(e)
         return None
 
 def dict_to_file(
@@ -570,47 +641,52 @@ def dict_to_file(
     debug: bool = False,
     **kwargs
 ) -> bool:
+    """dict to file"""
     try:
         with open(file, 'w', encoding=encoding) as _file:
             json.dump(obj=data, fp=_file, indent=4, sort_keys=True, **kwargs)
         return True
     except Exception as e:
-        logger.exception(e) if v_true(debug, bool) else next
+        if v_true(debug, bool):
+            logger.exception(e)
         return False
 
 
 def dict_nested_update(
     data: dict,
     key: str,
-    value: any,
+    value: Any,
     debug: bool = False
 ) -> bool:
-    """
-    dictionary nested update
-    https://stackoverflow.com/a/58885744
-    """
+    """dict nested update"""
+    # dictionary nested update
+    # https://stackoverflow.com/a/58885744
     try:
-        if v_true(data, dict, debug=debug):
-            for _k, _v in data.items():
-                # callable() 判断是非为 function
-                if (key is not None and key == _k) or (callable(key) is True and key() == _k):
-                    if callable(value) is True:
-                        data[_k] = value()
-                    else:
-                        data[_k] = value
-                elif isinstance(_v, dict) is True:
-                    dict_nested_update(_v, key, value)
-                elif isinstance(_v, list) is True:
-                    for _o in _v:
-                        if isinstance(_o, dict):
-                            dict_nested_update(_o, key, value)
-                else:
-                    pass
-        else:
+
+        if not v_true(data, dict, debug=debug):
             return False
+
+        for _k, _v in data.items():
+            # callable() 判断是非为 function
+            if (key is not None and key == _k) or (callable(key) is True and key == _k):
+                if callable(value) is True:
+                    data[_k] = value()
+                else:
+                    data[_k] = value
+            elif isinstance(_v, dict) is True:
+                dict_nested_update(_v, key, value)
+            elif isinstance(_v, list) is True:
+                for _o in _v:
+                    if isinstance(_o, dict):
+                        dict_nested_update(_o, key, value)
+            else:
+                pass
+
         return True
+
     except Exception as e:
-        logger.exception(e) if v_true(debug, bool) else next
+        if v_true(debug, bool):
+            logger.exception(e)
         return False
 
 
@@ -622,23 +698,32 @@ def filename(
     split: str = '.',
     debug: bool = False
 ) -> str | None:
-    """获取文件名称"""
-    '''
-    https://stackoverflow.com/questions/678236/how-do-i-get-the-filename-without-the-extension-from-a-path-in-python
-    https://stackoverflow.com/questions/4152963/get-name-of-current-script-in-python
-    '''
+    """filename"""
+    # 获取文件名称
+    # https://stackoverflow.com/questions/678236/how-do-i-get-the-filename-without-the-extension-from-a-path-in-python
+    # https://stackoverflow.com/questions/4152963/get-name-of-current-script-in-python
     try:
+
         if v_true(debug, bool):
             logger.info(f"file: {file}")
             logger.info(f"split: {split}")
+
         _basename = str(os.path.basename(file))
-        logger.info(f"basename: {_basename}") if v_true(debug, bool) else next
+
+        if v_true(debug, bool):
+            logger.info(f"basename: {_basename}")
+
         _index_of_split = _basename.index(split)
-        logger.info(f"index of split: {_index_of_split}") if v_true(debug, bool) else next
-        logger.info(f"filename: {_basename[:_index_of_split]}") if v_true(debug, bool) else next
+
+        if v_true(debug, bool):
+            logger.info(f"index of split: {_index_of_split}")
+            logger.info(f"filename: {_basename[:_index_of_split]}")
+
         return _basename[:_index_of_split]
+
     except Exception as e:
-        logger.exception(e) if v_true(debug, bool) else next
+        if v_true(debug, bool):
+            logger.exception(e)
         return None
 
 
@@ -647,12 +732,11 @@ def filehash(
     sha: str = 'md5',
     debug: bool = False
 ) -> str | None:
-    """获取文件Hash"""
-    """
-    参考文档:
-        https://stackoverflow.com/a/59056837
-        https://stackoverflow.com/questions/22058048/hashing-a-file-in-python
-    """
+    """filehash"""
+    # 获取文件Hash
+    # 参考文档:
+    #     https://stackoverflow.com/a/59056837
+    #     https://stackoverflow.com/questions/22058048/hashing-a-file-in-python
     try:
         with open(file, "rb") as _file:
             match True:
@@ -674,10 +758,10 @@ def filehash(
                     file_hash = hashlib.sha3_384()
                 case True if sha == 'sha3_512':
                     file_hash = hashlib.sha3_512()
-                case True if sha == 'shake_128':
-                    file_hash = hashlib.shake_128()
-                case True if sha == 'shake_256':
-                    file_hash = hashlib.shake_256()
+                # case True if sha == 'shake_128':
+                #     file_hash = hashlib.shake_128()
+                # case True if sha == 'shake_256':
+                #     file_hash = hashlib.shake_256()
                 case _:
                     file_hash = hashlib.md5()
             # 建议设置为和 block size 相同的值, 多数系统默认为 4096, 可使用 stat 命令查看
@@ -687,7 +771,8 @@ def filehash(
                 file_hash.update(chunk)
             return file_hash.hexdigest()
     except Exception as e:
-        logger.exception(e) if v_true(debug, bool) else next
+        if v_true(debug, bool):
+            logger.exception(e)
         return None
 
 
@@ -695,11 +780,13 @@ def filesize(
     file: str,
     debug: bool = False
 ) -> int | None:
-    """获取文件大小"""
+    """filesize"""
+    # 获取文件大小
     try:
         return os.path.getsize(file)
     except Exception as e:
-        logger.exception(e) if v_true(debug, bool) else next
+        if v_true(debug, bool):
+            logger.exception(e)
         return None
 
 
@@ -707,7 +794,8 @@ def filesize(
 
 
 def resolve_path() -> str | None:
-    """获取当前目录名称"""
+    """resolve path"""
+    # 获取当前目录名称
     return str(Path().resolve())
 
 
@@ -720,7 +808,8 @@ def parent_path(
     try:
         return str(Path(path, **kwargs).parent.resolve()) if v_true(path, str, debug=debug) else None
     except Exception as e:
-        logger.exception(e) if v_true(debug, bool) else next
+        if v_true(debug, bool):
+            logger.exception(e)
         return None
 
 
@@ -731,10 +820,12 @@ def real_path(
 ) -> str | None:
     """获取真实路径"""
     try:
-        logger.info(f"path: {path}") if v_true(debug, bool) else next
+        if v_true(debug, bool):
+            logger.info(f"path: {path}")
         return os.path.realpath(path, **kwargs)
     except Exception as e:
-        logger.exception(e) if v_true(debug, bool) else next
+        if v_true(debug, bool):
+            logger.exception(e)
         return None
 
 
@@ -748,10 +839,8 @@ def retry(
     **kwargs
 ):
     """重试"""
-    """
-    函数传递参数: https://stackoverflow.com/a/803632
-    callable() 判断类型是非为函数: https://stackoverflow.com/a/624939
-    """
+    # 函数传递参数: https://stackoverflow.com/a/803632
+    # callable() 判断类型是非为函数: https://stackoverflow.com/a/624939
     try:
         _num = 0
         while True:
@@ -764,61 +853,60 @@ def retry(
             try:
                 return func(**kwargs)
             except Exception as e:
-                logger.exception(e) if v_true(debug, bool) else next
+                if v_true(debug, bool):
+                    logger.exception(e)
                 logger.success('retrying ...')
                 continue
             # break
     except Exception as e:
-        logger.exception(e) if v_true(debug, bool) else next
+        if v_true(debug, bool):
+            logger.exception(e)
 
 
 # --------------------------------------------------------------------------------------------------
 
-
-"""
-日期时间有两种: UTC datetime (UTC时区日期时间) 和 Local datetime (当前时区日期时间)
-
-Unix Timestamp 仅为 UTC datetime 的值
-
-但是, Local datetime 可以直接转换为 Unix Timestamp, UTC datetime 需要先转换到 UTC TimeZone 再转换为 Unix Timestamp
-
-相反, Unix Timestamp 可以直接转换为 UTC datetime, 要获得 Local datetime, 需要再将 UTC datetime 转换为 Local datetime
-
-    https://stackoverflow.com/a/13287083
-    https://stackoverflow.com/a/466376
-    https://stackoverflow.com/a/7999977
-    https://stackoverflow.com/a/3682808
-    https://stackoverflow.com/a/63920772
-    https://www.geeksforgeeks.org/how-to-remove-timezone-information-from-datetime-object-in-python/
-
-pytz all timezones
-
-    https://stackoverflow.com/a/13867319
-    https://stackoverflow.com/a/15692958
-
-    import pytz
-    pytz.all_timezones
-    pytz.common_timezones
-    pytz.timezone('US/Eastern')
-
-timezone
-
-    https://stackoverflow.com/a/39079819
-    https://stackoverflow.com/a/1681600
-    https://stackoverflow.com/a/4771733
-    https://stackoverflow.com/a/63920772
-    https://toutiao.io/posts/sin4x0/preview
-
-其它:
-
-    dt.replace(tzinfo=timezone.utc).astimezone(tz=None)
-
-    (dt.replace(tzinfo=timezone.utc).astimezone(tz=None)).strftime(format)
-    datetime.fromisoformat((dt.replace(tzinfo=timezone.utc).astimezone(tz=None)).strftime(format))
-    string_to_datetime((dt.replace(tzinfo=timezone.utc).astimezone(tz=None)).strftime(format), format)
-
-    datetime.fromisoformat(time.strftime(format, time.gmtime(dt)))
-"""
+# 日期时间有两种: UTC datetime (UTC时区日期时间) 和 Local datetime (当前时区日期时间)
+#
+# Unix Timestamp 仅为 UTC datetime 的值
+#
+# 但是, Local datetime 可以直接转换为 Unix Timestamp, UTC datetime 需要先转换到 UTC TimeZone 再转换为 Unix Timestamp
+#
+# 相反, Unix Timestamp 可以直接转换为 UTC datetime, 要获得 Local datetime, 需要再将 UTC datetime 转换为 Local datetime
+#
+#     https://stackoverflow.com/a/13287083
+#     https://stackoverflow.com/a/466376
+#     https://stackoverflow.com/a/7999977
+#     https://stackoverflow.com/a/3682808
+#     https://stackoverflow.com/a/63920772
+#     https://www.geeksforgeeks.org/how-to-remove-timezone-information-from-datetime-object-in-python/
+#
+# pytz all timezones
+#
+#     https://stackoverflow.com/a/13867319
+#     https://stackoverflow.com/a/15692958
+#
+#     import pytz
+#     pytz.all_timezones
+#     pytz.common_timezones
+#     pytz.timezone('US/Eastern')
+#
+# timezone
+#
+#     https://stackoverflow.com/a/39079819
+#     https://stackoverflow.com/a/1681600
+#     https://stackoverflow.com/a/4771733
+#     https://stackoverflow.com/a/63920772
+#     https://toutiao.io/posts/sin4x0/preview
+#
+# 其它:
+#
+#     dt.replace(tzinfo=timezone.utc).astimezone(tz=None)
+#
+#     (dt.replace(tzinfo=timezone.utc).astimezone(tz=None)).strftime(format)
+#     datetime.fromisoformat((dt.replace(tzinfo=timezone.utc).astimezone(tz=None)).strftime(format))
+#     string_to_datetime((dt.replace(tzinfo=timezone.utc).astimezone(tz=None)).strftime(format), format)
+#
+#     datetime.fromisoformat(time.strftime(format, time.gmtime(dt)))
 
 
 def date_to_datetime(
@@ -830,20 +918,22 @@ def date_to_datetime(
     try:
         return datetime.datetime.combine(date_object, datetime.datetime.min.time())
     except Exception as e:
-        logger.exception(e) if v_true(debug, bool) else next
+        if v_true(debug, bool):
+            logger.exception(e)
         return None
 
 
 def datetime_to_date(
-    datetime_object: datetime.datetime,
+    datetime_instance: datetime.datetime,
     debug: bool = False
 ) -> datetime.date | None:
     """'日期时间'转换为'日期'"""
     # https://stackoverflow.com/a/3743240
     try:
-        return datetime_object.date()
+        return datetime_instance.date()
     except Exception as e:
-        logger.exception(e) if v_true(debug, bool) else next
+        if v_true(debug, bool):
+            logger.exception(e)
         return None
 
 
@@ -861,12 +951,13 @@ def datetime_now(
     try:
         return datetime.datetime.utcnow() if _utc is True else datetime.datetime.now(**kwargs)
     except Exception as e:
-        logger.exception(e) if v_true(debug, bool) else next
+        if v_true(debug, bool):
+            logger.exception(e)
         return None
 
 
 def datetime_offset(
-    datetime_object: datetime.datetime,
+    datetime_instance: datetime.datetime,
     debug: bool = False,
     **kwargs
 ) -> datetime.datetime | None:
@@ -877,30 +968,31 @@ def datetime_offset(
     """
     _utc = kwargs.pop("utc", False)
     try:
-        if isinstance(datetime_object, datetime.datetime):
-            return datetime_object + datetime.timedelta(**kwargs)
-        else:
-            return datetime.datetime.utcnow() + datetime.timedelta(**kwargs) if _utc is True else datetime.datetime.now() + datetime.timedelta(**kwargs)
+        if isinstance(datetime_instance, datetime.datetime):
+            return datetime_instance + datetime.timedelta(**kwargs)
+        return datetime.datetime.utcnow() + datetime.timedelta(**kwargs) if _utc is True else datetime.datetime.now() + datetime.timedelta(**kwargs)
     except Exception as e:
-        logger.exception(e) if v_true(debug, bool) else next
+        if v_true(debug, bool):
+            logger.exception(e)
         return None
 
 
 def datetime_to_string(
-    datetime_object: datetime.datetime,
+    datetime_instance: datetime.datetime,
     string_format: str = '%Y-%m-%d %H:%M:%S',
     debug: bool = False
 ) -> str | None:
     """'日期时间'转换为'字符串'"""
     try:
-        return datetime.datetime.strftime(datetime_object, string_format) if isinstance(datetime_object, datetime.datetime) is True else None
+        return datetime.datetime.strftime(datetime_instance, string_format) if isinstance(datetime_instance, datetime.datetime) is True else None
     except Exception as e:
-        logger.exception(e) if v_true(debug, bool) else next
+        if v_true(debug, bool):
+            logger.exception(e)
         return None
 
 
 def datetime_to_timestamp(
-    datetime_object: datetime.datetime,
+    datetime_instance: datetime.datetime,
     utc: bool = False,
     debug: bool = False
 ) -> int | None:
@@ -910,17 +1002,17 @@ def datetime_to_timestamp(
     UTC datetime 需要先替换 timezone 再转换为 Unix Timestamp
     """
     try:
-        if isinstance(datetime_object, datetime.datetime):
-            return int(datetime_object.replace(tzinfo=datetime.timezone.utc).timestamp()) if utc is True else int(datetime_object.timestamp())
-        else:
-            return None
+        if isinstance(datetime_instance, datetime.datetime):
+            return int(datetime_instance.replace(tzinfo=datetime.timezone.utc).timestamp()) if utc is True else int(datetime_instance.timestamp())
+        return None
     except Exception as e:
-        logger.exception(e) if v_true(debug, bool) else next
+        if v_true(debug, bool):
+            logger.exception(e)
         return None
 
 
 def datetime_local_to_timezone(
-    datetime_object: datetime.datetime,
+    datetime_instance: datetime.datetime,
     tz: datetime.timezone = datetime.timezone.utc,
     debug: bool = False
 ) -> datetime.datetime | None:
@@ -929,18 +1021,19 @@ def datetime_local_to_timezone(
     replace(tzinfo=None) 移除结尾的时区信息
     """
     try:
-        if isinstance(datetime_object, datetime.datetime) is True:
-            return (datetime.datetime.fromtimestamp(datetime_object.timestamp(), tz=tz)).replace(tzinfo=None)
+        if isinstance(datetime_instance, datetime.datetime) is True:
+            return (datetime.datetime.fromtimestamp(datetime_instance.timestamp(), tz=tz)).replace(tzinfo=None)
         else:
             return None
     except Exception as e:
-        logger.exception(e) if v_true(debug, bool) else next
+        if v_true(debug, bool):
+            logger.exception(e)
         return None
 
 
 def datetime_utc_to_timezone(
-    datetime_object: datetime.datetime,
-    tz: datetime.timezone = datetime.datetime.now(datetime.timezone.utc).astimezone().tzinfo,
+    datetime_instance: datetime.datetime,
+    tz: Any = datetime.datetime.now(datetime.timezone.utc).astimezone().tzinfo,
     debug: bool = False
 ) -> datetime.datetime | None:
     """
@@ -948,12 +1041,13 @@ def datetime_utc_to_timezone(
     replace(tzinfo=None) 移除结尾的时区信息
     """
     try:
-        if isinstance(datetime_object, datetime.datetime) is True:
-            return datetime_object.replace(tzinfo=datetime.timezone.utc).astimezone(tz).replace(tzinfo=None)
+        if isinstance(datetime_instance, datetime.datetime) is True:
+            return datetime_instance.replace(tzinfo=datetime.timezone.utc).astimezone(tz).replace(tzinfo=None)
         else:
             return None
     except Exception as e:
-        logger.exception(e) if v_true(debug, bool) else next
+        if v_true(debug, bool):
+            logger.exception(e)
         return None
 
 
@@ -966,7 +1060,8 @@ def timestamp_to_datetime(
     try:
         return (datetime.datetime.fromtimestamp(timestamp, tz=tz)).replace(tzinfo=None) if v_true(timestamp, int, debug=debug) else None
     except Exception as e:
-        logger.exception(e) if v_true(debug, bool) else next
+        if v_true(debug, bool):
+            logger.exception(e)
         return None
 
 
@@ -975,10 +1070,12 @@ def datetime_string_to_datetime(
     datetime_format: str = '%Y-%m-%d %H:%M:%S',
     debug: bool = False
 ) -> datetime.datetime | None:
+    """datetime string to datetime"""
     try:
         return datetime.datetime.strptime(datetime_string, datetime_format) if v_true(datetime_string, str, debug=debug) else None
     except Exception as e:
-        logger.exception(e) if v_true(debug, bool) else next
+        if v_true(debug, bool):
+            logger.exception(e)
         return None
 
 
@@ -987,10 +1084,12 @@ def datetime_string_to_timestamp(
     datetime_format: str = '%Y-%m-%d %H:%M:%S',
     debug: bool = False
 ) -> int | None:
+    """datetime string to timestamp"""
     try:
         return int(time.mktime(time.strptime(datetime_string, datetime_format))) if v_true(datetime_string, str, debug=debug) else None
     except Exception as e:
-        logger.exception(e) if v_true(debug, bool) else next
+        if v_true(debug, bool):
+            logger.exception(e)
         return None
 
 
@@ -998,6 +1097,7 @@ def datetime_object(
     date_time: datetime.datetime,
     debug: bool = False
 ) -> dict | None:
+    """datetime object"""
     try:
         return {
             'date': date_time.strftime("%Y-%m-%d"),
@@ -1008,31 +1108,30 @@ def datetime_object(
             'datetime_zero': date_time.strftime('%Y-%m-%d 00:00:00')
         }
     except Exception as e:
-        logger.exception(e) if v_true(debug, bool) else next
+        if v_true(debug, bool):
+            logger.exception(e)
         return None
 
 
 # --------------------------------------------------------------------------------------------------
 
 
-'''
-run_cmd = bash('echo ok', universal_newlines=True, stdout=PIPE)
-
-if run_cmd != None:
-    returncode = run_cmd.returncode
-    outputs = run_cmd.stdout.splitlines()
-    print(returncode, type(returncode))
-    print(outputs, type(outputs))
-
-# echo 'echo ok' > /tmp/ok.sh
-run_script = bash('/tmp/ok.sh', file=True, universal_newlines=True, stdout=PIPE)
-
-if run_script != None:
-    returncode = run_script.returncode
-    outputs = run_script.stdout.splitlines()
-    print(returncode, type(returncode))
-    print(outputs, type(outputs))
-'''
+# run_cmd = bash('echo ok', universal_newlines=True, stdout=PIPE)
+#
+# if run_cmd != None:
+#     returncode = run_cmd.returncode
+#     outputs = run_cmd.stdout.splitlines()
+#     print(returncode, type(returncode))
+#     print(outputs, type(outputs))
+#
+# # echo 'echo ok' > /tmp/ok.sh
+# run_script = bash('/tmp/ok.sh', file=True, universal_newlines=True, stdout=PIPE)
+#
+# if run_script != None:
+#     returncode = run_script.returncode
+#     outputs = run_script.stdout.splitlines()
+#     print(returncode, type(returncode))
+#     print(outputs, type(outputs))
 
 
 def shell(
@@ -1050,18 +1149,17 @@ def shell(
                 return None
             case True if v_true(sh_shell, str, debug=debug) and v_true(command, str, debug=debug):
                 if isfile is True:
-                    if sh_option == None:
-                        return subprocess.run([sh_shell, command], **kwargs)
-                    else:
-                        return subprocess.run([sh_shell, sh_option, command], **kwargs)
-                else:
-                    if sh_option == None:
-                        sh_option = '-c'
-                    return subprocess.run([sh_shell, sh_option, command], **kwargs)
+                    if sh_option is None:
+                        return subprocess.run([sh_shell, command], **kwargs, check=False)
+                    return subprocess.run([sh_shell, sh_option, command], **kwargs, check=False)
+                if sh_option is None:
+                    sh_option = '-c'
+                return subprocess.run([sh_shell, sh_option, command], **kwargs, check=False)
             case _:
                 return None
     except Exception as e:
-        logger.exception(e) if v_true(debug, bool) else next
+        if v_true(debug, bool):
+            logger.exception(e)
         return None
 
 
@@ -1072,50 +1170,50 @@ def json_file_parser(
     file: str,
     debug: bool = False
 ) -> dict | None:
+    """JSON File Parser"""
     try:
         if check_file_type(file, 'file', debug=debug):
-            with open(file) as json_raw:
+            with open(file, encoding="utf-8") as json_raw:
                 json_dict = json.load(json_raw)
             return json_dict
-        else:
-            logger.error(f"No such file: {file}") if v_true(debug, bool) else next
-            return None
+        if v_true(debug, bool):
+            logger.error(f"No such file: {file}")
+        return None
     except Exception as e:
-        logger.exception(e) if v_true(debug, bool) else next
+        if v_true(debug, bool):
+            logger.exception(e)
         return None
 
-
-"""
-json_raw = '''
-{
-    "markdown.preview.fontSize": 14,
-    "editor.minimap.enabled": false,
-    "workbench.iconTheme": "vscode-icons",
-    "http.proxy": "http://127.0.0.1:1087"
-
-}
-'''
-
-print(json_sort(json_raw))
-
-{
-    "editor.minimap.enabled": false,
-    "http.proxy": "http://127.0.0.1:1087",
-    "markdown.preview.fontSize": 14,
-    "workbench.iconTheme": "vscode-icons"
-}
-"""
+# json_raw = '''
+# {
+#     "markdown.preview.fontSize": 14,
+#     "editor.minimap.enabled": false,
+#     "workbench.iconTheme": "vscode-icons",
+#     "http.proxy": "http://127.0.0.1:1087"
+# }
+# '''
+#
+# print(json_sort(json_raw))
+#
+# {
+#     "editor.minimap.enabled": false,
+#     "http.proxy": "http://127.0.0.1:1087",
+#     "markdown.preview.fontSize": 14,
+#     "workbench.iconTheme": "vscode-icons"
+# }
 
 
 def json_sort(
     string: str,
     debug: bool = False,
     **kwargs
-) -> dict | None:
+) -> str | None:
+    """JSON Sort"""
     try:
         return json.dumps(json.loads(string), indent=4, sort_keys=True, **kwargs) if v_true(string, str, debug=debug) else None
     except Exception as e:
-        logger.exception(e) if v_true(debug, bool) else next
+        if v_true(debug, bool):
+            logger.exception(e)
         return None
 
 
@@ -1123,45 +1221,47 @@ def json_sort(
 
 
 def delete_files(
-    files: str | list,
+    files: Union[str, List],
     debug: bool = False
 ) -> bool:
     """删除文件"""
     try:
 
-        if v_true(files, str, debug=debug) and check_file_type(files, 'file', debug=debug):
+        if isinstance(files, str) and check_file_type(files, 'file', debug=debug):
 
             os.remove(files)
-            logger.success('deleted file: {}'.format(files)) if v_true(debug, bool) else next
+            if v_true(debug, bool):
+                logger.success(f'deleted file: {files}')
             return True
 
-        elif v_true(files, list, debug=debug):
+        if v_true(files, list, debug=debug):
 
             for _file in files:
 
                 if v_true(_file, str, debug=debug) and check_file_type(_file, 'file', debug=debug):
                     try:
                         os.remove(_file)
-                        logger.success('deleted file: {}'.format(_file))
+                        logger.success(f'deleted file: {_file}')
                     except Exception as e:
-                        logger.error('error file: {} {}'.format(_file, e))
+                        logger.error(f'error file: {_file} {e}')
                 else:
-                    logger.error('error file: {}'.format(_file))
+                    logger.error(f'error file: {_file}')
 
             return True
 
-        else:
+        if v_true(debug, bool):
+            logger.error(f'error file: {files}')
 
-            logger.error('error file: {}'.format(files)) if v_true(debug, bool) else next
-            return False
+        return False
 
     except Exception as e:
-        logger.exception(e) if v_true(debug, bool) else next
+        if v_true(debug, bool):
+            logger.exception(e)
         return False
 
 
 def delete_directory(
-    directory: str | list,
+    directory: Union[str, List],
     debug: bool = False
 ) -> bool:
     """
@@ -1189,10 +1289,13 @@ def delete_directory(
     """
     try:
 
-        if v_true(directory, str, debug=debug) and check_file_type(directory, 'dir', debug=debug):
+        if isinstance(directory, str) and check_file_type(directory, 'dir', debug=debug):
 
             rmtree(directory)
-            logger.success('deleted directory: {}'.format(directory)) if v_true(debug, bool) else next
+
+            if v_true(debug, bool):
+                logger.success(f'deleted directory: {directory}')
+
             return True
 
         elif v_true(directory, list, debug=debug):
@@ -1202,21 +1305,25 @@ def delete_directory(
                 if v_true(_dir, str, debug=debug) and check_file_type(_dir, 'dir', debug=debug):
                     try:
                         rmtree(_dir)
-                        logger.success('deleted directory: {}'.format(_dir)) if v_true(debug, bool) else next
+                        if v_true(debug, bool):
+                            logger.success(f'deleted directory: {_dir}')
                     except Exception as e:
-                        logger.error('error directory: {} {}'.format(_dir, e)) if v_true(debug, bool) else next
+                        if v_true(debug, bool):
+                            logger.error(f'error directory: {_dir} {e}')
                 else:
-                    logger.error('error directory: {}'.format(_dir)) if v_true(debug, bool) else next
+                    if v_true(debug, bool):
+                        logger.error(f'error directory: {_dir}')
 
             return True
 
         else:
-
-            logger.error('error directory: {}'.format(directory)) if v_true(debug, bool) else next
+            if v_true(debug, bool):
+                logger.error(f'error directory: {directory}')
             return False
 
     except Exception as e:
-        logger.exception(e) if v_true(debug, bool) else next
+        if v_true(debug, bool):
+            logger.exception(e)
         return False
 
 
@@ -1225,7 +1332,7 @@ def delete_directory(
 
 def process_pool(
     process_func: Callable,
-    process_data: any = None,
+    process_data: Any = None,
     process_num: int = 2,
     thread: bool = False,
     debug: bool = False,
@@ -1234,48 +1341,56 @@ def process_pool(
     """
     多线程(MultiThread) | 多进程(MultiProcess)
     """
-    """
-    ThreadPool 线程池
-    ThreadPool 共享内存, Pool 不共享内存
-    ThreadPool 可以解决 Pool 在某些情况下产生的 Can't pickle local object 的错误
-    https://stackoverflow.com/a/58897266
-    """
+    # ThreadPool 线程池
+    # ThreadPool 共享内存, Pool 不共享内存
+    # ThreadPool 可以解决 Pool 在某些情况下产生的 Can't pickle local object 的错误
+    # https://stackoverflow.com/a/58897266
     try:
 
         # 处理数据
-        logger.info(f"data split ......") if v_true(debug, bool) else next
+        if v_true(debug, bool):
+            logger.info("data split ......")
         if len(process_data) <= process_num:
             process_num = len(process_data)
             _data = process_data
         else:
             _data = list_split(process_data, process_num, equally=True, debug=debug)
-        logger.info(f"data: {_data}") if v_true(debug, bool) else next
+
+        if _data is None:
+            return False
+
+        if v_true(debug, bool):
+            logger.info(f"data: {_data}")
 
         # 执行函数
         if v_true(thread, bool):
             # 多线程
-            logger.info(f"execute multi thread ......") if v_true(debug, bool) else next
+            if v_true(debug, bool):
+                logger.info("execute multi thread ......")
             with ThreadPool(process_num, **kwargs) as p:
                 return p.map(process_func, _data)
         else:
             # 多进程
-            logger.info(f"execute multi process ......") if v_true(debug, bool) else next
+            if v_true(debug, bool):
+                logger.info("execute multi process ......")
             with Pool(process_num, **kwargs) as p:
                 return p.map(process_func, _data)
 
     except Exception as e:
-        logger.exception(e) if v_true(debug, bool) else next
+        if v_true(debug, bool):
+            logger.exception(e)
         return False
 
 
 def new_process(
     process_func: Callable,
-    process_data: any = None,
+    process_data: Any = None,
     thread: bool = False,
     daemon: bool = True,
     debug: bool = False,
     **kwargs
 ) -> Thread | Process | bool:
+    """New Process"""
     try:
         if v_true(thread, bool):
             process = Thread(target=process_func, args=process_data, **kwargs)
@@ -1285,7 +1400,8 @@ def new_process(
         process.start()
         return process
     except Exception as e:
-        logger.exception(e) if v_true(debug, bool) else next
+        if v_true(debug, bool):
+            logger.exception(e)
         return False
 
 
@@ -1296,20 +1412,25 @@ def create_empty_file(
     file: str | None = None,
     debug: bool = False
 ) -> str | None:
+    """create empty file"""
     try:
         if file is None:
             # 当前时间戳(纳秒)
             timestamp = time.time_ns()
-            logger.info(f"timestamp: {timestamp}") if v_true(debug, bool) else next
+            if v_true(debug, bool):
+                logger.info(f"timestamp: {timestamp}")
             # 空文件路径
             file = f'/tmp/empty_file_{timestamp}.txt'
         # 创建一个空文件
-        logger.info(f"file: {file}") if v_true(debug, bool) else next
+        if v_true(debug, bool):
+            logger.info(f"file: {file}")
+        # pylint: disable=R1732,disable=W1514
         open(file, 'w').close()
         # 返回文件路径
         return file
     except Exception as e:
-        logger.exception(e) if v_true(debug, bool) else next
+        if v_true(debug, bool):
+            logger.exception(e)
         return None
 
 
@@ -1317,6 +1438,7 @@ def create_empty_file(
 
 
 def uuid4_hex() -> str:
+    """UUID"""
     return uuid4().hex
 
 
@@ -1330,7 +1452,8 @@ def increment_version(
         version_numbers[-1] = str(int(version_numbers[-1]) + 1)
         return '.'.join(version_numbers)
     except Exception as e:
-        logger.exception(e) if v_true(debug, bool) else next
+        if v_true(debug, bool):
+            logger.exception(e)
         return None
 
 
@@ -1346,7 +1469,8 @@ def make_directory(
         os.makedirs(directory)
         return True
     except Exception as e:
-        logger.exception(e) if v_true(debug, bool) else next
+        if v_true(debug, bool):
+            logger.exception(e)
         return False
 
 def change_directory(
@@ -1355,17 +1479,27 @@ def change_directory(
 ) -> bool:
     """改变目录"""
     try:
-        directory = str(directory) if v_true(directory, str, debug=debug) else next
-        logger.info(f"directory: {directory}") if v_true(debug, bool) else next
+
+        if not v_true(directory, str, debug=debug):
+            return False
+
+        if v_true(debug, bool):
+            logger.info(f"directory: {directory}")
+
         if check_file_type(directory, 'dir', debug=debug):
-            logger.info(f"change directory to {directory}") if v_true(debug, bool) else next
+            if v_true(debug, bool):
+                logger.info(f"change directory to {directory}")
             os.chdir(directory)
             return True
-        else:
-            logger.error(f"no such directory: {directory}") if v_true(debug, bool) else next
-            return False
+
+        if v_true(debug, bool):
+            logger.error(f"no such directory: {directory}")
+
+        return False
+
     except Exception as e:
-        logger.exception(e) if v_true(debug, bool) else next
+        if v_true(debug, bool):
+            logger.exception(e)
         return False
 
 
@@ -1373,19 +1507,23 @@ def change_directory(
 
 
 def load_toml_file(
-    file: str = None,
+    file: str,
     debug: bool = False
 ) -> dict | None:
+    """Load TOML file"""
+    info = '解析配置文件'
     try:
-        info = '解析配置文件'
-        logger.info(f'{info}[执行]') if v_true(debug, bool) else next
+        if v_true(debug, bool):
+            logger.info(f'{info}[执行]')
         with open(file, "rb") as _file:
             config = toml_load(_file)
-        logger.success(f'{info}[成功]') if v_true(debug, bool) else next
+        if v_true(debug, bool):
+            logger.success(f'{info}[成功]')
         return config
     except Exception as e:
-        logger.error(f'{info}[失败]') if v_true(debug, bool) else next
-        logger.exception(e) if v_true(debug, bool) else next
+        if v_true(debug, bool):
+            logger.error(f'{info}[失败]')
+            logger.exception(e)
         return None
 
 
@@ -1397,6 +1535,7 @@ def git_clone(
     log_prefix: str = '',
     debug: bool = False,
 ) -> bool:
+    """GIT Clone"""
     try:
 
         # 日志前缀
@@ -1426,23 +1565,27 @@ def git_clone(
             stdout=subprocess.PIPE,
             stderr=subprocess.STDOUT
         )
-        result_code = result.returncode
+
+        if result is None:
+            return False
+
+        result_code: int = result.returncode
         result_info = result.stdout.splitlines()
+
+        if v_true(debug, bool):
+            logger.error(f'{log_prefix}unsuccessful')
+            for i in result_info:
+                logger.error(f'{log_prefix}{i}')
+
         if result_code == 0:
-            logger.success(f'{log_prefix}successful') if v_true(debug, bool) else next
-            if v_true(debug, bool):
-                for i in result_info:
-                    logger.success(f'{log_prefix}{i}') if v_true(debug, bool) else next
             return True
-        else:
-            logger.error(f'{log_prefix}unsuccessful') if v_true(debug, bool) else next
-            if v_true(debug, bool):
-                for i in result_info:
-                    logger.error(f'{log_prefix}{i}') if v_true(debug, bool) else next
-            return False
+
+        return False
+
     except Exception as e:
-        logger.error(f'{log_prefix}unsuccessful') if v_true(debug, bool) else next
-        logger.exception(e) if v_true(debug, bool) else next
+        if v_true(debug, bool):
+            logger.error(f'{log_prefix}unsuccessful')
+            logger.exception(e)
         return False
 
 
@@ -1451,18 +1594,20 @@ def url_parse(
     scheme: str = 'http',
     debug: bool = False
 ) -> ParseResult:
+    """URL Parse"""
     none_result = ParseResult(scheme='', netloc='', path='', params='', query='', fragment='')
     try:
-        logger.info(f'url: {url}') if v_true(debug, bool) else next
+        if v_true(debug, bool):
+            logger.info(f'url: {url}')
         # 如果没有 scheme 的话, 字符串是不解析的. 所以, 如果没有 scheme, 就添加一个 scheme, 默认添加 http
         if v_true(url, str) and (url.find('://') == -1) and v_true(scheme, str):
             url = f'{scheme}://{url}'
         if v_true(url, str):
             return urlparse(url)
-        else:
-            return none_result
+        return none_result
     except Exception as e:
-        logger.exception(e) if v_true(debug, bool) else next
+        if v_true(debug, bool):
+            logger.exception(e)
         return none_result
 
 # def debug_log(