ezKit 1.9.8__py3-none-any.whl → 1.9.10__py3-none-any.whl

ezKit/utils.py

@@ -8,6 +8,7 @@ import subprocess
 import time
 import tomllib
 from copy import deepcopy
+from itertools import islice
 from multiprocessing import Pool, Process
 from multiprocessing.pool import ThreadPool
 from pathlib import Path
@@ -29,15 +30,10 @@ NoneType = type(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
-) -> bool:
-    """检查对象类型以及对象数据是否为 True"""
+def isTrue(target: object, typeClass: Any) -> bool:
+    """检查对象是否为真"""
 
-    # 常见类型:
+    # 常见布尔类型:
     #
     #     Boolean     bool            False
     #     Numbers     int/float       0/0.0
@@ -59,44 +55,33 @@ def isTrue(
     # all() 用于检查一个可迭代对象(如列表、元组、集合等)中的 所有 元素是否为 真值 (truthy), 所有元素为真, 返回 True
     # any() 用于检查一个可迭代对象(如列表、元组、集合等)中的 某个 元素是否为 真值 (truthy), 某个元素为真, 返回 True
     # 与 all() 作用相反的 not any(), 可以用来检查所有元素是否为 假值 (falsy), any() 中所有元素为假, not any() 返回 True
+    #
+    # return target not in [False, None, 0, 0.0, '', (), [], {}, {*()}, {*[]}, {*{}}]
 
     try:
+        return isinstance(target, typeClass) and bool(target)
+    except Exception as e:
+        logger.exception(e)
+        return False
 
-        if isinstance(object_data, object_type):
-
-            if all(
-                [
-                    true_list is not None,
-                    false_list is None,
-                    isinstance(true_list, (list, tuple, set, str))
-                ]
-            ):
-                return object_data in true_list
-
-            if all(
-                [
-                    true_list is None,
-                    false_list is not None,
-                    isinstance(false_list, (list, tuple, set, str))
-                ]
-            ):
-                return object_data 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 (object_data in true_list) and (object_data not in false_list)
-
-            # return object_data not in [False, None, 0, 0.0, '', (), [], {}, {*()}, {*[]}, {*{}}]
-            return bool(object_data)
 
-        return False
+# --------------------------------------------------------------------------------------------------
+
+
+def check_arguments(data: list) -> bool:
+    """检查函数参数"""
 
+    # data 示例: [(name, str, "name"), (age, int, "age")]
+
+    try:
+        if not isTrue(data, list):
+            logger.error("argument error: data")
+            return False
+        for arg, arg_type, arg_name in data:
+            if not isTrue(arg, arg_type):
+                logger.error(f"argument error: {arg_name}")
+                return False
+        return True
     except Exception as e:
         logger.exception(e)
         return False
@@ -115,13 +100,9 @@ def os_environ(
     # Python 没有全局变量, 多个文件无法调用同一个变量.
     # 为了解决这个问题, 将变量设置为系统变量, 从而实现多个文件调用同一个变量.
 
-    # 判断参数是否正确
-    match True:
-        case True if not isTrue(name, str):
-            logger.error("argument error: name")
-            return None
-        case _:
-            pass
+    # 检查参数是否正确
+    if not check_arguments([(name, str, "name")]):
+        return None
 
     try:
 
@@ -164,29 +145,24 @@ def mam_of_numbers(
     # numbers 数字列表 (仅支持 list 和 tuple, 不支 set)
     # dest_type 目标类型 (将数字列表中的数字转换成统一的类型)
 
-    # 判断参数是否正确
-    match True:
-        case True if not isTrue(numbers, (list, tuple)):
-            logger.error("argument error: numbers")
-            return None
-        case True if not any([isTrue(dest_type, str), dest_type is None]):
-            logger.error("argument error: dest_type")
-            return None
-        case _:
-            pass
+    # 检查参数是否正确
+    if not check_arguments([(numbers, (list, tuple), "numbers")]):
+        return None
+
+    if not any([isTrue(dest_type, str), dest_type is None]):
+        logger.error("argument error: dest_type")
+        return None
 
     try:
 
         _numbers = deepcopy(numbers)
 
         # 转换数据类型
-        match True:
-            case True if dest_type == "float":
-                _numbers = [float(i) for i in numbers]
-            case True if dest_type == "int":
-                _numbers = [int(i) for i in numbers]
-            case _:
-                pass
+        if dest_type == "float":
+            _numbers = [float(i) for i in numbers]
+
+        if dest_type == "int":
+            _numbers = [int(i) for i in numbers]
 
         # 提取数据
         _num_max = max(_numbers)
@@ -247,6 +223,9 @@ def division(
     divisor: int | float
 ) -> float | None:
     """Division"""
+    # 检查参数是否正确
+    if not check_arguments([(dividend, (int, float), "dividend"), (divisor, (int, float), "divisor")]):
+        return None
     try:
         return dividend / divisor
     except Exception as e:
@@ -261,14 +240,15 @@ def check_file_type(
     file_object: str,
     file_type: str
 ) -> bool:
-    """
-    check file type
+    """检查文件类型"""
 
-    检查文件类型
+    # file_object 文件对象
+    # file_type 文件类型
+
+    # 检查参数是否正确
+    if not check_arguments([(file_object, str, "file"), (file_type, str, "file_type")]):
+        return False
 
-        file_object 文件对象
-        file_type 文件类型
-    """
     try:
 
         _file_path = Path(file_object)
@@ -352,90 +332,57 @@ def list_dict_sorted_by_key(
         logger.exception(e)
         return None
 
-
 def list_split(
     data: list,
     number: int,
     equally: bool = False
 ) -> list | None:
-    """list split"""
+    """列表分割"""
+
     # 列表分割
     #
-    # 默认: 将 list 以 number个元素为一个list 分割
+    # 默认: 将 list 以 number 个元素为一个子 list 分割
     #
-    #     data = [1, 2, 3, 4, 5, 6, 7]
+    #   data = [1, 2, 3, 4, 5, 6, 7]                                奇数个元素
+    #   list_split(data, 2) -> [[1, 2], [3, 4], [5, 6], [7]]        将 data 以 2个元素 为一个 list 分割
+    #   list_split(data, 3) -> [[1, 2, 3], [4, 5, 6], [7]]          将 data 以 3个元素 为一个 list 分割
     #
-    #     list_split(data, 2) -> 将 data 以 2个元素为一个 list 分割
-    #     [[1, 2], [3, 4], [5, 6], [7]]
+    #   data = [1, 2, 3, 4, 5, 6, 7, 8]                             偶数个元素
+    #   list_split(data, 2) -> [[1, 2], [3, 4], [5, 6], [7, 8]]     将 data 以 2个元素 为一个 list 分割
+    #   list_split(data, 3) -> [[1, 2, 3], [4, 5, 6], [7, 8]]       将 data 以 3个元素 为一个 list 分割
     #
-    #     list_split(data, 3) -> 将 data 以 3个元素为一个 list 分割
-    #     [[1, 2, 3], [4, 5, 6], [7]]
+    # equally 为 True 时, 将 list 平均分成 number 个元素的子 list
     #
-    # equally 为 True 时, 将 data 平均分成 number 份
+    #   data = [1, 2, 3, 4, 5, 6, 7]                                奇数个元素
+    #   list_split(data, 2, True) -> [[1, 2, 3, 4], [5, 6, 7]]      将 data 平均分成 2个子list
+    #   list_split(data, 3, True) -> [[1, 2, 3], [4, 5, 6], [7]]    将 data 平均分成 3个子list
     #
-    #     data = [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19]
-    #
-    #     list_split_equally(data, 5) -> 将 data 平均分成 5 份
-    #     [[1, 2, 3, 4], [5, 6, 7, 8], [9, 10, 11, 12], [13, 14, 15, 16], [17, 18, 19]]
-    #
-    #     list_split_equally(data, 6) -> 将 data 平均分成 6 份
-    #     [[1, 2, 3, 4], [5, 6, 7], [8, 9, 10], [11, 12, 13], [14, 15, 16], [17, 18, 19]]
-    #
-    #     list_split_equally(data, 7) -> 将 data 平均分成 7 份
-    #     [[1, 2, 3], [4, 5, 6], [7, 8, 9], [10, 11, 12], [13, 14, 15], [16, 17], [18, 19]]
-
-    try:
-
-        # 数据拷贝
-        _data_object = deepcopy(data)
-
-        # 数据长度
-        _data_length = len(_data_object)
-
-        # 数据平分后的结果
-        _data_result = []
-
-        _step_number: Optional[int] = None
+    #   data = [1, 2, 3, 4, 5, 6, 7, 8]                             偶数个元素
+    #   list_split(data, 2, True) -> [[1, 2, 3, 4], [5, 6, 7, 8]]   将 data 平均分成 2个子list
+    #   list_split(data, 3, True) -> [[1, 2, 3], [4, 5, 6], [7, 8]] 将 data 平均分成 3个子list
 
-        if _data_length < number:
+    # 判断参数是否正确
+    match True:
+        case True if not isTrue(data, list):
+            logger.error("argument error: data")
             return None
+        case True if not isTrue(number, int):
+            logger.error("argument error: number")
+            return None
+        case _:
+            pass
 
-        if _data_length == number:
-
-            _data_result = [[i] for i in _data_object]
-
-        else:
-
-            if isTrue(equally, bool):
-
-                _step_number = step_number_for_split_equally(_data_length, number)
-
-                if _data_length % number == 0:
-
-                    index_number_list = list(range(0, _data_length, number))
-                    for index_number in index_number_list:
-                        _data_result.append(deepcopy(_data_object[index_number:index_number + number]))
-
-                else:
-
-                    # 前一部分
-                    if _step_number is not None:
-                        previous_end_number = (_data_length % number) * _step_number
-                        previous_index_number_list = list(range(0, previous_end_number, _step_number))
-                        for index_number in previous_index_number_list:
-                            _data_result.append(deepcopy(_data_object[index_number:index_number + _step_number]))
-
-                        # 后一部分
-                        next_number_list = list(range(previous_end_number, _data_length, _step_number - 1))
-                        for index_number in next_number_list:
-                            _data_result.append(deepcopy(_data_object[index_number:index_number + (_step_number - 1)]))
-
-            else:
+    try:
 
-                for index_number in list(range(0, _data_length, number)):
-                    _data_result.append(deepcopy(_data_object[index_number:index_number + number]))
+        # 要将列表平均分成 n 个子列表
+        if isTrue(equally, bool):
+            it = iter(data)
+            chunk_size = (len(data) + number - 1) // number  # 每组至少多少个元素
+            return [list(islice(it, chunk_size)) for _ in range(number)]
 
-        return _data_result
+        # 将列表按每 n 个元素为一个列表进行分割
+        it = iter(data)
+        return [list(islice(it, number)) for _ in range((len(data) + number - 1) // number)]
 
     except Exception as e:
         logger.exception(e)

{ezKit-1.9.8.dist-info → ezKit-1.9.10.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: ezKit
-Version: 1.9.8
+Version: 1.9.10
 Summary: Easy Kit
 Author: septvean
 Author-email: septvean@gmail.com

{ezKit-1.9.8.dist-info → ezKit-1.9.10.dist-info}/RECORD

@@ -11,10 +11,10 @@ ezKit/redis.py,sha256=g2_V4jvq0djRc20jLZkgeAeF_bYrq-Rbl_kHcCUPZcA,1965
 ezKit/sendemail.py,sha256=tRXCsJm_RfTJ9xEWe_lTQ5kOs2JxHGPXvq0oWA7prq0,7263
 ezKit/stock.py,sha256=cbL0ZXCur4G290wFN5ynmLmMjgDRNSvVQgsE_0jSQKU,11802
 ezKit/token.py,sha256=HKREyZj_T2S8-aFoFIrBXTaCKExQq4zE66OHXhGHqQg,1750
-ezKit/utils.py,sha256=-gvuVXSoYRIjjuHfE0WYr2BegetpFCfY-juo3253FMs,43900
+ezKit/utils.py,sha256=TDsL3PRkQy6NdZgphkgwacbWvHqEmq4LOkfNzmxV4DY,42682
 ezKit/xftp.py,sha256=XyIdr_2rxRVLqPofG6fIYWhAMVsFwTyp46dg5P9FLW4,7774
-ezKit-1.9.8.dist-info/LICENSE,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
-ezKit-1.9.8.dist-info/METADATA,sha256=wCl9POdJB7m1pfOX7wQYCreg9jUg49M4DeR2jZEUBDk,190
-ezKit-1.9.8.dist-info/WHEEL,sha256=PZUExdf71Ui_so67QXpySuHtCi3-J3wvF4ORK6k_S8U,91
-ezKit-1.9.8.dist-info/top_level.txt,sha256=aYLB_1WODsqNTsTFWcKP-BN0KCTKcV-HZJ4zlHkCFw8,6
-ezKit-1.9.8.dist-info/RECORD,,
+ezKit-1.9.10.dist-info/LICENSE,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
+ezKit-1.9.10.dist-info/METADATA,sha256=7xdrfPXxnqwajfaZzvzvayL0KDLsfjstCk-j_f_gA5k,191
+ezKit-1.9.10.dist-info/WHEEL,sha256=PZUExdf71Ui_so67QXpySuHtCi3-J3wvF4ORK6k_S8U,91
+ezKit-1.9.10.dist-info/top_level.txt,sha256=aYLB_1WODsqNTsTFWcKP-BN0KCTKcV-HZJ4zlHkCFw8,6
+ezKit-1.9.10.dist-info/RECORD,,