hutool-python 1.0.0__py3-none-any.whl

hutool/core/util/class_util.py

@@ -0,0 +1,136 @@
+import importlib
+from typing import Any, List, Type
+
+
+class ClassUtil:
+    """类工具类
+
+    提供对Python类和对象的常用操作方法，包括获取类名、模块名、类型判断等。
+    """
+
+    @staticmethod
+    def get_class_name(obj: Any, is_simple: bool = True) -> str:
+        """获取类名
+
+        :param obj: 对象或类
+        :param is_simple: 是否返回简单类名（不含模块路径），默认True
+        :return: 类名字符串
+        """
+        if isinstance(obj, type):
+            cls = obj
+        else:
+            cls = type(obj)
+
+        if is_simple:
+            return cls.__name__
+        else:
+            module = cls.__module__
+            if module == "builtins":
+                return cls.__name__
+            return f"{module}.{cls.__name__}"
+
+    @staticmethod
+    def get_package_name(obj: Any) -> str:
+        """获取模块名
+
+        :param obj: 对象或类
+        :return: 模块名字符串
+        """
+        if isinstance(obj, type):
+            cls = obj
+        else:
+            cls = type(obj)
+
+        return cls.__module__
+
+    @staticmethod
+    def is_basic_type(obj: Any) -> bool:
+        """是否为基本类型
+
+        基本类型包括：int, float, str, bool, bytes, complex, type(None)
+
+        :param obj: 待检查的对象
+        :return: 是否为基本类型
+        """
+        basic_types = (int, float, str, bool, bytes, complex, type(None))
+        return isinstance(obj, basic_types)
+
+    @staticmethod
+    def is_instance(obj: Any, class_or_tuple: Any) -> bool:
+        """是否为指定类型的实例
+
+        :param obj: 待检查的对象
+        :param class_or_tuple: 类或类的元组
+        :return: 是否为指定类型的实例
+        """
+        return isinstance(obj, class_or_tuple)
+
+    @staticmethod
+    def get_public_fields(obj: Any) -> List[str]:
+        """获取公开字段
+
+        返回对象中不以单下划线开头的属性名称列表。
+
+        :param obj: 对象
+        :return: 公开字段名列表
+        """
+        return [attr for attr in dir(obj) if not attr.startswith("_") and not callable(getattr(obj, attr, None))]
+
+    @staticmethod
+    def get_methods(obj: Any) -> List[str]:
+        """获取方法列表
+
+        返回对象中不以单下划线开头的方法名称列表。
+
+        :param obj: 对象或类
+        :return: 方法名列表
+        """
+        return [attr for attr in dir(obj) if not attr.startswith("_") and callable(getattr(obj, attr, None))]
+
+    @staticmethod
+    def has_method(obj: Any, method_name: str) -> bool:
+        """是否有指定方法
+
+        :param obj: 对象或类
+        :param method_name: 方法名
+        :return: 是否存在该方法
+        """
+        attr = getattr(obj, method_name, None)
+        return attr is not None and callable(attr)
+
+    @staticmethod
+    def create_instance(class_path: str) -> Any:
+        """通过完整类路径创建实例
+
+        支持模块级函数和类实例化两种方式。
+        例如: 'json.loads', 'datetime.datetime', 'collections.OrderedDict'
+
+        :param class_path: 完整类路径或函数路径，如 'datetime.datetime'
+        :return: 创建的实例或返回的函数结果
+        :raises ImportError: 模块导入失败
+        :raises AttributeError: 属性不存在
+        """
+        parts = class_path.rsplit(".", 1)
+        if len(parts) != 2:
+            raise ValueError(f"无效的类路径: {class_path}，需要包含模块和类名/函数名")
+
+        module_path, attr_name = parts
+        module = importlib.import_module(module_path)
+        obj = getattr(module, attr_name)
+
+        if isinstance(obj, type):
+            return obj()
+        return obj
+
+    @staticmethod
+    def is_subclass(cls: Type, parent_cls: Type) -> bool:
+        """是否为子类
+
+        :param cls: 待检查的类
+        :param parent_cls: 父类
+        :return: 是否为父类的子类
+        """
+        try:
+            return issubclass(cls, parent_cls)
+        except TypeError:
+            return False

hutool/core/util/coordinate_util.py

@@ -0,0 +1,186 @@
+import math
+from typing import NamedTuple
+
+
+class Coordinate(NamedTuple):
+    """坐标点"""
+
+    longitude: float
+    latitude: float
+
+
+class CoordinateUtil:
+    """坐标工具类，提供WGS84/GCJ02/BD09坐标系转换
+
+    WGS84: GPS全球定位系统使用的坐标系
+    GCJ02: 国测局坐标系（火星坐标系），国内地图服务使用
+    BD09: 百度坐标系，在GCJ02基础上进一步加密
+    """
+
+    # 常量
+    _PI = math.pi
+    _A = 6378245.0  # 克拉索夫斯基椭球长半轴（米）
+    _EE = 0.00669342162296594  # 偏心率平方
+
+    @staticmethod
+    def _out_of_china(lng: float, lat: float) -> bool:
+        """判断是否在中国范围外
+
+        :param lng: 经度
+        :param lat: 纬度
+        :return: 是否在中国范围外
+        """
+        return not (72.004 <= lng <= 137.8347 and 0.8293 <= lat <= 55.8271)
+
+    @staticmethod
+    def _transform_lat(lng: float, lat: float) -> float:
+        """纬度转换偏移量计算
+
+        :param lng: 经度
+        :param lat: 纬度
+        :return: 纬度偏移量
+        """
+        pi = CoordinateUtil._PI
+        ret = -100.0 + 2.0 * lng + 3.0 * lat + 0.2 * lat * lat + 0.1 * lng * lat + 0.2 * math.sqrt(abs(lng))
+        ret += (20.0 * math.sin(6.0 * lng * pi) + 20.0 * math.sin(2.0 * lng * pi)) * 2.0 / 3.0
+        ret += (20.0 * math.sin(lat * pi) + 40.0 * math.sin(lat / 3.0 * pi)) * 2.0 / 3.0
+        ret += (160.0 * math.sin(lat / 12.0 * pi) + 320.0 * math.sin(lat * pi / 30.0)) * 2.0 / 3.0
+        return ret
+
+    @staticmethod
+    def _transform_lng(lng: float, lat: float) -> float:
+        """经度转换偏移量计算
+
+        :param lng: 经度
+        :param lat: 纬度
+        :return: 经度偏移量
+        """
+        pi = CoordinateUtil._PI
+        ret = 300.0 + lng + 2.0 * lat + 0.1 * lng * lng + 0.1 * lng * lat + 0.1 * math.sqrt(abs(lng))
+        ret += (20.0 * math.sin(6.0 * lng * pi) + 20.0 * math.sin(2.0 * lng * pi)) * 2.0 / 3.0
+        ret += (20.0 * math.sin(lng * pi) + 40.0 * math.sin(lng / 3.0 * pi)) * 2.0 / 3.0
+        ret += (150.0 * math.sin(lng / 12.0 * pi) + 300.0 * math.sin(lng / 30.0 * pi)) * 2.0 / 3.0
+        return ret
+
+    @staticmethod
+    def _delta(lng: float, lat: float) -> tuple:
+        """计算GCJ-02偏移量
+
+        :param lng: WGS84经度
+        :param lat: WGS84纬度
+        :return: (经度偏移, 纬度偏移)
+        """
+        pi = CoordinateUtil._PI
+        a = CoordinateUtil._A
+        ee = CoordinateUtil._EE
+        dlat = CoordinateUtil._transform_lat(lng - 105.0, lat - 35.0)
+        dlng = CoordinateUtil._transform_lng(lng - 105.0, lat - 35.0)
+        radlat = lat / 180.0 * pi
+        magic = math.sin(radlat)
+        magic = 1 - ee * magic * magic
+        sqrtmagic = math.sqrt(magic)
+        dlat = (dlat * 180.0) / ((a * (1 - ee)) / (magic * sqrtmagic) * pi)
+        dlng = (dlng * 180.0) / (a / sqrtmagic * math.cos(radlat) * pi)
+        return dlng, dlat
+
+    @staticmethod
+    def wgs84_to_gcj02(lng: float, lat: float) -> Coordinate:
+        """WGS84转GCJ02（GPS转国测局坐标）
+
+        :param lng: WGS84经度
+        :param lat: WGS84纬度
+        :return: GCJ02坐标
+        """
+        if CoordinateUtil._out_of_china(lng, lat):
+            return Coordinate(lng, lat)
+        dlng, dlat = CoordinateUtil._delta(lng, lat)
+        return Coordinate(lng + dlng, lat + dlat)
+
+    @staticmethod
+    def gcj02_to_wgs84(lng: float, lat: float) -> Coordinate:
+        """GCJ02转WGS84
+
+        :param lng: GCJ02经度
+        :param lat: GCJ02纬度
+        :return: WGS84坐标
+        """
+        if CoordinateUtil._out_of_china(lng, lat):
+            return Coordinate(lng, lat)
+        dlng, dlat = CoordinateUtil._delta(lng, lat)
+        return Coordinate(lng - dlng, lat - dlat)
+
+    @staticmethod
+    def gcj02_to_bd09(lng: float, lat: float) -> Coordinate:
+        """GCJ02转BD09（转百度坐标）
+
+        :param lng: GCJ02经度
+        :param lat: GCJ02纬度
+        :return: BD09坐标
+        """
+        pi = CoordinateUtil._PI
+        z = math.sqrt(lng * lng + lat * lat) + 0.00002 * math.sin(lat * pi * 3000.0 / 180.0)
+        theta = math.atan2(lat, lng) + 0.000003 * math.cos(lng * pi * 3000.0 / 180.0)
+        bd_lng = z * math.cos(theta) + 0.0065
+        bd_lat = z * math.sin(theta) + 0.006
+        return Coordinate(bd_lng, bd_lat)
+
+    @staticmethod
+    def bd09_to_gcj02(lng: float, lat: float) -> Coordinate:
+        """BD09转GCJ02
+
+        :param lng: BD09经度
+        :param lat: BD09纬度
+        :return: GCJ02坐标
+        """
+        pi = CoordinateUtil._PI
+        x = lng - 0.0065
+        y = lat - 0.006
+        z = math.sqrt(x * x + y * y) - 0.00002 * math.sin(y * pi * 3000.0 / 180.0)
+        theta = math.atan2(y, x) - 0.000003 * math.cos(x * pi * 3000.0 / 180.0)
+        gcj_lng = z * math.cos(theta)
+        gcj_lat = z * math.sin(theta)
+        return Coordinate(gcj_lng, gcj_lat)
+
+    @staticmethod
+    def wgs84_to_bd09(lng: float, lat: float) -> Coordinate:
+        """WGS84转BD09
+
+        :param lng: WGS84经度
+        :param lat: WGS84纬度
+        :return: BD09坐标
+        """
+        gcj = CoordinateUtil.wgs84_to_gcj02(lng, lat)
+        return CoordinateUtil.gcj02_to_bd09(gcj.longitude, gcj.latitude)
+
+    @staticmethod
+    def bd09_to_wgs84(lng: float, lat: float) -> Coordinate:
+        """BD09转WGS84
+
+        :param lng: BD09经度
+        :param lat: BD09纬度
+        :return: WGS84坐标
+        """
+        gcj = CoordinateUtil.bd09_to_gcj02(lng, lat)
+        return CoordinateUtil.gcj02_to_wgs84(gcj.longitude, gcj.latitude)
+
+    @staticmethod
+    def distance(lng1: float, lat1: float, lng2: float, lat2: float) -> float:
+        """计算两点间距离（米），使用Haversine公式
+
+        :param lng1: 第一个点的经度
+        :param lat1: 第一个点的纬度
+        :param lng2: 第二个点的经度
+        :param lat2: 第二个点的纬度
+        :return: 两点间的距离（米）
+        """
+        earth_radius = 6371000.0  # 地球平均半径（米）
+
+        lat1_rad = math.radians(lat1)
+        lat2_rad = math.radians(lat2)
+        dlat = math.radians(lat2 - lat1)
+        dlng = math.radians(lng2 - lng1)
+
+        a = math.sin(dlat / 2) ** 2 + math.cos(lat1_rad) * math.cos(lat2_rad) * math.sin(dlng / 2) ** 2
+        c = 2 * math.atan2(math.sqrt(a), math.sqrt(1 - a))
+
+        return earth_radius * c

hutool/core/util/credit_code_util.py

@@ -0,0 +1,110 @@
+
+
+class CreditCodeUtil:
+    """统一社会信用代码工具类
+
+    统一社会信用代码共18位，由以下部分组成：
+    - 登记管理部门代码（1位）
+    - 机构类别代码（1位）
+    - 登记管理机关行政区划码（6位）
+    - 主体标识码（9位）
+    - 校验码（1位）
+    """
+
+    # 字符到数值的映射
+    _CHAR_MAP = "0123456789ABCDEFGHJKLMNPQRTUWXY"
+    # 加权因子（前17位）
+    _WEIGHT_FACTORS = [1, 3, 9, 27, 19, 26, 16, 17, 20, 29, 25, 13, 8, 24, 10, 30, 28]
+
+    # 登记管理部门代码
+    _DEPT_CODES = {
+        "1": "机构编制",
+        "2": "外交",
+        "3": "司法行政",
+        "4": "文化",
+        "5": "民政",
+        "6": "旅游",
+        "7": "宗教",
+        "8": "工会",
+        "9": "工商",
+        "A": "机构编制",
+        "B": "外交",
+        "C": "机构编制",
+        "D": "商务",
+        "E": "其他",
+    }
+    # 机构类别代码对应的管理部门
+    _TYPE_CODES = {
+        "1": {"1": "机关", "2": "事业单位", "3": "编办直接管理机构编制的群众团体", "9": "其他"},
+        "2": {"1": "外国常驻新闻机构", "9": "其他"},
+        "3": {
+            "1": "律师执业机构",
+            "2": "公证处",
+            "3": "基层法律服务所",
+            "4": "司法鉴定机构",
+            "5": "仲裁委员会",
+            "9": "其他",
+        },
+        "4": {"1": "外国在华文化中心", "9": "其他"},
+        "5": {"1": "社会团体", "2": "民办非企业单位", "3": "基金会", "9": "其他"},
+        "6": {"1": "外国旅游部门常驻代表机构", "2": "港澳台地区旅游部门常驻代表机构", "9": "其他"},
+        "7": {"1": "宗教活动场所", "2": "宗教院校", "9": "其他"},
+        "8": {"1": "基层工会", "9": "其他"},
+        "9": {"1": "企业", "2": "个体工商户", "3": "农民专业合作社"},
+        "A": {"1": "中央编办直接管理机构编制的群众团体", "9": "其他"},
+        "B": {"1": "外国常驻新闻机构", "9": "其他"},
+        "C": {"1": "律师事务所", "9": "其他"},
+        "D": {"1": "外国在华文化中心", "9": "其他"},
+        "E": {"1": "民政", "9": "其他"},
+    }
+
+    @staticmethod
+    def is_valid_credit_code(code: str) -> bool:
+        """校验统一社会信用代码是否有效
+
+        校验规则：
+        1. 长度必须为18位
+        2. 字符必须在允许的字符集内
+        3. 登记管理部门代码和机构类别代码必须合法
+        4. 校验码必须正确（使用ISO 7064:1983.MOD 37-2算法）
+
+        :param code: 待校验的统一社会信用代码
+        :return: 是否有效
+        """
+        if not code or len(code) != 18:
+            return False
+
+        code = code.upper()
+
+        # 检查字符是否在允许的字符集中
+        for ch in code:
+            if ch not in CreditCodeUtil._CHAR_MAP:
+                return False
+
+        # 检查登记管理部门代码
+        dept_code = code[0]
+        if dept_code not in CreditCodeUtil._DEPT_CODES:
+            return False
+
+        # 检查机构类别代码
+        type_code = code[1]
+        if dept_code not in CreditCodeUtil._TYPE_CODES:
+            return False
+        if type_code not in CreditCodeUtil._TYPE_CODES[dept_code]:
+            return False
+
+        # 校验第18位校验码
+        # 使用ISO 7064:1983.MOD 37-2算法
+        check_sum = 0
+        for i in range(17):
+            char_index = CreditCodeUtil._CHAR_MAP.index(code[i])
+            check_sum += char_index * CreditCodeUtil._WEIGHT_FACTORS[i]
+
+        remainder = check_sum % 31
+        if remainder == 0:
+            remainder = 31
+
+        expected_index = 31 - remainder
+        expected_char = CreditCodeUtil._CHAR_MAP[expected_index]
+
+        return code[17] == expected_char

hutool/core/util/desensitized_util.py

@@ -0,0 +1,194 @@
+class DesensitizedUtil:
+    """数据脱敏工具类"""
+
+    @staticmethod
+    def chinese_name(name: str) -> str:
+        """中文姓名脱敏：保留姓，名替换为*
+
+        示例：张三 -> 张*，欧阳娜娜 -> 欧***
+
+        :param name: 中文姓名
+        :return: 脱敏后的姓名
+        """
+        if not name:
+            return ""
+        name = name.strip()
+        if len(name) <= 1:
+            return name
+        elif len(name) == 2:
+            return name[0] + "*"
+        else:
+            return name[0] + "*" * (len(name) - 1)
+
+    @staticmethod
+    def id_card(idcard: str, before: int = 3, after: int = 4) -> str:
+        """身份证脱敏
+
+        保留前before位和后after位，中间用*替换
+
+        :param idcard: 身份证号
+        :param before: 保留前N位，默认3
+        :param after: 保留后N位，默认4
+        :return: 脱敏后的身份证号
+        """
+        if not idcard:
+            return ""
+        idcard = idcard.strip()
+        length = len(idcard)
+        if before + after >= length:
+            return idcard
+        return idcard[:before] + "*" * (length - before - after) + idcard[length - after :]
+
+    @staticmethod
+    def mobile_phone(phone: str) -> str:
+        """手机号脱敏：138****1234
+
+        :param phone: 手机号
+        :return: 脱敏后的手机号
+        """
+        if not phone:
+            return ""
+        phone = phone.strip()
+        if len(phone) < 7:
+            return phone
+        return phone[:3] + "****" + phone[7:]
+
+    @staticmethod
+    def fixed_phone(phone: str) -> str:
+        """固定电话脱敏
+
+        保留区号和后4位，中间用*替换
+
+        :param phone: 固定电话
+        :return: 脱敏后的固定电话
+        """
+        if not phone:
+            return ""
+        phone = phone.strip()
+        # 查找分隔符位置（区号后的'-'）
+        dash_pos = phone.find("-")
+        if dash_pos == -1:
+            # 无分隔符，按规则：前3位为区号保留，后4位保留
+            if len(phone) <= 7:
+                return phone[:3] + "****" if len(phone) > 3 else phone
+            return phone[:3] + "*" * (len(phone) - 7) + phone[-4:]
+        area_code = phone[:dash_pos]
+        number = phone[dash_pos + 1 :]
+        if len(number) <= 4:
+            return area_code + "-" + number
+        return area_code + "-" + "*" * (len(number) - 4) + number[-4:]
+
+    @staticmethod
+    def email(email: str) -> str:
+        """邮箱脱敏：t***@example.com
+
+        保留@前的首字母和@后的完整域名
+
+        :param email: 邮箱地址
+        :return: 脱敏后的邮箱
+        """
+        if not email:
+            return ""
+        email = email.strip()
+        at_pos = email.find("@")
+        if at_pos <= 0:
+            return email
+        prefix = email[:at_pos]
+        domain = email[at_pos:]
+        if len(prefix) <= 1:
+            return prefix + "***" + domain
+        return prefix[0] + "***" + domain
+
+    @staticmethod
+    def address(address: str, sensitive_size: int = 6) -> str:
+        """地址脱敏
+
+        从敏感_size位之前开始替换为*
+
+        :param address: 地址
+        :param sensitive_size: 需要脱敏的字符数，默认6
+        :return: 脱敏后的地址
+        """
+        if not address:
+            return ""
+        address = address.strip()
+        length = len(address)
+        if sensitive_size >= length:
+            return "*" * length
+        return address[: length - sensitive_size] + "*" * sensitive_size
+
+    @staticmethod
+    def bank_card(card: str) -> str:
+        """银行卡脱敏
+
+        保留前4位和后4位，中间用*替换
+
+        :param card: 银行卡号
+        :return: 脱敏后的银行卡号
+        """
+        if not card:
+            return ""
+        card = card.strip().replace(" ", "")
+        if len(card) <= 8:
+            return card
+        return card[:4] + "*" * (len(card) - 8) + card[-4:]
+
+    @staticmethod
+    def password(password: str) -> str:
+        """密码脱敏：全部替换为*
+
+        :param password: 密码
+        :return: 脱敏后的密码（全为*）
+        """
+        if not password:
+            return ""
+        return "*" * len(password)
+
+    @staticmethod
+    def car_license(license_no: str) -> str:
+        """车牌号脱敏
+
+        保留前2位和后1位，中间用*替换
+
+        :param license_no: 车牌号
+        :return: 脱敏后的车牌号
+        """
+        if not license_no:
+            return ""
+        license_no = license_no.strip()
+        if len(license_no) <= 3:
+            return license_no
+        return license_no[:2] + "*" * (len(license_no) - 3) + license_no[-1:]
+
+    @staticmethod
+    def ipv4(ipv4: str) -> str:
+        """IPv4脱敏
+
+        保留前两段，后两段替换为*
+
+        :param ipv4: IPv4地址
+        :return: 脱敏后的IPv4地址
+        """
+        if not ipv4:
+            return ""
+        ipv4 = ipv4.strip()
+        parts = ipv4.split(".")
+        if len(parts) != 4:
+            return ipv4
+        return parts[0] + "." + parts[1] + ".*.*"
+
+    @staticmethod
+    def license_plate(plate: str) -> str:
+        """车牌号脱敏
+
+        保留省份简称和地区代码，后面替换为*
+
+        :param plate: 车牌号
+        :return: 脱敏后的车牌号
+        """
+        if not plate:
+            return ""
+        plate = plate.strip()
+        if len(plate) <= 2:
+            return plate
+        return plate[:2] + "*" * (len(plate) - 2)