Python-glob2 项目技术文档
1. 安装指南
Python-glob2 是 Python 标准库中内置 glob 模块的扩展版本,它增加了一些新特性。要安装 Python-glob2,请按照以下步骤进行:
- 确保您的系统已安装 Python 2 或 Python 3(已测试 3.3 版本)。
- 打开命令行工具。
- 输入以下命令安装 Python-glob2:
pip install glob2
确保您的 pip 版本是最新的,如果不是,请先升级 pip:
pip install --upgrade pip
2. 项目使用说明
Python-glob2 提供了以下功能:
- 支持捕获与 glob 模式匹配的文本,并返回这些匹配项以及文件名。
- 支持递归的 '**' globbing 语法,类似于 bash shell 的
globstar选项。 - 允许替换文件系统函数,以便在虚拟文件系统上进行 glob 操作。
以下是使用 Python-glob2 的一些示例:
匹配返回
import glob2
for filename, (version,) in glob2.iglob('./binaries/project-*.zip', with_matches=True):
print(version)
递归 glob
import glob2
all_header_files = glob2.glob('src/**/*.h')
# 输出类似于 ['src/fs.h', 'src/media/mp3.h', 'src/media/mp3/frame.h', ...]
注意,** 必须单独出现在目录元素中才具有特殊含义。**h 将不会得到期望的效果。
** 将匹配当前目录下的点("."),如果这不是您想要的,可以使用 */**/*.py。
自定义 Globber
from glob2 import Globber
class VirtualStorageGlobber(Globber):
def __init__(self, storage):
self.storage = storage
def listdir(self, path):
# 如果路径不是目录,则必须引发 os.error
return self.storage.listdir(path)
def exists(self, path):
return self.storage.exists(path)
def isdir(self, path):
# 仅用于以斜杠结尾的语法(如:`foo/`)。
return self.storage.isdir(path)
def islink(self, path):
# 仅用于递归 glob(如:`**`)。
return self.storage.islink(path)
globber = VirtualStorageGlobber(sftp_storage)
globber.glob('/var/www/**/*.js')
如果无法为存储实现 isdir 和/或 islink 方法,可以将它们设置为返回一个固定值,这将导致以下后果:
-
如果
isdir返回True,则目录结尾的 glob 表达式将返回所有项目(包括非目录),如果返回False,则同样表达式将不返回任何内容。 -
如果
islink返回True,递归 globbing 语法**将跟随所有链接。如果返回False,它将完全不起作用。
3. 项目 API 使用文档
Python-glob2 的 API 包括以下方法和功能:
-
iglob(pattern, recursive=False, with_matches=False):返回一个生成器,生成所有与模式匹配的路径名。如果recursive为True,将使用递归搜索。with_matches为True时,将返回匹配的文本。 -
glob(pattern, recursive=False, with_matches=False):与iglob类似,但返回一个列表而不是生成器。 -
Globber类:允许自定义文件系统函数,用于在虚拟文件系统上进行 glob 操作。
4. 项目安装方式
请参考本文档的“安装指南”部分,安装方式是通过 pip 包管理工具进行安装。
PaddleOCR-VLPaddleOCR-VL 是一款顶尖且资源高效的文档解析专用模型。其核心组件为 PaddleOCR-VL-0.9B,这是一款精简却功能强大的视觉语言模型(VLM)。该模型融合了 NaViT 风格的动态分辨率视觉编码器与 ERNIE-4.5-0.3B 语言模型,可实现精准的元素识别。Python00- DDeepSeek-OCRDeepSeek-OCR是一款以大语言模型为核心的开源工具,从LLM视角出发,探索视觉文本压缩的极限。Python00
openPangu-Ultra-MoE-718B-V1.1昇腾原生的开源盘古 Ultra-MoE-718B-V1.1 语言模型Python00
HunyuanWorld-Mirror混元3D世界重建模型,支持多模态先验注入和多任务统一输出Python00
AI内容魔方AI内容专区,汇集全球AI开源项目,集结模块、可组合的内容,致力于分享、交流。03
Spark-Scilit-X1-13B科大讯飞Spark Scilit-X1-13B基于最新一代科大讯飞基础模型,并针对源自科学文献的多项核心任务进行了训练。作为一款专为学术研究场景打造的大型语言模型,它在论文辅助阅读、学术翻译、英语润色和评论生成等方面均表现出色,旨在为研究人员、教师和学生提供高效、精准的智能辅助。Python00
GOT-OCR-2.0-hf阶跃星辰StepFun推出的GOT-OCR-2.0-hf是一款强大的多语言OCR开源模型,支持从普通文档到复杂场景的文字识别。它能精准处理表格、图表、数学公式、几何图形甚至乐谱等特殊内容,输出结果可通过第三方工具渲染成多种格式。模型支持1024×1024高分辨率输入,具备多页批量处理、动态分块识别和交互式区域选择等创新功能,用户可通过坐标或颜色指定识别区域。基于Apache 2.0协议开源,提供Hugging Face演示和完整代码,适用于学术研究到工业应用的广泛场景,为OCR领域带来突破性解决方案。00- HHowToCook程序员在家做饭方法指南。Programmer's guide about how to cook at home (Chinese only).Dockerfile014
Spark-Chemistry-X1-13B科大讯飞星火化学-X1-13B (iFLYTEK Spark Chemistry-X1-13B) 是一款专为化学领域优化的大语言模型。它由星火-X1 (Spark-X1) 基础模型微调而来,在化学知识问答、分子性质预测、化学名称转换和科学推理方面展现出强大的能力,同时保持了强大的通用语言理解与生成能力。Python00- PpathwayPathway is an open framework for high-throughput and low-latency real-time data processing.Python00