ezKit 1.8.7__py3-none-any.whl → 1.9.0__py3-none-any.whl

ezKit/utils.py

@@ -29,15 +29,14 @@ NoneType = type(None)
 # --------------------------------------------------------------------------------------------------
 
 
-def v_true(
-    v_instance: Any,
-    v_type: Any = None,
+def isTrue(
+    object_data: Any,
+    object_type: Any = None,
     true_list: list | tuple | set | str | None = None,
-    false_list: list | tuple | set | str | None = None,
-    debug: bool = False
+    false_list: list | tuple | set | str | None = None
 ) -> bool:
     """
-    检查变量类型以及变量是否为 True
+    检查对象类型以及对象数据是否为 True
 
     常见类型:
 
@@ -56,7 +55,7 @@ def v_true(
 
     try:
 
-        if isinstance(v_instance, v_type):
+        if isinstance(object_data, object_type):
 
             if all(
                 [
@@ -65,7 +64,7 @@ def v_true(
                     isinstance(true_list, (list, tuple, set, str))
                 ]
             ):
-                return v_instance in true_list
+                return object_data in true_list
 
             if all(
                 [
@@ -74,7 +73,7 @@ def v_true(
                     isinstance(false_list, (list, tuple, set, str))
                 ]
             ):
-                return v_instance not in false_list
+                return object_data not in false_list
 
             if all(
                 [
@@ -84,15 +83,15 @@ def v_true(
                     isinstance(false_list, (list, tuple, set, str))
                 ]
             ):
-                return (v_instance in true_list) and (v_instance not in false_list)
+                return (object_data in true_list) and (object_data not in false_list)
 
-            return v_instance not in [False, None, 0, 0.0, '', (), [], {*()}, {*[]}, {*{}}, {}]
+            # return object_data not in [False, None, 0, 0.0, '', (), [], {}, {*()}, {*[]}, {*{}}]
+            return bool(object_data)
 
         return False
 
     except Exception as e:
-        if v_true(debug, bool):
-            logger.exception(e)
+        logger.exception(e)
         return False
 
 
@@ -101,8 +100,7 @@ def v_true(
 
 def os_environ(
     name: str,
-    value: Any = None,
-    debug: bool = False
+    value: Any = None
 ) -> Any:
     """
     系统变量
@@ -137,8 +135,7 @@ def os_environ(
         return value
 
     except Exception as e:
-        if v_true(debug, bool):
-            logger.exception(e)
+        logger.exception(e)
         return None
 
 
@@ -147,8 +144,7 @@ def os_environ(
 
 def mam_of_numbers(
     numbers: list | tuple,
-    dest_type: str | None = None,
-    debug: bool = False
+    dest_type: str | None = None
 ) -> tuple[int | float, int | float, int | float] | tuple[None, None, None]:
     """
     (maximum, average, minimum)
@@ -170,8 +166,7 @@ def mam_of_numbers(
         _num_min = min(_numbers)
         return _num_max, _num_avg, _num_min
     except Exception as e:
-        if v_true(debug, bool):
-            logger.exception(e)
+        logger.exception(e)
         return None, None, None
 
 
@@ -180,8 +175,7 @@ def mam_of_numbers(
 
 def step_number_for_split_equally(
     integer: int,
-    split_equally_number: int,
-    debug: bool = False
+    split_equally_number: int
 ) -> int | None:
     """
     step number for split equally
@@ -205,8 +199,7 @@ def step_number_for_split_equally(
             return int(integer / split_equally_number)
         return int(integer / split_equally_number) + 1
     except Exception as e:
-        if v_true(debug, bool):
-            logger.exception(e)
+        logger.exception(e)
         return None
 
 
@@ -215,69 +208,13 @@ def step_number_for_split_equally(
 
 def division(
     dividend: int | float,
-    divisor: int | float,
-    debug: bool = False
+    divisor: int | float
 ) -> float | None:
     """Division"""
     try:
         return dividend / divisor
     except Exception as e:
-        if v_true(debug, bool):
-            logger.exception(e)
-        return None
-
-
-def divisor_1000(
-    dividend: int | float,
-    debug: bool = False
-) -> float | None:
-    """Division (divisor: 1000)"""
-    # 除法, 除以 1000
-    try:
-        return dividend / 1000
-    except Exception as e:
-        if v_true(debug, bool):
-            logger.exception(e)
-        return None
-
-
-def divisor_1024(
-    dividend: int | float,
-    debug: bool = False
-) -> float | None:
-    """Division (divisor: 1024)"""
-    # 除法, 除以 1024
-    try:
-        return dividend / 1024
-    except Exception as e:
-        if v_true(debug, bool):
-            logger.exception(e)
-        return None
-
-
-def divisor_square_1000(
-    dividend: int | float,
-    debug: bool = False
-) -> float | None:
-    """Division (divisor: 1000*1000)"""
-    try:
-        return dividend / (1000 * 1000)
-    except Exception as e:
-        if v_true(debug, bool):
-            logger.exception(e)
-        return None
-
-
-def divisor_square_1024(
-    dividend: int | float,
-    debug: bool = False
-) -> float | None:
-    """Division (divisor: 1024*1024)"""
-    try:
-        return dividend / (1024 * 1024)
-    except Exception as e:
-        if v_true(debug, bool):
-            logger.exception(e)
+        logger.exception(e)
         return None
 
 
@@ -286,8 +223,7 @@ def divisor_square_1024(
 
 def check_file_type(
     file_object: str,
-    file_type: str,
-    debug: bool = False
+    file_type: str
 ) -> bool:
     """
     check file type
@@ -330,8 +266,7 @@ def check_file_type(
         return result
 
     except Exception as e:
-        if v_true(debug, bool):
-            logger.exception(e)
+        logger.exception(e)
         return False
 
 
@@ -341,7 +276,6 @@ def check_file_type(
 def list_sort(
     data: list,
     deduplication: bool = False,
-    debug: bool = False,
     **kwargs
 ) -> list | None:
     """list sort"""
@@ -363,15 +297,13 @@ def list_sort(
         return _data
 
     except Exception as e:
-        if v_true(debug, bool):
-            logger.exception(e)
+        logger.exception(e)
         return None
 
 
 def list_dict_sorted_by_key(
     data: list | tuple,
     key: str,
-    debug: bool = False,
     **kwargs
 ) -> list | None:
     """list dict sorted by key"""
@@ -381,16 +313,14 @@ def list_dict_sorted_by_key(
         _data = deepcopy(data)
         return sorted(_data, key=lambda x: x[key], **kwargs)
     except Exception as e:
-        if v_true(debug, bool):
-            logger.exception(e)
+        logger.exception(e)
         return None
 
 
 def list_split(
     data: list,
     number: int,
-    equally: bool = False,
-    debug: bool = False
+    equally: bool = False
 ) -> list | None:
     """list split"""
     # 列表分割
@@ -431,13 +361,7 @@ def list_split(
 
         _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:
-            if v_true(debug, bool):
-                logger.error('number must greater than data length')
             return None
 
         if _data_length == number:
@@ -446,25 +370,14 @@ def list_split(
 
         else:
 
-            if equally is True:
-
-                _step_number = step_number_for_split_equally(_data_length, number, debug=debug)
+            if isTrue(equally, bool):
 
-                if v_true(debug, bool):
-                    logger.info(f"step number: {_step_number}")
+                _step_number = step_number_for_split_equally(_data_length, number)
 
                 if _data_length % number == 0:
 
                     index_number_list = list(range(0, _data_length, number))
-
-                    if v_true(debug, bool):
-                        logger.info(f"index number list: {index_number_list}")
-
                     for index_number in index_number_list:
-
-                        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:
@@ -489,49 +402,78 @@ def list_split(
         return _data_result
 
     except Exception as e:
-        if v_true(debug, bool):
-            logger.exception(e)
+        logger.exception(e)
         return None
 
 
 def list_print_by_step(
     data: list,
-    number: int,
-    separator: str | None = None,
-    debug: bool = False
+    step: int,
+    separator: str = " "
 ) -> bool:
     """
-    list print by step
-
-    列表按照 步长 和 分隔符 有规律的输出
+    根据 步长 和 分隔符 有规律的打印列表中的数据
     """
     try:
 
-        result: list = []
+        # result: list = []
 
-        if len(data) <= number:
-            result.append(data)
-        else:
-            data_list = list_split(data, number, debug=debug)
-            if data_list is None or v_true(data_list, list) is False:
+        # if len(data) <= step:
+        #     result.append(data)
+        # else:
+        #     data_list = list_split(data, step, debug=debug)
+        #     if data_list is None or isTrue(data_list, list) is False:
+        #         return False
+        #     result = data_list
+
+        # for item in result:
+        #     print(*item, sep=separator)
+
+        # return True
+
+        # 判断参数类型
+        match True:
+            case True if isinstance(data, list) is False:
+                logger.error("argument type error: data")
+                return False
+            case True if isinstance(step, int) is False:
+                logger.error("argument type error: step")
+                return False
+            case True if isinstance(separator, str) is False:
+                logger.error("argument type error: separator")
+                return False
+            case _:
+                pass
+
+        # 判断参数数据
+        match True:
+            case True if not isTrue(data, list):
+                logger.error("argument error: data")
                 return False
-            result = data_list
+            case True if not isTrue(step, int):
+                logger.error("argument error: step")
+                return False
+            case _:
+                pass
 
-        for item in result:
-            print(*item, sep=separator)
+        # 打印
+        for i, v in enumerate(data):
+            if i > 0 and i % step == 0:
+                print()
+            print(v, end=separator)
+
+        print()
 
         return True
 
     except Exception as e:
-        if v_true(debug, bool):
-            logger.exception(e)
+        logger.exception(e)
         return False
 
 
 def list_remove_list(
     original: list,
-    remove: list,
-    debug: bool = False
+    remove: list
 ) -> list | None:
     """List remove List"""
     try:
@@ -539,14 +481,12 @@ def list_remove_list(
         _remove = deepcopy(remove)
         return [i for i in _original if i not in _remove]
     except Exception as e:
-        if v_true(debug, bool):
-            logger.exception(e)
+        logger.exception(e)
         return None
 
 
 def list_merge(
-    data: list,
-    debug: bool = False
+    data: list
 ) -> list | None:
     """list merge"""
     # 合并 List 中的 List 为一个 List
@@ -556,16 +496,14 @@ def list_merge(
             _results += i
         return _results
     except Exception as e:
-        if v_true(debug, bool):
-            logger.exception(e)
+        logger.exception(e)
         return None
 
 
 def list_to_file(
     data: list,
     file: str,
-    encoding: str = 'utf-8-sig',
-    debug: bool = False
+    encoding: str = 'utf-8-sig'
 ) -> bool:
     """list to file"""
     try:
@@ -574,8 +512,7 @@ def list_to_file(
                 _file.write(f"{line}\n")
         return True
     except Exception as e:
-        if v_true(debug, bool):
-            logger.exception(e)
+        logger.exception(e)
         return False
 
 def list_to_csvfile(
@@ -583,7 +520,6 @@ def list_to_csvfile(
     file: str,
     fields: list | None = None,
     encoding: str = 'utf-8-sig',
-    debug: bool = False,
     **kwargs
 ) -> bool:
     """list to csvfile"""
@@ -592,21 +528,19 @@ def list_to_csvfile(
             # CRLF replaced by LF
             # https://stackoverflow.com/a/29976091
             outcsv = csv.writer(_file, lineterminator=os.linesep, **kwargs)
-            if v_true(fields, list) and fields is not None:
+            if fields is not None and isTrue(fields, list):
                 outcsv.writerow(fields)
             outcsv.writerows(data)
         return True
     except Exception as e:
-        if v_true(debug, bool):
-            logger.exception(e)
+        logger.exception(e)
         return False
 
 def range_zfill(
     start: int,
     stop: int,
     step: int,
-    width: int,
-    debug: bool = False
+    width: int
 ) -> list | None:
     """range zfill"""
     # 生成长度相同的字符串的列表
@@ -618,8 +552,7 @@ def range_zfill(
     try:
         return [str(i).zfill(width) for i in range(start, stop, step)]
     except Exception as e:
-        if v_true(debug, bool):
-            logger.exception(e)
+        logger.exception(e)
         return None
 
 
@@ -628,8 +561,7 @@ def range_zfill(
 
 def dict_remove_key(
     data: dict,
-    key: str,
-    debug: bool = False
+    key: str
 ) -> dict | None:
     """dict remove key"""
     try:
@@ -637,15 +569,13 @@ def dict_remove_key(
         data_copy.pop(key)
         return data_copy
     except Exception as e:
-        if v_true(debug, bool):
-            logger.exception(e)
+        logger.exception(e)
         return None
 
 def dict_to_file(
     data: dict,
     file: str,
     encoding: str = 'utf-8-sig',
-    debug: bool = False,
     **kwargs
 ) -> bool:
     """dict to file"""
@@ -654,23 +584,21 @@ def dict_to_file(
             json.dump(obj=data, fp=_file, indent=4, sort_keys=True, **kwargs)
         return True
     except Exception as e:
-        if v_true(debug, bool):
-            logger.exception(e)
+        logger.exception(e)
         return False
 
 
 def dict_nested_update(
     data: dict,
     key: str,
-    value: Any,
-    debug: bool = False
+    value: Any
 ) -> bool:
     """dict nested update"""
     # dictionary nested update
     # https://stackoverflow.com/a/58885744
     try:
 
-        if not v_true(data, dict, debug=debug):
+        if not isTrue(data, dict):
             return False
 
         for _k, _v in data.items():
@@ -680,11 +608,11 @@ def dict_nested_update(
                     data[_k] = value()
                 else:
                     data[_k] = value
-            elif isinstance(_v, dict) is True:
+            elif isTrue(_v, dict):
                 dict_nested_update(_v, key, value)
-            elif isinstance(_v, list) is True:
+            elif isTrue(_v, list):
                 for _o in _v:
-                    if isinstance(_o, dict):
+                    if isTrue(_o, dict):
                         dict_nested_update(_o, key, value)
             else:
                 pass
@@ -692,8 +620,7 @@ def dict_nested_update(
         return True
 
     except Exception as e:
-        if v_true(debug, bool):
-            logger.exception(e)
+        logger.exception(e)
         return False
 
 
@@ -702,42 +629,24 @@ def dict_nested_update(
 
 def filename(
     file: str,
-    split: str = '.',
-    debug: bool = False
+    split: str = '.'
 ) -> str | None:
     """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))
-
-        if v_true(debug, bool):
-            logger.info(f"basename: {_basename}")
-
         _index_of_split = _basename.index(split)
-
-        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:
-        if v_true(debug, bool):
-            logger.exception(e)
+        logger.exception(e)
         return None
 
 
 def filehash(
     file: str,
-    sha: str = 'md5',
-    debug: bool = False
+    sha: str = 'md5'
 ) -> str | None:
     """filehash"""
     # 获取文件Hash
@@ -778,22 +687,19 @@ def filehash(
                 file_hash.update(chunk)
             return file_hash.hexdigest()
     except Exception as e:
-        if v_true(debug, bool):
-            logger.exception(e)
+        logger.exception(e)
         return None
 
 
 def filesize(
-    file: str,
-    debug: bool = False
+    file: str
 ) -> int | None:
     """filesize"""
     # 获取文件大小
     try:
         return os.path.getsize(file)
     except Exception as e:
-        if v_true(debug, bool):
-            logger.exception(e)
+        logger.exception(e)
         return None
 
 
@@ -813,61 +719,52 @@ def filesize(
 # ) -> str | None:
 #     """获取父目录名称"""
 #     try:
-#         return str(Path(path, **kwargs).parent.resolve()) if v_true(path, str, debug=debug) else None
+#         return str(Path(path, **kwargs).parent.resolve()) if isTrue(path, str, debug=debug) else None
 #     except Exception as e:
-#         if v_true(debug, bool):
+#         if isTrue(debug, bool):
 #             logger.exception(e)
 #         return None
 
 
 def realpath(
     path: str,
-    debug: bool = False,
     **kwargs
 ) -> str | None:
     """获取对象真实路径"""
     try:
-        # if v_true(debug, bool):
-        #     logger.info(f"path: {path}")
-        # return os.path.realpath(path, **kwargs)
-        if v_true(path, str, debug=debug) is False:
+        if not isTrue(path, str):
             return None
         return str(Path(path, **kwargs).resolve())
     except Exception as e:
-        if v_true(debug, bool):
-            logger.exception(e)
+        logger.exception(e)
         return None
 
 
 def current_dir(
     path: str,
-    debug: bool = False,
     **kwargs
 ) -> str | None:
     """获取对象所在目录"""
     try:
-        if v_true(path, str, debug=debug) is False:
+        if not isTrue(path, str):
             return None
         return str(Path(path, **kwargs).parent.resolve())
     except Exception as e:
-        if v_true(debug, bool):
-            logger.exception(e)
+        logger.exception(e)
         return None
 
 
 def parent_dir(
     path: str,
-    debug: bool = False,
     **kwargs
 ) -> str | None:
     """获取对象所在目录的父目录"""
     try:
-        if v_true(path, str, debug=debug) is False:
+        if not isTrue(path, str):
             return None
         return str(Path(path, **kwargs).parent.parent.resolve())
     except Exception as e:
-        if v_true(debug, bool):
-            logger.exception(e)
+        logger.exception(e)
         return None
 
 
@@ -877,7 +774,6 @@ def parent_dir(
 def retry(
     times: int,
     func: Callable,
-    debug: bool = False,
     **kwargs
 ):
     """重试"""
@@ -895,14 +791,11 @@ def retry(
             try:
                 return func(**kwargs)
             except Exception as e:
-                if v_true(debug, bool):
-                    logger.exception(e)
-                logger.success('retrying ...')
+                logger.exception(e)
+                logger.info('retrying ...')
                 continue
-            # break
     except Exception as e:
-        if v_true(debug, bool):
-            logger.exception(e)
+        logger.exception(e)
 
 
 # --------------------------------------------------------------------------------------------------
@@ -952,30 +845,26 @@ def retry(
 
 
 def date_to_datetime(
-    date_object: datetime.datetime,
-    debug: bool = False
+    date_object: datetime.datetime
 ) -> datetime.datetime | None:
     """'日期'转换为'日期时间'"""
     # https://stackoverflow.com/a/1937636
     try:
         return datetime.datetime.combine(date_object, datetime.datetime.min.time())
     except Exception as e:
-        if v_true(debug, bool):
-            logger.exception(e)
+        logger.exception(e)
         return None
 
 
 def datetime_to_date(
-    datetime_instance: datetime.datetime,
-    debug: bool = False
+    datetime_instance: datetime.datetime
 ) -> datetime.date | None:
     """'日期时间'转换为'日期'"""
     # https://stackoverflow.com/a/3743240
     try:
         return datetime_instance.date()
     except Exception as e:
-        if v_true(debug, bool):
-            logger.exception(e)
+        logger.exception(e)
         return None
 
 
@@ -984,25 +873,20 @@ def local_timezone():
     return datetime.datetime.now(datetime.timezone.utc).astimezone().tzinfo
 
 
-def datetime_now(
-        debug: bool = False,
-        **kwargs
-) -> datetime.datetime | None:
+def datetime_now(**kwargs) -> datetime.datetime | None:
     """获取当前日期和时间"""
-    _utc = kwargs.pop("utc", False)
+    utc = kwargs.pop("utc", False)
     try:
-        if _utc is True:
+        if isTrue(utc, bool):
             return datetime.datetime.now(datetime.timezone.utc)
         return datetime.datetime.now(**kwargs)
     except Exception as e:
-        if v_true(debug, bool):
-            logger.exception(e)
+        logger.exception(e)
         return None
 
 
 def datetime_offset(
     datetime_instance: datetime.datetime | None = None,
-    debug: bool = False,
     **kwargs
 ) -> datetime.datetime | None:
     """
@@ -1021,29 +905,27 @@ def datetime_offset(
         return datetime.datetime.now() + datetime.timedelta(**kwargs)
 
     except Exception as e:
-        if v_true(debug, bool):
-            logger.exception(e)
+        logger.exception(e)
         return None
 
 
 def datetime_to_string(
     datetime_instance: datetime.datetime,
-    string_format: str = '%Y-%m-%d %H:%M:%S',
-    debug: bool = False
+    string_format: str = '%Y-%m-%d %H:%M:%S'
 ) -> str | None:
     """'日期时间'转换为'字符串'"""
     try:
-        return datetime.datetime.strftime(datetime_instance, string_format) if isinstance(datetime_instance, datetime.datetime) is True else None
+        if not isTrue(datetime_instance, datetime.datetime):
+            return None
+        return datetime.datetime.strftime(datetime_instance, string_format)
     except Exception as e:
-        if v_true(debug, bool):
-            logger.exception(e)
+        logger.exception(e)
         return None
 
 
 def datetime_to_timestamp(
     datetime_instance: datetime.datetime,
-    utc: bool = False,
-    debug: bool = False
+    utc: bool = False
 ) -> int | None:
     """
     Datatime 转换为 Unix Timestamp
@@ -1051,100 +933,93 @@ def datetime_to_timestamp(
     UTC datetime 需要先替换 timezone 再转换为 Unix Timestamp
     """
     try:
-        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
+        if not isTrue(datetime_instance, datetime.datetime):
+            return None
+        return int(datetime_instance.replace(tzinfo=datetime.timezone.utc).timestamp()) if utc is True else int(datetime_instance.timestamp())
     except Exception as e:
-        if v_true(debug, bool):
-            logger.exception(e)
+        logger.exception(e)
         return None
 
 
 def datetime_local_to_timezone(
     datetime_instance: datetime.datetime,
-    tz: datetime.timezone = datetime.timezone.utc,
-    debug: bool = False
+    tz: datetime.timezone = datetime.timezone.utc
 ) -> datetime.datetime | None:
     """
     Local datetime to TimeZone datetime (默认转换为 UTC datetime)
     replace(tzinfo=None) 移除结尾的时区信息
     """
     try:
-        if isinstance(datetime_instance, datetime.datetime) is True:
-            return (datetime.datetime.fromtimestamp(datetime_instance.timestamp(), tz=tz)).replace(tzinfo=None)
-        else:
+        if not isTrue(datetime_instance, datetime.datetime):
             return None
+        return (datetime.datetime.fromtimestamp(datetime_instance.timestamp(), tz=tz)).replace(tzinfo=None)
     except Exception as e:
-        if v_true(debug, bool):
-            logger.exception(e)
+        logger.exception(e)
         return None
 
 
 def datetime_utc_to_timezone(
     datetime_instance: datetime.datetime,
-    tz: Any = datetime.datetime.now(datetime.timezone.utc).astimezone().tzinfo,
-    debug: bool = False
+    tz: Any = datetime.datetime.now(datetime.timezone.utc).astimezone().tzinfo
 ) -> datetime.datetime | None:
     """
     UTC datetime to TimeZone datetime (默认转换为 Local datetime)
     replace(tzinfo=None) 移除结尾的时区信息
     """
     try:
-        if isinstance(datetime_instance, datetime.datetime) is True:
-            return datetime_instance.replace(tzinfo=datetime.timezone.utc).astimezone(tz).replace(tzinfo=None)
-        else:
+        if not isTrue(datetime_instance, datetime.datetime):
             return None
+        return datetime_instance.replace(tzinfo=datetime.timezone.utc).astimezone(tz).replace(tzinfo=None)
+
     except Exception as e:
-        if v_true(debug, bool):
-            logger.exception(e)
+        logger.exception(e)
         return None
 
 
 def timestamp_to_datetime(
     timestamp: int,
-    tz: datetime.timezone = datetime.timezone.utc,
-    debug: bool = False
+    tz: datetime.timezone = datetime.timezone.utc
 ) -> datetime.datetime | None:
     """Unix Timestamp 转换为 Datatime"""
     try:
-        return (datetime.datetime.fromtimestamp(timestamp, tz=tz)).replace(tzinfo=None) if v_true(timestamp, int, debug=debug) else None
+        if not isTrue(timestamp, int):
+            return None
+        return (datetime.datetime.fromtimestamp(timestamp, tz=tz)).replace(tzinfo=None)
     except Exception as e:
-        if v_true(debug, bool):
-            logger.exception(e)
+        logger.exception(e)
         return None
 
 
 def datetime_string_to_datetime(
     datetime_string: str,
-    datetime_format: str = '%Y-%m-%d %H:%M:%S',
-    debug: bool = False
+    datetime_format: str = '%Y-%m-%d %H:%M:%S'
 ) -> 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
+        if not isTrue(datetime_string, str):
+            return None
+        return datetime.datetime.strptime(datetime_string, datetime_format)
     except Exception as e:
-        if v_true(debug, bool):
-            logger.exception(e)
+        logger.exception(e)
         return None
 
 
 def datetime_string_to_timestamp(
     datetime_string: str,
-    datetime_format: str = '%Y-%m-%d %H:%M:%S',
-    debug: bool = False
+    datetime_format: str = '%Y-%m-%d %H:%M:%S'
 ) -> 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
+        if not isTrue(datetime_string, str):
+            return None
+        return int(time.mktime(time.strptime(datetime_string, datetime_format)))
     except Exception as e:
-        if v_true(debug, bool):
-            logger.exception(e)
+        logger.exception(e)
         return None
 
 
 def datetime_object(
-    date_time: datetime.datetime,
-    debug: bool = False
+    date_time: datetime.datetime
 ) -> dict | None:
     """datetime object"""
     try:
@@ -1157,8 +1032,7 @@ def datetime_object(
             'datetime_zero': date_time.strftime('%Y-%m-%d 00:00:00')
         }
     except Exception as e:
-        if v_true(debug, bool):
-            logger.exception(e)
+        logger.exception(e)
         return None
 
 
@@ -1188,15 +1062,14 @@ def shell(
     isfile: bool = False,
     sh_shell: str = '/bin/bash',
     sh_option: str | None = None,
-    debug: bool = False,
     **kwargs
 ) -> subprocess.CompletedProcess | None:
     """run shell command or script"""
     try:
         match True:
-            case True if not check_file_type(sh_shell, 'file', debug=debug):
+            case True if not check_file_type(sh_shell, 'file'):
                 return None
-            case True if v_true(sh_shell, str, debug=debug) and v_true(command, str, debug=debug):
+            case True if isTrue(sh_shell, str) and isTrue(command, str):
                 if isfile is True:
                     if sh_option is None:
                         return subprocess.run([sh_shell, command], **kwargs, check=False)
@@ -1207,8 +1080,7 @@ def shell(
             case _:
                 return None
     except Exception as e:
-        if v_true(debug, bool):
-            logger.exception(e)
+        logger.exception(e)
         return None
 
 
@@ -1216,21 +1088,18 @@ def shell(
 
 
 def json_file_parser(
-    file: str,
-    debug: bool = False
+    file: str
 ) -> dict | None:
     """JSON File Parser"""
     try:
-        if check_file_type(file, 'file', debug=debug):
-            with open(file, encoding="utf-8") as json_raw:
-                json_dict = json.load(json_raw)
-            return json_dict
-        if v_true(debug, bool):
-            logger.error(f"No such file: {file}")
-        return None
+        if not check_file_type(file, 'file'):
+            logger.error(f"no such file: {file}")
+            return None
+        with open(file, encoding="utf-8") as json_raw:
+            json_dict = json.load(json_raw)
+        return json_dict
     except Exception as e:
-        if v_true(debug, bool):
-            logger.exception(e)
+        logger.exception(e)
         return None
 
 # json_raw = '''
@@ -1254,15 +1123,15 @@ def json_file_parser(
 
 def json_sort(
     string: str,
-    debug: bool = False,
     **kwargs
 ) -> 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
+        if not isTrue(string, str):
+            return None
+        return json.dumps(json.loads(string), indent=4, sort_keys=True, **kwargs)
     except Exception as e:
-        if v_true(debug, bool):
-            logger.exception(e)
+        logger.exception(e)
         return None
 
 
@@ -1270,48 +1139,39 @@ def json_sort(
 
 
 def delete_files(
-    files: Union[str, List],
-    debug: bool = False
+    files: Union[str, List]
 ) -> bool:
     """删除文件"""
     try:
 
-        if isinstance(files, str) and check_file_type(files, 'file', debug=debug):
-
+        if isinstance(files, str) and check_file_type(files, 'file'):
             os.remove(files)
-            if v_true(debug, bool):
-                logger.success(f'deleted file: {files}')
+            logger.success(f'deleted file: {files}')
             return True
 
-        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(f'deleted file: {_file}')
-                    except Exception as e:
-                        logger.error(f'error file: {_file} {e}')
-                else:
-                    logger.error(f'error file: {_file}')
+        if not isTrue(files, list):
+            return False
 
-            return True
+        for _file in files:
 
-        if v_true(debug, bool):
-            logger.error(f'error file: {files}')
+            if isinstance(_file, str) and check_file_type(_file, 'file'):
+                try:
+                    os.remove(_file)
+                    logger.success(f'deleted file: {_file}')
+                except Exception as e:
+                    logger.error(f'error file: {_file} {e}')
+            else:
+                logger.error(f'error file: {_file}')
 
-        return False
+        return True
 
     except Exception as e:
-        if v_true(debug, bool):
-            logger.exception(e)
+        logger.exception(e)
         return False
 
 
 def delete_directory(
-    directory: Union[str, List],
-    debug: bool = False
+    directory: Union[str, List]
 ) -> bool:
     """
     delete directory
@@ -1338,41 +1198,30 @@ def delete_directory(
     """
     try:
 
-        if isinstance(directory, str) and check_file_type(directory, 'dir', debug=debug):
-
+        if isinstance(directory, str) and check_file_type(directory, 'dir'):
             rmtree(directory)
-
-            if v_true(debug, bool):
-                logger.success(f'deleted directory: {directory}')
-
+            logger.success(f'deleted directory: {directory}')
             return True
 
-        elif v_true(directory, list, debug=debug):
-
-            for _dir in directory:
+        if not isTrue(directory, list):
+            logger.error(f'error directory: {directory}')
+            return False
 
-                if v_true(_dir, str, debug=debug) and check_file_type(_dir, 'dir', debug=debug):
-                    try:
-                        rmtree(_dir)
-                        if v_true(debug, bool):
-                            logger.success(f'deleted directory: {_dir}')
-                    except Exception as e:
-                        if v_true(debug, bool):
-                            logger.error(f'error directory: {_dir} {e}')
-                else:
-                    if v_true(debug, bool):
-                        logger.error(f'error directory: {_dir}')
+        for _dir in directory:
 
-            return True
+            if isTrue(_dir, str) and check_file_type(_dir, 'dir'):
+                try:
+                    rmtree(_dir)
+                    logger.success(f'deleted directory: {_dir}')
+                except Exception as e:
+                    logger.error(f'error directory: {_dir} {e}')
+            else:
+                logger.error(f'error directory: {_dir}')
 
-        else:
-            if v_true(debug, bool):
-                logger.error(f'error directory: {directory}')
-            return False
+        return True
 
     except Exception as e:
-        if v_true(debug, bool):
-            logger.exception(e)
+        logger.exception(e)
         return False
 
 
@@ -1384,7 +1233,6 @@ def process_pool(
     process_data: Any = None,
     process_num: int = 2,
     thread: bool = False,
-    debug: bool = False,
     **kwargs
 ) -> list | bool:
     """
@@ -1397,37 +1245,29 @@ def process_pool(
     try:
 
         # 处理数据
-        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)
+            _data = list_split(process_data, process_num, equally=True)
 
         if _data is None:
             return False
 
-        if v_true(debug, bool):
-            logger.info(f"data: {_data}")
-
         # 执行函数
-        if v_true(thread, bool):
+        if isTrue(thread, bool):
             # 多线程
-            if v_true(debug, bool):
-                logger.info("execute multi thread ......")
+            logger.info("execute multi thread ......")
             with ThreadPool(process_num, **kwargs) as p:
                 return p.map(process_func, _data)
         else:
             # 多进程
-            if v_true(debug, bool):
-                logger.info("execute multi process ......")
+            logger.info("execute multi process ......")
             with Pool(process_num, **kwargs) as p:
                 return p.map(process_func, _data)
 
     except Exception as e:
-        if v_true(debug, bool):
-            logger.exception(e)
+        logger.exception(e)
         return False
 
 
@@ -1436,12 +1276,11 @@ def new_process(
     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):
+        if isTrue(thread, bool):
             process = Thread(target=process_func, args=process_data, **kwargs)
         else:
             process = Process(target=process_func, args=process_data, **kwargs)
@@ -1449,8 +1288,7 @@ def new_process(
         process.start()
         return process
     except Exception as e:
-        if v_true(debug, bool):
-            logger.exception(e)
+        logger.exception(e)
         return False
 
 
@@ -1458,28 +1296,22 @@ def new_process(
 
 
 def create_empty_file(
-    file: str | None = None,
-    debug: bool = False
+    file: str | None = None
 ) -> str | None:
     """create empty file"""
     try:
         if file is None:
             # 当前时间戳(纳秒)
             timestamp = time.time_ns()
-            if v_true(debug, bool):
-                logger.info(f"timestamp: {timestamp}")
             # 空文件路径
-            file = f'/tmp/empty_file_{timestamp}.txt'
+            file = f'/tmp/none_{timestamp}.txt'
         # 创建一个空文件
-        if v_true(debug, bool):
-            logger.info(f"file: {file}")
         # pylint: disable=R1732
         open(file, "w", encoding="utf-8").close()
         # 返回文件路径
         return file
     except Exception as e:
-        if v_true(debug, bool):
-            logger.exception(e)
+        logger.exception(e)
         return None
 
 
@@ -1492,8 +1324,7 @@ def uuid4_hex() -> str:
 
 
 def increment_version(
-    version: str,
-    debug: bool = False
+    version: str
 ) -> str | None:
     """版本号递增"""
     try:
@@ -1501,8 +1332,7 @@ def increment_version(
         version_numbers[-1] = str(int(version_numbers[-1]) + 1)
         return '.'.join(version_numbers)
     except Exception as e:
-        if v_true(debug, bool):
-            logger.exception(e)
+        logger.exception(e)
         return None
 
 
@@ -1518,37 +1348,28 @@ def make_directory(
         os.makedirs(directory)
         return True
     except Exception as e:
-        if v_true(debug, bool):
-            logger.exception(e)
+        logger.exception(e)
         return False
 
 def change_directory(
-    directory: str,
-    debug: bool = False
+    directory: str
 ) -> bool:
     """改变目录"""
     try:
 
-        if not v_true(directory, str, debug=debug):
+        if not isTrue(directory, str):
             return False
 
-        if v_true(debug, bool):
-            logger.info(f"directory: {directory}")
-
-        if check_file_type(directory, 'dir', debug=debug):
-            if v_true(debug, bool):
-                logger.info(f"change directory to {directory}")
-            os.chdir(directory)
-            return True
-
-        if v_true(debug, bool):
+        if not check_file_type(directory, 'dir'):
             logger.error(f"no such directory: {directory}")
+            return False
 
-        return False
+        os.chdir(directory)
+
+        return True
 
     except Exception as e:
-        if v_true(debug, bool):
-            logger.exception(e)
+        logger.exception(e)
         return False
 
 
@@ -1556,23 +1377,19 @@ def change_directory(
 
 
 def load_toml_file(
-    file: str,
-    debug: bool = False
+    file: str
 ) -> dict | None:
     """Load TOML file"""
     info = '解析配置文件'
     try:
-        if v_true(debug, bool):
-            logger.info(f'{info}[执行]')
+        logger.info(f'{info}[执行]')
         with open(file, "rb") as _file:
             config = tomllib.load(_file)
-        if v_true(debug, bool):
-            logger.success(f'{info}[成功]')
+        logger.success(f'{info}[成功]')
         return config
     except Exception as e:
-        if v_true(debug, bool):
-            logger.error(f'{info}[失败]')
-            logger.exception(e)
+        logger.error(f'{info}[失败]')
+        logger.exception(e)
         return None
 
 
@@ -1581,35 +1398,33 @@ def git_clone(
     local_repository: str,
     timeout: int = 30,
     delete: bool = False,
-    log_prefix: str = '',
-    debug: bool = False,
+    log_prefix: str = ''
 ) -> bool:
     """GIT Clone"""
-    try:
 
-        # 日志前缀
-        log_prefix = f'{log_prefix}[GitClone]'
+    # 日志前缀
+    log_prefix = f'{log_prefix} [GitClone]'
+
+    try:
 
         # 获取应用程序Git仓库
-        if v_true(debug, bool):
-            logger.info(f'{log_prefix}process the request')
-            logger.info(f'{log_prefix}git repository: {git_repository}')
-            logger.info(f'{log_prefix}local repository: {local_repository}')
+        # logger.info(f'{log_prefix}process the request')
+        # logger.info(f'{log_prefix}git repository: {git_repository}')
+        # logger.info(f'{log_prefix}local repository: {local_repository}')
 
         # 删除本地仓库
-        if v_true(delete, bool):
-            delete_directory(local_repository, debug=debug)
+        if isTrue(delete, bool):
+            delete_directory(local_repository)
             time.sleep(1)
 
         # from shutil import which
-        # logger.info(which('timeout')) if v_true(debug, bool) else next
+        # logger.info(which('timeout')) if isTrue(debug, bool) else next
         # if which('timeout') != None:
         #     command = f'timeout -s 9 {timeout} git clone {git_repository} {local_repository}'
 
         # 克隆仓库
         result = shell(
             command=f'timeout -s 9 {timeout} git clone {git_repository} {local_repository}',
-            debug=debug,
             universal_newlines=True,
             stdout=subprocess.PIPE,
             stderr=subprocess.STDOUT
@@ -1621,42 +1436,34 @@ def git_clone(
         result_code: int = result.returncode
         result_info = result.stdout.splitlines()
 
-        if v_true(debug, bool):
-            logger.error(f'{log_prefix}unsuccessful')
+        if result_code != 0:
             for i in result_info:
                 logger.error(f'{log_prefix}{i}')
+            return False
 
-        if result_code == 0:
-            return True
-
-        return False
+        return True
 
     except Exception as e:
-        if v_true(debug, bool):
-            logger.error(f'{log_prefix}unsuccessful')
-            logger.exception(e)
+        logger.error(f'{log_prefix} [failure]')
+        logger.exception(e)
         return False
 
 
 def url_parse(
     url: str,
-    scheme: str = 'http',
-    debug: bool = False
+    scheme: str = 'http'
 ) -> ParseResult:
     """URL Parse"""
     none_result = ParseResult(scheme='', netloc='', path='', params='', query='', fragment='')
     try:
-        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):
+        if isTrue(url, str) and (url.find('://') == -1) and isTrue(scheme, str):
             url = f'{scheme}://{url}'
-        if v_true(url, str):
+        if isTrue(url, str):
             return urlparse(url)
         return none_result
     except Exception as e:
-        if v_true(debug, bool):
-            logger.exception(e)
+        logger.exception(e)
         return none_result
 
 # def debug_log(
@@ -1666,15 +1473,15 @@ def url_parse(
 #     error: bool = False
 # ):
 #     """debug log"""
-#     if v_true(log, str) and v_true(debug, bool):
-#         if v_true(error, bool):
+#     if isTrue(log, str) and isTrue(debug, bool):
+#         if isTrue(error, bool):
 #             logger.error(log)
 #         else:
 #             logger.info(log)
 #         return
 
-#     if v_true(exception, Exception):
-#         if v_true(debug, bool):
+#     if isTrue(exception, Exception):
+#         if isTrue(debug, bool):
 #             logger.exception(exception)
 #         else:
 #             logger.error(exception)