ezKit 1.6.2__py3-none-any.whl → 1.7.0__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
@@ -52,51 +41,47 @@ def v_true(
     """
     检查变量类型以及变量是否为True
     """
-    """
-    常见类型:
-
-        Boolean     bool            False
-        Numbers     int/float       0/0.0
-        String      str             ""
-        List        list/tuple/set  []/()/{}
-        Dictionary  dict            {}
+    # 常见类型:
+    #     Boolean     bool            False
+    #     Numbers     int/float       0/0.0
+    #     String      str             ""
+    #     List        list/tuple/set  []/()/{}
+    #     Dictionary  dict            {}
+    # 函数使用 callable(func) 判断
 
-    函数使用 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
 
 
@@ -106,22 +91,25 @@ def os_environ(
     debug: bool = False
 ) -> any:
     """伪全局变量"""
-    """
-    Python 没有全局变量, 多个文件无法调用同一个变量
-    为了解决这个问题, 将变量设置为系统变量, 从而实现多个文件调用同一个变量
-    """
+    # Python 没有全局变量, 多个文件无法调用同一个变量
+    # 为了解决这个问题, 将变量设置为系统变量, 从而实现多个文件调用同一个变量
     try:
+
         # 变量名添加一个前缀, 防止和系统中其它变量名冲突
         variable_name = f'PYTHON_VARIABLE_{name}'
-        if value == None:
+
+        if value is None:
             data = os.environ.get(variable_name)
             return json.loads(data)
-        else:
-            data = json.dumps(value)
-            os.environ[variable_name] = data
-            return value
+
+        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
 
 
@@ -133,11 +121,10 @@ def mam_of_numbers(
     dest_type: str | None = None,
     debug: bool = False
 ) -> tuple[int | float, int | float, int | float] | tuple[None, None, None]:
-    """
-    返回一组数字中的 最大值(maximum), 平均值(average), 最小值(minimum)
-    numbers 数字列表 (仅支持 list 和 tuple, 不支 set)
-    dest_type 目标类型 (将数字列表中的数字转换成统一的类型)
-    """
+    """(maximum, average, minimum)"""
+    # 返回一组数字中的 最大值(maximum), 平均值(average), 最小值(minimum)
+    # numbers 数字列表 (仅支持 list 和 tuple, 不支 set)
+    # dest_type 目标类型 (将数字列表中的数字转换成统一的类型)
     try:
         _numbers = deepcopy(numbers)
         match True:
@@ -150,7 +137,8 @@ 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
 
 
@@ -159,28 +147,26 @@ def step_number_for_split_equally(
     split_equally_number: int,
     debug: bool = False
 ) -> int | None:
-    """
-    平分数字的步长
-    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
-    """
+    """step number for split equally"""
+    # 平分数字的步长
+    #   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
     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
 
 
@@ -189,13 +175,12 @@ def division(
     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 +188,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 +202,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 +216,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 +229,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
 
 
@@ -263,11 +246,10 @@ def check_file_type(
     file_type: str,
     debug: bool = False
 ) -> bool | None:
-    """
-    检查文件类型
-    file_object 文件对象
-    file_type 文件类型
-    """
+    """check file type"""
+    # 检查文件类型
+    # file_object 文件对象
+    # file_type 文件类型
     try:
         _file_path = Path(file_object)
         match True:
@@ -296,7 +278,8 @@ def check_file_type(
             case _:
                 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
 
 
@@ -309,14 +292,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 +311,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 +322,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,33 +340,32 @@ 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:
 
         # 数据拷贝
@@ -403,29 +380,46 @@ def list_split(
             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:
@@ -439,7 +433,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
 
 
@@ -449,16 +444,16 @@ def list_print_by_step(
     separator: str | None = None,
     debug: bool = False
 ) -> bool:
-    """
-    列表按照 步长 和 分隔符 有规律的输出
-    """
+    """list print by step"""
+    # 列表按照 步长 和 分隔符 有规律的输出
     try:
         _data_list = list_split(data, number, debug=debug)
         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 +462,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 +477,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 +496,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,6 +515,7 @@ 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
@@ -524,7 +526,8 @@ def list_to_csvfile(
             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 +537,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 +547,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 +560,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,12 +577,14 @@ 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
 
 
@@ -585,10 +594,9 @@ def dict_nested_update(
     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():
@@ -610,7 +618,8 @@ def dict_nested_update(
             return False
         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 +631,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 +665,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:
@@ -687,7 +704,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 +713,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 +727,8 @@ def filesize(
 
 
 def resolve_path() -> str | None:
-    """获取当前目录名称"""
+    """resolve path"""
+    # 获取当前目录名称
     return str(Path().resolve())
 
 
@@ -720,7 +741,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 +753,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 +772,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 +786,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 +851,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 +884,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 +901,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 +935,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,17 +954,18 @@ 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,
+    datetime_instance: datetime.datetime,
     tz: datetime.timezone = datetime.datetime.now(datetime.timezone.utc).astimezone().tzinfo,
     debug: bool = False
 ) -> datetime.datetime | None:
@@ -948,12 +974,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 +993,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 +1003,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 +1017,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 +1030,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 +1041,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 +1082,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,39 +1103,37 @@ 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(
@@ -1112,10 +1141,12 @@ def json_sort(
     debug: bool = False,
     **kwargs
 ) -> dict | 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
 
 
@@ -1132,31 +1163,33 @@ def delete_files(
         if v_true(files, str, debug=debug) 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
 
 
@@ -1192,7 +1225,10 @@ def delete_directory(
         if v_true(directory, str, debug=debug) 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 +1238,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
 
 
@@ -1234,37 +1274,41 @@ 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 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
 
 
@@ -1276,6 +1320,7 @@ def new_process(
     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 +1330,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 +1342,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 +1368,7 @@ def create_empty_file(
 
 
 def uuid4_hex() -> str:
+    """UUID"""
     return uuid4().hex
 
 
@@ -1330,7 +1382,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 +1399,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(
@@ -1356,16 +1410,19 @@ def change_directory(
     """改变目录"""
     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 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
 
 
@@ -1376,16 +1433,20 @@ def load_toml_file(
     file: str = None,
     debug: bool = False
 ) -> dict | None:
+    """Load TOML file"""
     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 +1458,7 @@ def git_clone(
     log_prefix: str = '',
     debug: bool = False,
 ) -> bool:
+    """GIT Clone"""
     try:
 
         # 日志前缀
@@ -1428,21 +1490,17 @@ def git_clone(
         )
         result_code = 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 +1509,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(