Python Utils

• 简体中文
• English

让开发和生活都更快乐的小工具集合 🧰

📦 工具列表

模块	描述	主要文件
cli_logger	loguru 日志配置示例，控制台 + 文件双通道输出	cli_logger.py
dirwatch	实时监控文件夹变化（增/删/改/重命名）	dirwatch.py
format_cmake	格式化 CMake 文件（单个或递归目录）	format_cmake.py
hash	计算文件或文本的哈希值（MD5/SHA-1/SHA-2/SHA-3/BLAKE2/BLAKE3）	hash.py
image-toolkit	图片格式转换工具 + 一键生成/解析.icns / .ico	convert_img.py / dump_icns.py / dump_ico.py / make_icns.py / make_ico.py
m3u8_download	m3u8 下载器，自动合并 ts 为单个视频	m3u8_dl.py
procmon	按进程名实时监控 CPU/内存/线程/句柄	procmon.py
resolve	域名解析工具，快速获取 IP、端口、协议信息	resolve.py
tree	可视化目录树生成工具	tree.py
utils	通用工具库（颜色输出等）	colors.py
sync_req	依赖同步工具，从 pyproject.toml 生成 requirements.txt	sync_req.py

🚀 快速开始

安装 uv

首先需要安装 uv - 极速的 Python 包管理器和项目工具链：

使用 pip 安装（跨平台）：

pip install uv -i https://pypi.tuna.tsinghua.edu.cn/simple

验证安装：

uv --version

安装项目依赖

使用 uv 管理项目依赖：

# 使用 uv 创建虚拟环境并安装所有依赖（一步完成）
uv sync --dev

# 或者分步执行：
# 1. 创建虚拟环境（默认在 .venv 目录）
uv venv

# 2. 激活虚拟环境 (Linux/macOS)
source .venv/bin/activate

# 3. 安装项目依赖（可编辑模式）
uv pip install -e .

同步依赖文件

项目提供了 sync_req.py 工具，用于从 pyproject.toml 生成 requirements.txt：

# 生成 requirements.txt
python sync_req.py

# 使用 uv 通过 requirements.txt 安装依赖
uv pip install -r requirements.txt

使用清华镜像加速（可选）

如果需要使用国内镜像源：

# 设置环境变量使用清华镜像
export UV_INDEX_URL=https://pypi.tuna.tsinghua.edu.cn/simple
uv sync --dev

# 或者单次命令指定镜像
uv pip install -e . -i https://pypi.tuna.tsinghua.edu.cn/simple

使用说明

👉 直接 cd 进对应目录，uv run python xxx.py -h 查看具体用法！