pyxllib 0.3.197__py3-none-any.whl → 0.3.200__py3-none-any.whl

pyxllib/file/packlib/__init__.py

@@ -1,330 +1,330 @@
-#!/usr/bin/env python3
-# -*- coding: utf-8 -*-
-# @Author : 陈坤泽
-# @Email  : 877362867@qq.com
-# @Date   : 2022/02/15 09:51
-
-import os
-import shutil
-from tarfile import TarFile
-# 这个包里的ZipFile是拷贝后修改过的，不影响标准库zipfile里的功能
-# import pyxllib.file.packlib.zipfile as zipfile
-# from pyxllib.file.packlib.zipfile import ZipFile
-import zipfile
-from zipfile import ZipFile
-import tempfile
-
-from pyxllib.file.specialist import XlPath, reduce_dir_depth
-from pyxllib.prog.pupil import inject_members
-
-""" 问题：py官方的ZipFile解压带中文的文件会乱码
-
-解决办法及操作流程
-1、定期将官方的zipfile.py文件更新到pyxllib.file.packlib.zipfile
-2、将代码中两处cp437都替换为gbk
-"""
-
-
-def unpack_zipfile(filename, extract_dir):
-    """ 为了修复zipfile底层的中文解压乱码问题，修改了shutil._UNPACK_FORMATS的底层功能
-    """
-    from shutil import ReadError
-
-    zip = zipfile.ZipFile(filename)
-    if not zipfile.is_zipfile(filename):
-        raise ReadError("%s is not a zip file" % filename)
-    try:
-        for info in zip.infolist():
-            name = info.filename
-
-            # don't extract absolute paths or ones with .. in them
-            if name.startswith('/') or '..' in name:
-                continue
-
-            target = os.path.join(extract_dir, *name.split('/'))
-            if not target:
-                continue
-
-            os.makedirs(XlPath(target).parent, exist_ok=True)
-            if not name.endswith('/'):
-                # file
-                data = zip.read(info.filename)
-                f = open(target, 'wb')
-                try:
-                    f.write(data)
-                finally:
-                    f.close()
-                    del data
-    finally:
-        zip.close()
-
-
-# 解决unzip中文乱码问题
-shutil._UNPACK_FORMATS['zip'] = (['.zip'], unpack_zipfile, [], "ZIP file")
-
-
-def _parse_depth(names):
-    """ 判断有几层目录都只有独立的一个目录
-
-    :param names: 一组相对路径名
-    :return: 如果直接目录下文件已经不唯一，返回0
-
-    >>> _parse_depth(['a'])
-    1
-    >>> _parse_depth(['a', 'a/1'])
-    2
-    >>> _parse_depth(['a', 'a/b', 'a/b/1', 'a/b/2'])
-    2
-    >>> _parse_depth(['a', 'a/b', 'a/b/1', 'a/c/3'])
-    1
-    """
-    parents = []
-    for name in names:
-        p = XlPath(name)
-        ps = [x.as_posix() for x in p.parents]
-        parents.append(ps[-2::-1] + [p.as_posix()])
-    i = 0
-    while len({x[i] for x in parents if len(x) > i}) == 1:
-        i += 1
-    return i
-
-
-def _unpack_base(packfile, namelist, format=None, extract_dir=None, wrap=0):
-    """ 解压
-
-    :param packfile: 压缩包本身的文件路径名称，在wrap=1时可能会用到，用来添加一个同名目录
-    :param namelist: 压缩包里所有文件的相对路径
-    :param format: 压缩包类型，比如zip、tar，可以不输入，此时直接采用shutil.unpack_archive里的判断机制
-    :param extract_dir: 解压目标目录，可以不输入，会自动判断
-        自动解压规则：压缩包里目录不唯一，则以压缩包本身的名称创建一个目录存放
-            否则以压缩包里的目录名为准
-    :param wrap: 解压时倾向的处理机制
-        0，默认，不进行任何处理
-        1，如果压缩包里一级目录下不止一个对象，使用压缩包本身的名称再包一层
-        -1，如果压缩包里一级目录下只有一个目录，则丢弃这个目录，只取里面的内容出来
-            同理，可能这一个目录里的文件，还是只有一个目录，此时支持设置-2、-3等解开上限
-            也就-1比较常用，-2、-3等很少见了
-        TODO 还有一种解压机制，只取里面的部分文件，有空可以继续调研扩展下
-    :return: 无论怎样，最后都是放到一个目录里，返回改目录路径
-    """
-
-    # 1 默认解压目录是self所在目录，注意这点跟shutil.unpack_archive的当前工作目录不同
-    p0 = XlPath(packfile)
-    if extract_dir is None:
-        extract_dir = p0.parent
-
-    depth = _parse_depth(namelist)
-
-    # 2 是否要加目录层级，或者去掉目录层级
-    if wrap == 1 and depth == 0:
-        # 压缩包里直接目录下有多个文件，且指定了wrap，则加一层目录
-        shutil.unpack_archive(packfile, extract_dir / p0.stem, format)
-    elif wrap < 0 < depth:
-        # 压缩包有depth层冗余目录，并且指定wrap要解开这几层目录
-        # 先正常解压（每种压缩包格式内部处理机制都有点不太一样，所以先解压，然后用目录文件功能处理更合适）
-        shutil.unpack_archive(packfile, extract_dir, format)
-        reduce_dir_depth(extract_dir, unwrap=-wrap)
-    else:
-        # 正常解压
-        shutil.unpack_archive(packfile, extract_dir, format)
-
-
-def zip_filter_rule(path):
-    p = XlPath(path)
-
-    # 排除特定目录或文件
-    if set(p.parts) & {'__pycache__', '.git', '.idea', 'dist', 'build', '.pytest_cache', '.venv'}:
-        return 0
-
-    # 排除特定文件扩展名
-    if p.suffix in {'.egg-info', '.lock'}:
-        return 0
-
-    # 精细检查内部文件
-    if p.is_dir():
-        return 1
-
-    # 全部包含其他情况
-    return 2
-
-
-class XlZipFile(ZipFile):
-
-    def infolist2(self, prefix=None, zipinfo=True):
-        """>> self.infolist2()  # getinfo的多文件版本
-             1           <ZipInfo filename='[Content_Types].xml' compress_type=deflate file_size=1495 compress_size=383>
-             2                    <ZipInfo filename='_rels/.rels' compress_type=deflate file_size=590 compress_size=243>
-            ......
-            20            <ZipInfo filename='word/fontTable.xml' compress_type=deflate file_size=1590 compress_size=521>
-            21               <ZipInfo filename='docProps/app.xml' compress_type=deflate file_size=720 compress_size=384>
-
-        :param prefix:
-            可以筛选文件的前缀，例如“word/”可以筛选出word目录下的
-        :param zipinfo:
-            返回的list每个元素是zipinfo数据类型
-        """
-        ls = self.infolist()
-        if prefix:
-            ls = list(filter(lambda t: t.filename.startswith(prefix), ls))
-        if not zipinfo:
-            ls = list(map(lambda x: x.filename, ls))
-        return ls
-
-    def unpack(self, extract_dir=None, format='zip', wrap=0):
-        _unpack_base(self.filename, self.namelist(), format, extract_dir, wrap)
-
-    def write_dir(self, directory, arcname=None, filter_rule=None):
-        """
-        将指定目录（包含子目录）添加到 zip 文件中，并可自定义在 zip 中的存储路径。
-
-        :param directory: 要压缩的目录路径
-        :param arcname: 在 zip 文件中存储的根目录名，
-            None, 默认跟ZipFile.write的arcname一样，直接取输入的目录名
-        :param filter_rule: 过滤规则函数，用于排除不需要的文件。函数应接受文件路径作为参数，
-                           返回0, 1, 或 2，分别表示排除、递归检查、全部包括。
-        """
-        if arcname is None:
-            arcname = directory
-
-        if filter_rule is True:
-            filter_rule = zip_filter_rule
-
-        for root, dirs, files in os.walk(directory):
-            for file in files:
-                file_path = os.path.join(root, file)
-
-                # 调用过滤函数获取过滤状态
-                if filter_rule:
-                    result = filter_rule(file_path)
-                    if result == 0:  # 明确不要
-                        continue
-                    elif result == 1:  # 需要递归精细检查
-                        pass  # 继续执行文件写入逻辑
-                    elif result == 2:  # 全部包含
-                        # 计算文件在 zip 文件中的相对路径
-                        zip_path = os.path.join(arcname, os.path.relpath(file_path, directory))
-                        self.write(file_path, zip_path)
-                        continue
-
-                # 默认情况下，递归处理
-                zip_path = os.path.join(arcname, os.path.relpath(file_path, directory))
-                self.write(file_path, zip_path)
-
-            for dir in dirs[:]:
-                dir_path = os.path.join(root, dir)
-
-                if filter_rule:
-                    result = filter_rule(dir_path)
-                    if result == 0:  # 明确不要
-                        dirs.remove(dir)  # 排除整个目录
-                    elif result == 2:  # 全部包含
-                        # 添加整个目录
-                        for root2, _, files2 in os.walk(dir_path):
-                            for file2 in files2:
-                                file_path = os.path.join(root2, file2)
-                                zip_path = os.path.join(arcname, os.path.relpath(file_path, directory))
-                                self.write(file_path, zip_path)
-                        dirs.remove(dir)  # 递归中不再处理此目录
-
-    def write_path(self, path, arcname=None, filter_rule=None):
-        """ 封装的同时支持文件或目录的操作 """
-        if XlPath(path).is_dir():
-            self.write_dir(path, arcname, filter_rule)
-        elif XlPath(path).is_file():
-            self.write(path, arcname)
-        else:
-            raise ValueError
-
-    def xlwrite(self, path, arcname=None, filter_rule=True):
-        self.write_path(path, arcname, filter_rule)
-
-    @classmethod
-    def create(cls, name=None):
-        """ 在临时目录下新建一个目录，然后放一个压缩包文件 """
-        # 如果没有提供 name，则生成一个临时的文件名
-        if name is None:
-            name = tempfile.mktemp(suffix=".zip").split('/')[-1]  # 提取生成的文件名
-
-        # 创建临时目录（因为可能有并发操作，每个处理都建立一个目录更安全）
-        temp_dir = tempfile.mkdtemp()
-        temp_zip_path = f"{temp_dir}/{name}"
-
-        # 创建 ZipFile 对象
-        zipf = ZipFile(temp_zip_path, 'w')
-        return zipf
-
-    def fastapi_resp(self):
-        """ 返回供fastapi后端使用的文件接口 """
-        from fastapi.responses import FileResponse
-
-        self.close()
-        return FileResponse(self.filename, media_type='application/zip',
-                            filename=XlPath(self.filename).name)
-
-
-class XlTarFile(TarFile):
-
-    def unpack(self, extract_dir=None, format='tar', wrap=0):
-        _unpack_base(self.name, self.getnames(), format, extract_dir, wrap)
-
-
-inject_members(XlZipFile, ZipFile)
-inject_members(XlTarFile, TarFile)
-
-
-def unpack_archive(filename, extract_dir=None, format=None, *, wrap=1):
-    """ 对shutil.unpack_archive的扩展，增加了一个wrap的接口功能 """
-    if format is None:
-        format = shutil._find_unpack_format(str(filename).lower())
-
-    if format.endswith('zip'):
-        XlZipFile(filename).unpack(extract_dir, format, wrap)
-    elif format.endswith('tar'):
-        XlTarFile(filename).unpack(extract_dir, format, wrap)
-    else:
-        # 其他还没扩展的格式，不支持wrap功能，但仍然可以使用shutil标准的接口解压
-        shutil.unpack_archive(filename, extract_dir, format)
-
-
-def compress_to_zip(source_path, target_zip_path=None, wrap=None,
-                    ignore_func=None):
-    """ 压缩指定的文件或文件夹为ZIP格式。
-
-    :param str source_path: 要压缩的文件或文件夹路径
-    :param str target_zip_path: 目标ZIP文件路径（可选）
-    :param str wrap: 在ZIP文件内部创建的目录名，所有内容将被放在这个目录下
-    :param func ignore_func: 忽略文件的函数，输入目录或文件的路径，返回True表示不取用
-    """
-    # 根据输入路径生成默认的目标ZIP文件路径
-    if target_zip_path is None:
-        # 获取输入路径的基本名称（文件名或文件夹名）
-        base_name = os.path.basename(source_path)
-        # 为基本名称添加'.zip'后缀
-        target_zip_path = os.path.join(os.path.dirname(source_path), f"{base_name}.zip")
-
-    # 创建一个ZipFile对象来写入压缩文件
-    with XlZipFile(target_zip_path, 'w', zipfile.ZIP_DEFLATED) as zipf:
-        # 如果是文件夹，则遍历文件夹中的所有文件和子文件夹
-        if os.path.isdir(source_path):
-            for root, _, files in os.walk(source_path):
-                if ignore_func and ignore_func(root):
-                    continue
-
-                for file in files:
-                    if ignore_func and ignore_func(file):
-                        continue
-
-                    file_path = os.path.join(root, file)
-                    # 计算文件在ZIP中的相对路径
-                    arcname = os.path.relpath(file_path, source_path)
-                    if wrap:
-                        arcname = os.path.join(wrap, arcname)
-                    zipf.write(file_path, arcname)
-        # 如果是文件，则直接将文件添加到ZIP中
-        elif os.path.isfile(source_path):
-            arcname = os.path.basename(source_path)
-            if wrap:
-                arcname = os.path.join(wrap, arcname)
-            zipf.write(source_path, arcname)
-
-    return target_zip_path
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+# @Author : 陈坤泽
+# @Email  : 877362867@qq.com
+# @Date   : 2022/02/15 09:51
+
+import os
+import shutil
+from tarfile import TarFile
+# 这个包里的ZipFile是拷贝后修改过的，不影响标准库zipfile里的功能
+# import pyxllib.file.packlib.zipfile as zipfile
+# from pyxllib.file.packlib.zipfile import ZipFile
+import zipfile
+from zipfile import ZipFile
+import tempfile
+
+from pyxllib.file.specialist import XlPath, reduce_dir_depth
+from pyxllib.prog.pupil import inject_members
+
+""" 问题：py官方的ZipFile解压带中文的文件会乱码
+
+解决办法及操作流程
+1、定期将官方的zipfile.py文件更新到pyxllib.file.packlib.zipfile
+2、将代码中两处cp437都替换为gbk
+"""
+
+
+def unpack_zipfile(filename, extract_dir):
+    """ 为了修复zipfile底层的中文解压乱码问题，修改了shutil._UNPACK_FORMATS的底层功能
+    """
+    from shutil import ReadError
+
+    zip = zipfile.ZipFile(filename)
+    if not zipfile.is_zipfile(filename):
+        raise ReadError("%s is not a zip file" % filename)
+    try:
+        for info in zip.infolist():
+            name = info.filename
+
+            # don't extract absolute paths or ones with .. in them
+            if name.startswith('/') or '..' in name:
+                continue
+
+            target = os.path.join(extract_dir, *name.split('/'))
+            if not target:
+                continue
+
+            os.makedirs(XlPath(target).parent, exist_ok=True)
+            if not name.endswith('/'):
+                # file
+                data = zip.read(info.filename)
+                f = open(target, 'wb')
+                try:
+                    f.write(data)
+                finally:
+                    f.close()
+                    del data
+    finally:
+        zip.close()
+
+
+# 解决unzip中文乱码问题
+shutil._UNPACK_FORMATS['zip'] = (['.zip'], unpack_zipfile, [], "ZIP file")
+
+
+def _parse_depth(names):
+    """ 判断有几层目录都只有独立的一个目录
+
+    :param names: 一组相对路径名
+    :return: 如果直接目录下文件已经不唯一，返回0
+
+    >>> _parse_depth(['a'])
+    1
+    >>> _parse_depth(['a', 'a/1'])
+    2
+    >>> _parse_depth(['a', 'a/b', 'a/b/1', 'a/b/2'])
+    2
+    >>> _parse_depth(['a', 'a/b', 'a/b/1', 'a/c/3'])
+    1
+    """
+    parents = []
+    for name in names:
+        p = XlPath(name)
+        ps = [x.as_posix() for x in p.parents]
+        parents.append(ps[-2::-1] + [p.as_posix()])
+    i = 0
+    while len({x[i] for x in parents if len(x) > i}) == 1:
+        i += 1
+    return i
+
+
+def _unpack_base(packfile, namelist, format=None, extract_dir=None, wrap=0):
+    """ 解压
+
+    :param packfile: 压缩包本身的文件路径名称，在wrap=1时可能会用到，用来添加一个同名目录
+    :param namelist: 压缩包里所有文件的相对路径
+    :param format: 压缩包类型，比如zip、tar，可以不输入，此时直接采用shutil.unpack_archive里的判断机制
+    :param extract_dir: 解压目标目录，可以不输入，会自动判断
+        自动解压规则：压缩包里目录不唯一，则以压缩包本身的名称创建一个目录存放
+            否则以压缩包里的目录名为准
+    :param wrap: 解压时倾向的处理机制
+        0，默认，不进行任何处理
+        1，如果压缩包里一级目录下不止一个对象，使用压缩包本身的名称再包一层
+        -1，如果压缩包里一级目录下只有一个目录，则丢弃这个目录，只取里面的内容出来
+            同理，可能这一个目录里的文件，还是只有一个目录，此时支持设置-2、-3等解开上限
+            也就-1比较常用，-2、-3等很少见了
+        TODO 还有一种解压机制，只取里面的部分文件，有空可以继续调研扩展下
+    :return: 无论怎样，最后都是放到一个目录里，返回改目录路径
+    """
+
+    # 1 默认解压目录是self所在目录，注意这点跟shutil.unpack_archive的当前工作目录不同
+    p0 = XlPath(packfile)
+    if extract_dir is None:
+        extract_dir = p0.parent
+
+    depth = _parse_depth(namelist)
+
+    # 2 是否要加目录层级，或者去掉目录层级
+    if wrap == 1 and depth == 0:
+        # 压缩包里直接目录下有多个文件，且指定了wrap，则加一层目录
+        shutil.unpack_archive(packfile, extract_dir / p0.stem, format)
+    elif wrap < 0 < depth:
+        # 压缩包有depth层冗余目录，并且指定wrap要解开这几层目录
+        # 先正常解压（每种压缩包格式内部处理机制都有点不太一样，所以先解压，然后用目录文件功能处理更合适）
+        shutil.unpack_archive(packfile, extract_dir, format)
+        reduce_dir_depth(extract_dir, unwrap=-wrap)
+    else:
+        # 正常解压
+        shutil.unpack_archive(packfile, extract_dir, format)
+
+
+def zip_filter_rule(path):
+    p = XlPath(path)
+
+    # 排除特定目录或文件
+    if set(p.parts) & {'__pycache__', '.git', '.idea', 'dist', 'build', '.pytest_cache', '.venv'}:
+        return 0
+
+    # 排除特定文件扩展名
+    if p.suffix in {'.egg-info', '.lock'}:
+        return 0
+
+    # 精细检查内部文件
+    if p.is_dir():
+        return 1
+
+    # 全部包含其他情况
+    return 2
+
+
+class XlZipFile(ZipFile):
+
+    def infolist2(self, prefix=None, zipinfo=True):
+        """>> self.infolist2()  # getinfo的多文件版本
+             1           <ZipInfo filename='[Content_Types].xml' compress_type=deflate file_size=1495 compress_size=383>
+             2                    <ZipInfo filename='_rels/.rels' compress_type=deflate file_size=590 compress_size=243>
+            ......
+            20            <ZipInfo filename='word/fontTable.xml' compress_type=deflate file_size=1590 compress_size=521>
+            21               <ZipInfo filename='docProps/app.xml' compress_type=deflate file_size=720 compress_size=384>
+
+        :param prefix:
+            可以筛选文件的前缀，例如“word/”可以筛选出word目录下的
+        :param zipinfo:
+            返回的list每个元素是zipinfo数据类型
+        """
+        ls = self.infolist()
+        if prefix:
+            ls = list(filter(lambda t: t.filename.startswith(prefix), ls))
+        if not zipinfo:
+            ls = list(map(lambda x: x.filename, ls))
+        return ls
+
+    def unpack(self, extract_dir=None, format='zip', wrap=0):
+        _unpack_base(self.filename, self.namelist(), format, extract_dir, wrap)
+
+    def write_dir(self, directory, arcname=None, filter_rule=None):
+        """
+        将指定目录（包含子目录）添加到 zip 文件中，并可自定义在 zip 中的存储路径。
+
+        :param directory: 要压缩的目录路径
+        :param arcname: 在 zip 文件中存储的根目录名，
+            None, 默认跟ZipFile.write的arcname一样，直接取输入的目录名
+        :param filter_rule: 过滤规则函数，用于排除不需要的文件。函数应接受文件路径作为参数，
+                           返回0, 1, 或 2，分别表示排除、递归检查、全部包括。
+        """
+        if arcname is None:
+            arcname = directory
+
+        if filter_rule is True:
+            filter_rule = zip_filter_rule
+
+        for root, dirs, files in os.walk(directory):
+            for file in files:
+                file_path = os.path.join(root, file)
+
+                # 调用过滤函数获取过滤状态
+                if filter_rule:
+                    result = filter_rule(file_path)
+                    if result == 0:  # 明确不要
+                        continue
+                    elif result == 1:  # 需要递归精细检查
+                        pass  # 继续执行文件写入逻辑
+                    elif result == 2:  # 全部包含
+                        # 计算文件在 zip 文件中的相对路径
+                        zip_path = os.path.join(arcname, os.path.relpath(file_path, directory))
+                        self.write(file_path, zip_path)
+                        continue
+
+                # 默认情况下，递归处理
+                zip_path = os.path.join(arcname, os.path.relpath(file_path, directory))
+                self.write(file_path, zip_path)
+
+            for dir in dirs[:]:
+                dir_path = os.path.join(root, dir)
+
+                if filter_rule:
+                    result = filter_rule(dir_path)
+                    if result == 0:  # 明确不要
+                        dirs.remove(dir)  # 排除整个目录
+                    elif result == 2:  # 全部包含
+                        # 添加整个目录
+                        for root2, _, files2 in os.walk(dir_path):
+                            for file2 in files2:
+                                file_path = os.path.join(root2, file2)
+                                zip_path = os.path.join(arcname, os.path.relpath(file_path, directory))
+                                self.write(file_path, zip_path)
+                        dirs.remove(dir)  # 递归中不再处理此目录
+
+    def write_path(self, path, arcname=None, filter_rule=None):
+        """ 封装的同时支持文件或目录的操作 """
+        if XlPath(path).is_dir():
+            self.write_dir(path, arcname, filter_rule)
+        elif XlPath(path).is_file():
+            self.write(path, arcname)
+        else:
+            raise ValueError
+
+    def xlwrite(self, path, arcname=None, filter_rule=True):
+        self.write_path(path, arcname, filter_rule)
+
+    @classmethod
+    def create(cls, name=None):
+        """ 在临时目录下新建一个目录，然后放一个压缩包文件 """
+        # 如果没有提供 name，则生成一个临时的文件名
+        if name is None:
+            name = tempfile.mktemp(suffix=".zip").split('/')[-1]  # 提取生成的文件名
+
+        # 创建临时目录（因为可能有并发操作，每个处理都建立一个目录更安全）
+        temp_dir = tempfile.mkdtemp()
+        temp_zip_path = f"{temp_dir}/{name}"
+
+        # 创建 ZipFile 对象
+        zipf = ZipFile(temp_zip_path, 'w')
+        return zipf
+
+    def fastapi_resp(self):
+        """ 返回供fastapi后端使用的文件接口 """
+        from fastapi.responses import FileResponse
+
+        self.close()
+        return FileResponse(self.filename, media_type='application/zip',
+                            filename=XlPath(self.filename).name)
+
+
+class XlTarFile(TarFile):
+
+    def unpack(self, extract_dir=None, format='tar', wrap=0):
+        _unpack_base(self.name, self.getnames(), format, extract_dir, wrap)
+
+
+inject_members(XlZipFile, ZipFile)
+inject_members(XlTarFile, TarFile)
+
+
+def unpack_archive(filename, extract_dir=None, format=None, *, wrap=1):
+    """ 对shutil.unpack_archive的扩展，增加了一个wrap的接口功能 """
+    if format is None:
+        format = shutil._find_unpack_format(str(filename).lower())
+
+    if format.endswith('zip'):
+        XlZipFile(filename).unpack(extract_dir, format, wrap)
+    elif format.endswith('tar'):
+        XlTarFile(filename).unpack(extract_dir, format, wrap)
+    else:
+        # 其他还没扩展的格式，不支持wrap功能，但仍然可以使用shutil标准的接口解压
+        shutil.unpack_archive(filename, extract_dir, format)
+
+
+def compress_to_zip(source_path, target_zip_path=None, wrap=None,
+                    ignore_func=None):
+    """ 压缩指定的文件或文件夹为ZIP格式。
+
+    :param str source_path: 要压缩的文件或文件夹路径
+    :param str target_zip_path: 目标ZIP文件路径（可选）
+    :param str wrap: 在ZIP文件内部创建的目录名，所有内容将被放在这个目录下
+    :param func ignore_func: 忽略文件的函数，输入目录或文件的路径，返回True表示不取用
+    """
+    # 根据输入路径生成默认的目标ZIP文件路径
+    if target_zip_path is None:
+        # 获取输入路径的基本名称（文件名或文件夹名）
+        base_name = os.path.basename(source_path)
+        # 为基本名称添加'.zip'后缀
+        target_zip_path = os.path.join(os.path.dirname(source_path), f"{base_name}.zip")
+
+    # 创建一个ZipFile对象来写入压缩文件
+    with XlZipFile(target_zip_path, 'w', zipfile.ZIP_DEFLATED) as zipf:
+        # 如果是文件夹，则遍历文件夹中的所有文件和子文件夹
+        if os.path.isdir(source_path):
+            for root, _, files in os.walk(source_path):
+                if ignore_func and ignore_func(root):
+                    continue
+
+                for file in files:
+                    if ignore_func and ignore_func(file):
+                        continue
+
+                    file_path = os.path.join(root, file)
+                    # 计算文件在ZIP中的相对路径
+                    arcname = os.path.relpath(file_path, source_path)
+                    if wrap:
+                        arcname = os.path.join(wrap, arcname)
+                    zipf.write(file_path, arcname)
+        # 如果是文件，则直接将文件添加到ZIP中
+        elif os.path.isfile(source_path):
+            arcname = os.path.basename(source_path)
+            if wrap:
+                arcname = os.path.join(wrap, arcname)
+            zipf.write(source_path, arcname)
+
+    return target_zip_path