ezKit 1.12.0__py3-none-any.whl → 1.12.1__py3-none-any.whl

ezKit/utils.py

@@ -1,4 +1,5 @@
-"""Utils"""
+"""Utils Library"""
+
 import csv
 import hashlib
 import importlib
@@ -94,10 +95,7 @@ def check_arguments(data: list) -> bool:
 # --------------------------------------------------------------------------------------------------
 
 
-def os_environ(
-    name: str,
-    value: Any = None
-) -> Any:
+def os_environ(name: str, value: Any = None) -> Any:
     """系统变量"""
 
     # 伪全局变量
@@ -111,7 +109,7 @@ def os_environ(
     try:
 
         # 变量名添加一个前缀, 防止和系统中其它变量名冲突
-        _variable_name = f'PYTHON_VARIABLE_{name}'
+        _variable_name = f"PYTHON_VARIABLE_{name}"
 
         # 如果 value 的值是 None, 则从系统环境获取变量数据
         if value is None:
@@ -140,10 +138,7 @@ def os_environ(
 # --------------------------------------------------------------------------------------------------
 
 
-def mam_of_numbers(
-    numbers: list | tuple,
-    dest_type: str | None = None
-) -> tuple | None:
+def mam_of_numbers(numbers: list | tuple, dest_type: str | None = None) -> tuple | None:
     """返回一组数字中的 最大值(maximum), 平均值(average), 最小值(minimum)"""
 
     # numbers 数字列表 (仅支持 list 和 tuple, 不支 set)
@@ -190,8 +185,7 @@ def mam_of_numbers(
 
 
 def step_number_for_split_equally(
-    integer: int,
-    split_equally_number: int
+    integer: int, split_equally_number: int
 ) -> int | None:
     """
     step number for split equally
@@ -222,13 +216,12 @@ def step_number_for_split_equally(
 # --------------------------------------------------------------------------------------------------
 
 
-def division(
-    dividend: int | float,
-    divisor: int | float
-) -> float | None:
+def division(dividend: int | float, divisor: int | float) -> float | None:
     """Division"""
     # 检查参数是否正确
-    if not check_arguments([(dividend, (int, float), "dividend"), (divisor, (int, float), "divisor")]):
+    if not check_arguments(
+        [(dividend, (int, float), "dividend"), (divisor, (int, float), "divisor")]
+    ):
         return None
     try:
         return dividend / divisor
@@ -246,11 +239,9 @@ def format_float(number: float | int, index: int = 2, limit: int = 3) -> float |
     # 以两位和三位为例, 如果结果为假, 即: 0, 0.0, 0.00 等，保留小数点后的三位, 否则保留小数点后的两位.
 
     # 检查参数
-    if not check_arguments([
-        (number, (float, int), "number"),
-        (index, int, "index"),
-        (limit, int, "limit")
-    ]):
+    if not check_arguments(
+        [(number, (float, int), "number"), (index, int, "index"), (limit, int, "limit")]
+    ):
         return False
 
     try:
@@ -264,10 +255,7 @@ def format_float(number: float | int, index: int = 2, limit: int = 3) -> float |
 # --------------------------------------------------------------------------------------------------
 
 
-def check_file_type(
-    file_object: str,
-    file_type: str
-) -> bool:
+def check_file_type(file_object: str, file_type: str) -> bool:
     """检查文件类型"""
 
     # file_object 文件对象
@@ -284,25 +272,29 @@ def check_file_type(
         match True:
             case True if _file_path.exists() is False:
                 result = False
-            case True if file_type == 'absolute' and _file_path.is_absolute() is True:
+            case True if file_type == "absolute" and _file_path.is_absolute() is True:
                 result = True
-            case True if file_type == 'block_device' and _file_path.is_block_device() is True:
+            case True if (
+                file_type == "block_device" and _file_path.is_block_device() is True
+            ):
                 result = True
-            case True if file_type == 'dir' and _file_path.is_dir() is True:
+            case True if file_type == "dir" and _file_path.is_dir() is True:
                 result = True
-            case True if file_type == 'fifo' and _file_path.is_fifo() is True:
+            case True if file_type == "fifo" and _file_path.is_fifo() is True:
                 result = True
-            case True if file_type == 'file' and _file_path.is_file() is True:
+            case True if file_type == "file" and _file_path.is_file() is True:
                 result = True
-            case True if file_type == 'mount' and _file_path.is_mount() is True:
+            case True if file_type == "mount" and _file_path.is_mount() is True:
                 result = True
-            case True if file_type == 'relative_to' and _file_path.is_relative_to() is True:
+            # case True if (
+            #     file_type == "relative_to" and _file_path.is_relative_to() is True
+            # ):
+            #     result = True
+            case True if file_type == "reserved" and _file_path.is_reserved() is True:
                 result = True
-            case True if file_type == 'reserved' and _file_path.is_reserved() is True:
+            case True if file_type == "socket" and _file_path.is_socket() is True:
                 result = True
-            case True if file_type == 'socket' and _file_path.is_socket() is True:
-                result = True
-            case True if file_type == 'symlink' and _file_path.is_symlink() is True:
+            case True if file_type == "symlink" and _file_path.is_symlink() is True:
                 result = True
             case _:
                 result = False
@@ -317,11 +309,7 @@ def check_file_type(
 # --------------------------------------------------------------------------------------------------
 
 
-def list_sort(
-    data: list,
-    deduplication: bool = False,
-    **kwargs
-) -> list | None:
+def list_sort(data: list, deduplication: bool = False, **kwargs) -> list | None:
     """list sort"""
     # 列表排序, 示例: list_sort(['1.2.3.4', '2.3.4.5'], key=inet_aton)
     # 参考文档:
@@ -345,11 +333,7 @@ def list_sort(
         return None
 
 
-def list_dict_sorted_by_key(
-    data: list | tuple,
-    key: str,
-    **kwargs
-) -> list | None:
+def list_dict_sorted_by_key(data: list | tuple, key: str, **kwargs) -> list | None:
     """list dict sorted by key"""
     # 列表字典排序
     # 参考文档: https://stackoverflow.com/a/73050
@@ -360,11 +344,8 @@ def list_dict_sorted_by_key(
         logger.exception(e)
         return None
 
-def list_split(
-    data: list,
-    number: int,
-    equally: bool = False
-) -> list | None:
+
+def list_split(data: list, number: int, equally: bool = False) -> list | None:
     """列表分割"""
 
     # 列表分割
@@ -403,22 +384,22 @@ def list_split(
 
         # 将列表按每 n 个元素为一个列表进行分割
         it = iter(data)
-        return [list(islice(it, number)) for _ in range((len(data) + number - 1) // number)]
+        return [
+            list(islice(it, number)) for _ in range((len(data) + number - 1) // number)
+        ]
 
     except Exception as e:
         logger.exception(e)
         return None
 
 
-def list_print_by_step(
-    data: list,
-    step: int,
-    separator: str = " "
-) -> bool:
+def list_print_by_step(data: list, step: int, separator: str = " ") -> bool:
     """根据 步长 和 分隔符 有规律的打印列表中的数据"""
 
     # 检查参数是否正确
-    if not check_arguments([(data, list, "data"), (step, int, "step"), (separator, str, "separator")]):
+    if not check_arguments(
+        [(data, list, "data"), (step, int, "step"), (separator, str, "separator")]
+    ):
         return False
 
     try:
@@ -433,7 +414,7 @@ def list_print_by_step(
 
             # 每行最后一个 或者 所有数据最后一个, 不打印分隔符
             if ((i % step) == (step - 1)) or ((i + 1) == len(data)):
-                print(v, end='')
+                print(v, end="")
             else:
                 print(v, end=separator)
 
@@ -446,10 +427,7 @@ def list_print_by_step(
         return False
 
 
-def list_remove_list(
-    original: list,
-    remove: list
-) -> list | None:
+def list_remove_list(original: list, remove: list) -> list | None:
     """List remove List"""
     try:
         _original = deepcopy(original)
@@ -460,9 +438,7 @@ def list_remove_list(
         return None
 
 
-def list_merge(
-    data: list
-) -> list | None:
+def list_merge(data: list) -> list | None:
     """list merge"""
     # 合并 List 中的 List 为一个 List
     try:
@@ -475,14 +451,10 @@ def list_merge(
         return None
 
 
-def list_to_file(
-    data: list,
-    file: str,
-    encoding: str = 'utf-8-sig'
-) -> bool:
+def list_to_file(data: list, file: str, encoding: str = "utf-8-sig") -> bool:
     """list to file"""
     try:
-        with open(file, 'w', encoding=encoding) as _file:
+        with open(file, "w", encoding=encoding) as _file:
             for line in data:
                 _file.write(f"{line}\n")
         return True
@@ -490,16 +462,17 @@ def list_to_file(
         logger.exception(e)
         return False
 
+
 def list_to_csvfile(
     data: list,
     file: str,
     fields: list | None = None,
-    encoding: str = 'utf-8-sig',
-    **kwargs
+    encoding: str = "utf-8-sig",
+    **kwargs,
 ) -> bool:
     """list to csvfile"""
     try:
-        with open(file, 'w', encoding=encoding) as _file:
+        with open(file, "w", encoding=encoding) as _file:
             # CRLF replaced by LF
             # https://stackoverflow.com/a/29976091
             outcsv = csv.writer(_file, lineterminator=os.linesep, **kwargs)
@@ -511,12 +484,8 @@ def list_to_csvfile(
         logger.exception(e)
         return False
 
-def range_zfill(
-    start: int,
-    stop: int,
-    step: int,
-    width: int
-) -> list | None:
+
+def range_zfill(start: int, stop: int, step: int, width: int) -> list | None:
     """range zfill"""
     # 生成长度相同的字符串的列表
     # 示例: range_zfill(8, 13, 1, 2) => ['08', '09', '10', '11', '12']
@@ -534,10 +503,7 @@ def range_zfill(
 # --------------------------------------------------------------------------------------------------
 
 
-def dict_remove_key(
-    data: dict,
-    key: str
-) -> dict | None:
+def dict_remove_key(data: dict, key: str) -> dict | None:
     """dict remove key"""
     try:
         data_copy: dict = deepcopy(data)
@@ -547,15 +513,11 @@ def dict_remove_key(
         logger.exception(e)
         return None
 
-def dict_to_file(
-    data: dict,
-    file: str,
-    encoding: str = 'utf-8-sig',
-    **kwargs
-) -> bool:
+
+def dict_to_file(data: dict, file: str, encoding: str = "utf-8-sig", **kwargs) -> bool:
     """dict to file"""
     try:
-        with open(file, 'w', encoding=encoding) as _file:
+        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:
@@ -563,11 +525,7 @@ def dict_to_file(
         return False
 
 
-def dict_nested_update(
-    data: dict,
-    key: str,
-    value: Any
-) -> bool:
+def dict_nested_update(data: dict, key: str, value: Any) -> bool:
     """dict nested update"""
     # dictionary nested update
     # https://stackoverflow.com/a/58885744
@@ -602,10 +560,7 @@ def dict_nested_update(
 # --------------------------------------------------------------------------------------------------
 
 
-def filename(
-    file: str,
-    split: str = '.'
-) -> str | None:
+def filename(file: str, split: str = ".") -> str | None:
     """filename"""
     # 获取文件名称
     # https://stackoverflow.com/questions/678236/how-do-i-get-the-filename-without-the-extension-from-a-path-in-python
@@ -619,10 +574,7 @@ def filename(
         return None
 
 
-def filehash(
-    file: str,
-    sha: str = 'md5'
-) -> str | None:
+def filehash(file: str, sha: str = "md5") -> str | None:
     """filehash"""
     # 获取文件Hash
     # 参考文档:
@@ -631,23 +583,23 @@ def filehash(
     try:
         with open(file, "rb") as _file:
             match True:
-                case True if sha == 'sha1':
+                case True if sha == "sha1":
                     file_hash = hashlib.sha1()
-                case True if sha == 'sha224':
+                case True if sha == "sha224":
                     file_hash = hashlib.sha224()
-                case True if sha == 'sha256':
+                case True if sha == "sha256":
                     file_hash = hashlib.sha256()
-                case True if sha == 'sha384':
+                case True if sha == "sha384":
                     file_hash = hashlib.sha384()
-                case True if sha == 'sha512':
+                case True if sha == "sha512":
                     file_hash = hashlib.sha512()
-                case True if sha == 'sha3_224':
+                case True if sha == "sha3_224":
                     file_hash = hashlib.sha3_224()
-                case True if sha == 'sha3_256':
+                case True if sha == "sha3_256":
                     file_hash = hashlib.sha3_256()
-                case True if sha == 'sha3_384':
+                case True if sha == "sha3_384":
                     file_hash = hashlib.sha3_384()
-                case True if sha == 'sha3_512':
+                case True if sha == "sha3_512":
                     file_hash = hashlib.sha3_512()
                 # case True if sha == 'shake_128':
                 #     file_hash = hashlib.shake_128()
@@ -666,9 +618,7 @@ def filehash(
         return None
 
 
-def filesize(
-    file: str
-) -> int | None:
+def filesize(file: str) -> int | None:
     """filesize"""
     # 获取文件大小
     try:
@@ -701,10 +651,7 @@ def filesize(
 #         return None
 
 
-def realpath(
-    path: str,
-    **kwargs
-) -> str | None:
+def realpath(path: str, **kwargs) -> str | None:
     """获取对象真实路径"""
     try:
         if not isTrue(path, str):
@@ -715,10 +662,7 @@ def realpath(
         return None
 
 
-def current_dir(
-    path: str,
-    **kwargs
-) -> str | None:
+def current_dir(path: str, **kwargs) -> str | None:
     """获取对象所在目录"""
     try:
         if not isTrue(path, str):
@@ -729,10 +673,7 @@ def current_dir(
         return None
 
 
-def parent_dir(
-    path: str,
-    **kwargs
-) -> str | None:
+def parent_dir(path: str, **kwargs) -> str | None:
     """获取对象所在目录的父目录"""
     try:
         if not isTrue(path, str):
@@ -759,7 +700,7 @@ def retry(func: Callable, times: int = 3, **kwargs) -> Any:
         except Exception as e:
             logger.exception(e)
             if attempt < (times - 1):
-                logger.info('retrying ...')
+                logger.info("retrying ...")
             else:
                 logger.error("all retries failed")
                 return False
@@ -811,9 +752,7 @@ def retry(func: Callable, times: int = 3, **kwargs) -> Any:
 #     datetime.fromisoformat(time.strftime(format, time.gmtime(dt)))
 
 
-def date_to_datetime(
-    date_object: datetime
-) -> datetime | None:
+def date_to_datetime(date_object: datetime) -> datetime | None:
     """'日期'转换为'日期时间'"""
     # https://stackoverflow.com/a/1937636
     try:
@@ -823,9 +762,7 @@ def date_to_datetime(
         return None
 
 
-def datetime_to_date(
-    datetime_instance: datetime
-) -> date | None:
+def datetime_to_date(datetime_instance: datetime) -> date | None:
     """'日期时间'转换为'日期'"""
     # https://stackoverflow.com/a/3743240
     try:
@@ -853,8 +790,7 @@ def datetime_now(**kwargs) -> datetime | None:
 
 
 def datetime_offset(
-    datetime_instance: datetime | None = None,
-    **kwargs
+    datetime_instance: datetime | None = None, **kwargs
 ) -> datetime | None:
     """
     获取 '向前或向后特定日期时间' 的日期和时间
@@ -877,8 +813,7 @@ def datetime_offset(
 
 
 def datetime_to_string(
-    datetime_instance: datetime,
-    string_format: str = '%Y-%m-%d %H:%M:%S'
+    datetime_instance: datetime, string_format: str = "%Y-%m-%d %H:%M:%S"
 ) -> str | None:
     """'日期时间'转换为'字符串'"""
     try:
@@ -890,10 +825,7 @@ def datetime_to_string(
         return None
 
 
-def datetime_to_timestamp(
-    datetime_instance: datetime,
-    utc: bool = False
-) -> int | None:
+def datetime_to_timestamp(datetime_instance: datetime, utc: bool = False) -> int | None:
     """
     Datatime 转换为 Unix Timestamp
     Local datetime 可以直接转换为 Unix Timestamp
@@ -902,15 +834,18 @@ def datetime_to_timestamp(
     try:
         if not isTrue(datetime_instance, datetime):
             return None
-        return int(datetime_instance.replace(tzinfo=timezone.utc).timestamp()) if utc is True else int(datetime_instance.timestamp())
+        return (
+            int(datetime_instance.replace(tzinfo=timezone.utc).timestamp())
+            if utc is True
+            else int(datetime_instance.timestamp())
+        )
     except Exception as e:
         logger.exception(e)
         return None
 
 
 def datetime_local_to_timezone(
-    datetime_instance: datetime,
-    tz: timezone = timezone.utc
+    datetime_instance: datetime, tz: timezone = timezone.utc
 ) -> datetime | None:
     """
     Local datetime to TimeZone datetime(默认转换为 UTC datetime)
@@ -919,7 +854,9 @@ def datetime_local_to_timezone(
     try:
         if not isTrue(datetime_instance, datetime):
             return None
-        return (datetime.fromtimestamp(datetime_instance.timestamp(), tz=tz)).replace(tzinfo=None)
+        return (datetime.fromtimestamp(datetime_instance.timestamp(), tz=tz)).replace(
+            tzinfo=None
+        )
     except Exception as e:
         logger.exception(e)
         return None
@@ -927,7 +864,7 @@ def datetime_local_to_timezone(
 
 def datetime_utc_to_timezone(
     datetime_instance: datetime,
-    tz: Any = datetime.now(timezone.utc).astimezone().tzinfo
+    tz: Any = datetime.now(timezone.utc).astimezone().tzinfo,
 ) -> datetime | None:
     """
     UTC datetime to TimeZone datetime(默认转换为 Local datetime)
@@ -936,7 +873,11 @@ def datetime_utc_to_timezone(
     try:
         if not isTrue(datetime_instance, datetime):
             return None
-        return datetime_instance.replace(tzinfo=timezone.utc).astimezone(tz).replace(tzinfo=None)
+        return (
+            datetime_instance.replace(tzinfo=timezone.utc)
+            .astimezone(tz)
+            .replace(tzinfo=None)
+        )
 
     except Exception as e:
         logger.exception(e)
@@ -944,8 +885,7 @@ def datetime_utc_to_timezone(
 
 
 def timestamp_to_datetime(
-    timestamp: int,
-    tz: timezone = timezone.utc
+    timestamp: int, tz: timezone = timezone.utc
 ) -> datetime | None:
     """Unix Timestamp 转换为 Datatime"""
     try:
@@ -958,8 +898,7 @@ def timestamp_to_datetime(
 
 
 def datetime_string_to_datetime(
-    datetime_string: str,
-    datetime_format: str = '%Y-%m-%d %H:%M:%S'
+    datetime_string: str, datetime_format: str = "%Y-%m-%d %H:%M:%S"
 ) -> datetime | None:
     """datetime string to datetime"""
     try:
@@ -972,8 +911,7 @@ def datetime_string_to_datetime(
 
 
 def datetime_string_to_timestamp(
-    datetime_string: str,
-    datetime_format: str = '%Y-%m-%d %H:%M:%S'
+    datetime_string: str, datetime_format: str = "%Y-%m-%d %H:%M:%S"
 ) -> int | None:
     """datetime string to timestamp"""
     try:
@@ -985,18 +923,16 @@ def datetime_string_to_timestamp(
         return None
 
 
-def datetime_object(
-    date_time: datetime
-) -> dict | None:
+def datetime_object(date_time: datetime) -> dict | None:
     """datetime object"""
     try:
         return {
-            'date': date_time.strftime("%Y-%m-%d"),
-            'time': date_time.strftime("%H:%M:%S"),
-            'datetime_now': date_time.strftime("%Y-%m-%d %H:%M:%S"),
-            'datetime_minute': date_time.strftime("%Y-%m-%d %H:%M:00"),
-            'datetime_hour': date_time.strftime("%Y-%m-%d %H:00:00"),
-            'datetime_zero': date_time.strftime('%Y-%m-%d 00:00:00')
+            "date": date_time.strftime("%Y-%m-%d"),
+            "time": date_time.strftime("%H:%M:%S"),
+            "datetime_now": date_time.strftime("%Y-%m-%d %H:%M:%S"),
+            "datetime_minute": date_time.strftime("%Y-%m-%d %H:%M:00"),
+            "datetime_hour": date_time.strftime("%Y-%m-%d %H:00:00"),
+            "datetime_zero": date_time.strftime("%Y-%m-%d 00:00:00"),
         }
     except Exception as e:
         logger.exception(e)
@@ -1011,7 +947,7 @@ def shell(
     isfile: bool = False,
     sh_shell: str = "/bin/bash",
     sh_option: str | None = None,
-    **kwargs
+    **kwargs,
 ) -> subprocess.CompletedProcess | None:
     """执行 Shell 命令 或 脚本"""
 
@@ -1036,7 +972,11 @@ def shell(
 
         # 构造命令
         if isfile:
-            args = [sh_shell, command] if sh_option is None else [sh_shell, sh_option, command]
+            args = (
+                [sh_shell, command]
+                if sh_option is None
+                else [sh_shell, sh_option, command]
+            )
         else:
             sh_option = sh_option or "-c"
             args = [sh_shell, sh_option, command]
@@ -1053,12 +993,10 @@ def shell(
 # --------------------------------------------------------------------------------------------------
 
 
-def json_file_parser(
-    file: str
-) -> dict | None:
+def json_file_parser(file: str) -> dict | None:
     """JSON File Parser"""
     try:
-        if not check_file_type(file, 'file'):
+        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:
@@ -1068,6 +1006,7 @@ def json_file_parser(
         logger.exception(e)
         return None
 
+
 # json_raw = '''
 # {
 #     "markdown.preview.fontSize": 14,
@@ -1087,10 +1026,7 @@ def json_file_parser(
 # }
 
 
-def json_sort(
-    string: str,
-    **kwargs
-) -> str | None:
+def json_sort(string: str, **kwargs) -> str | None:
     """JSON Sort"""
     try:
         if not isTrue(string, str):
@@ -1104,15 +1040,13 @@ def json_sort(
 # --------------------------------------------------------------------------------------------------
 
 
-def delete_files(
-    files: str | list
-) -> bool:
+def delete_files(files: str | list) -> bool:
     """删除文件"""
     try:
 
-        if isinstance(files, str) and check_file_type(files, 'file'):
+        if isinstance(files, str) and check_file_type(files, "file"):
             os.remove(files)
-            logger.success(f'deleted file: {files}')
+            logger.success(f"deleted file: {files}")
             return True
 
         if not isTrue(files, list):
@@ -1120,14 +1054,14 @@ def delete_files(
 
         for _file in files:
 
-            if isinstance(_file, str) and check_file_type(_file, 'file'):
+            if isinstance(_file, str) and check_file_type(_file, "file"):
                 try:
                     os.remove(_file)
-                    logger.success(f'deleted file: {_file}')
+                    logger.success(f"deleted file: {_file}")
                 except Exception as e:
-                    logger.error(f'error file: {_file} {e}')
+                    logger.error(f"error file: {_file} {e}")
             else:
-                logger.error(f'error file: {_file}')
+                logger.error(f"error file: {_file}")
 
         return True
 
@@ -1164,25 +1098,25 @@ def delete_directory(
     """
     try:
 
-        if isinstance(directory, str) and check_file_type(directory, 'dir'):
+        if isinstance(directory, str) and check_file_type(directory, "dir"):
             rmtree(directory)
-            logger.success(f'deleted directory: {directory}')
+            logger.success(f"deleted directory: {directory}")
             return True
 
         if not isTrue(directory, list):
-            logger.error(f'error directory: {directory}')
+            logger.error(f"error directory: {directory}")
             return False
 
         for _dir in directory:
 
-            if isTrue(_dir, str) and check_file_type(_dir, 'dir'):
+            if isTrue(_dir, str) and check_file_type(_dir, "dir"):
                 try:
                     rmtree(_dir)
-                    logger.success(f'deleted directory: {_dir}')
+                    logger.success(f"deleted directory: {_dir}")
                 except Exception as e:
-                    logger.error(f'error directory: {_dir} {e}')
+                    logger.error(f"error directory: {_dir} {e}")
             else:
-                logger.error(f'error directory: {_dir}')
+                logger.error(f"error directory: {_dir}")
 
         return True
 
@@ -1199,7 +1133,7 @@ def processor(
     process_data: list,
     process_num: int = 2,
     thread: bool = False,
-    **kwargs
+    **kwargs,
 ) -> Any:
     """使用多线程或多进程对数据进行并行处理"""
 
@@ -1257,16 +1191,14 @@ def processor(
 # --------------------------------------------------------------------------------------------------
 
 
-def create_empty_file(
-    file: str | None = None
-) -> str | None:
+def create_empty_file(file: str | None = None) -> str | None:
     """create empty file"""
     try:
         if file is None:
             # 当前时间戳(纳秒)
             timestamp = time.time_ns()
             # 空文件路径
-            file = f'/tmp/none_{timestamp}.txt'
+            file = f"/tmp/none_{timestamp}.txt"
         # 创建一个空文件
         # pylint: disable=R1732
         open(file, "w", encoding="utf-8").close()
@@ -1285,14 +1217,12 @@ def uuid4_hex() -> str:
     return uuid4().hex
 
 
-def increment_version(
-    version: str
-) -> str | None:
+def increment_version(version: str) -> str | None:
     """版本号递增"""
     try:
-        version_numbers = version.split('.')
+        version_numbers = version.split(".")
         version_numbers[-1] = str(int(version_numbers[-1]) + 1)
-        return '.'.join(version_numbers)
+        return ".".join(version_numbers)
     except Exception as e:
         logger.exception(e)
         return None
@@ -1301,9 +1231,7 @@ def increment_version(
 # --------------------------------------------------------------------------------------------------
 
 
-def make_directory(
-    directory: str
-) -> bool:
+def make_directory(directory: str) -> bool:
     """创建目录"""
     try:
         os.makedirs(directory)
@@ -1312,16 +1240,15 @@ def make_directory(
         logger.exception(e)
         return False
 
-def change_directory(
-    directory: str
-) -> bool:
+
+def change_directory(directory: str) -> bool:
     """改变目录"""
     try:
 
         if not isTrue(directory, str):
             return False
 
-        if not check_file_type(directory, 'dir'):
+        if not check_file_type(directory, "dir"):
             logger.error(f"no such directory: {directory}")
             return False
 
@@ -1337,19 +1264,17 @@ def change_directory(
 # --------------------------------------------------------------------------------------------------
 
 
-def load_toml_file(
-    file: str
-) -> dict | None:
+def load_toml_file(file: str) -> dict | None:
     """Load TOML file"""
-    info = '解析配置文件'
+    info = "解析配置文件"
     try:
-        logger.info(f'{info}[执行]')
+        logger.info(f"{info}[执行]")
         with open(file, "rb") as _file:
             config = tomllib.load(_file)
-        logger.success(f'{info}[成功]')
+        logger.success(f"{info}[成功]")
         return config
     except Exception as e:
-        logger.error(f'{info}[失败]')
+        logger.error(f"{info}[失败]")
         logger.exception(e)
         return None
 
@@ -1359,12 +1284,12 @@ def git_clone(
     local_repository: str,
     timeout: int = 30,
     delete: bool = False,
-    log_prefix: str = ''
+    log_prefix: str = "",
 ) -> bool:
     """GIT Clone"""
 
     # 日志前缀
-    log_prefix = f'{log_prefix} [GitClone]'
+    log_prefix = f"{log_prefix} [GitClone]"
 
     try:
 
@@ -1385,10 +1310,10 @@ def git_clone(
 
         # 克隆仓库
         result = shell(
-            command=f'timeout -s 9 {timeout} git clone {git_repository} {local_repository}',
+            command=f"timeout -s 9 {timeout} git clone {git_repository} {local_repository}",
             universal_newlines=True,
             stdout=subprocess.PIPE,
-            stderr=subprocess.STDOUT
+            stderr=subprocess.STDOUT,
         )
 
         if result is None:
@@ -1399,19 +1324,19 @@ def git_clone(
 
         if result_code != 0:
             for i in result_info:
-                logger.error(f'{log_prefix}{i}')
+                logger.error(f"{log_prefix}{i}")
             return False
 
         return True
 
     except Exception as e:
-        logger.error(f'{log_prefix} [failed]')
+        logger.error(f"{log_prefix} [failed]")
         logger.exception(e)
         return False
 
 
 def url_parse(
-    url: str
+    url: str,
     # scheme: str = "http"
 ) -> ParseResult | None:
     """URL Parse"""
@@ -1430,6 +1355,7 @@ def url_parse(
         logger.exception(e)
         return None
 
+
 # def debug_log(
 #     log: None | str = None,
 #     exception: None | Exception = None,
@@ -1462,11 +1388,13 @@ def markdown_to_html(markdown_file: str, html_file: str, title: str) -> bool:
 
         logger.info(f"{info} [开始]")
 
-        if not check_arguments([
-            (markdown_file, str, "markdown_to_html -> markdown_file"),
-            (html_file, str, "markdown_to_html -> html_file"),
-            (title, str, "markdown_to_html -> title"),
-        ]):
+        if not check_arguments(
+            [
+                (markdown_file, str, "markdown_to_html -> markdown_file"),
+                (html_file, str, "markdown_to_html -> html_file"),
+                (title, str, "markdown_to_html -> title"),
+            ]
+        ):
             return False
 
         # 读取 HTML模版 文件
@@ -1483,7 +1411,7 @@ def markdown_to_html(markdown_file: str, html_file: str, title: str) -> bool:
         # 将 Markdown 转换为 HTML
         logger.info(f"{info} [将 Markdown 转换为 HTML]")
         # pylint: disable=E0606
-        html_body = markdown.markdown(markdown_content, extensions=['tables'])  # type: ignore
+        html_body = markdown.markdown(markdown_content, extensions=["tables"])  # type: ignore
         # pylint: enable=E0606
 
         # 构造完整的 HTML
@@ -1493,7 +1421,7 @@ def markdown_to_html(markdown_file: str, html_file: str, title: str) -> bool:
 
         # 保存为 HTML 文件
         logger.info(f"{info} [保存为 HTML 文件: {html_file}]")
-        with open(html_file, "w", encoding='utf-8') as _:
+        with open(html_file, "w", encoding="utf-8") as _:
             _.write(html_content)
 
         logger.success(f"{info} [成功]")