AutoCython-zhang 2.3.0

自动Cython，使用Cython批量编译.py文件为.pyd文件！

AutoCython V2

中文 | English

自动 Cython：一键将 Python 文件批量编译为 PYD / SO 文件

✨ 特性

• 单文件/多文件批量编译
• 跨平台支持 (Windows/Linux/MacOS)
• 简洁命令行界面

📦 安装

pip install -U AutoCython-zhang

⚙️ 依赖环境

C/C++ 编译器

• Windows: Visual Studio
• Linux: gcc & g++

重要提示：编译器架构必须与Python解释器一致（64位Python需64位编译器）

其他编译器配置请参考 Cython 项目

🚀 使用指南

命令行操作

# 编译单个文件
AutoCython -f test.py

# 编译整个目录
AutoCython -p D:/python_code/ProjectPath

# 编译后删除源代码 (默认不删除)
AutoCython -d -f test.py
AutoCython -d -p D:/python_code/ProjectPath

# 指定混淆随机种子（可复现构建）
AutoCython --seed 2025 -f test.py

编译界面

手动排除文件不编译

在文件头部 前两行 添加声明：

# AutoCython No Compile
# 此文件将跳过编译处理

🧪 测试

# 运行全部测试
pytest

# 只运行单元测试
pytest -m unit

# 只运行集成测试 (kd_dist)
pytest -m integ

# 排除集成测试（快速验证）
pytest -m "not integ"

kd-dist 集成测试配置

# 指定真实项目根目录（未设置则自动探测）
export KD_DIST_ROOT=/path/to/kd-dist

# 开启严格文件计数阈值校验（默认关闭）
export KD_DIST_STRICT_COUNTS=1

# 输出 kd-dist 分层测试 JSON 报告
export KD_DIST_REPORT_PATH=.pytest_cache/kd_dist_report.json

tests/kd_dist/manifest.json 用于定义 import policy 与行为等价用例，
tests/kd_dist/known_failures.json 用于记录已知 Cython 不兼容文件（xfail 治理）。

⚠️ 常见问题解决

一般是源代码中有 Cython 不支持的语句, 或者文件名不支持等. 可以查阅 Cython Wiki 项目 官方文档, 或者提 Issue.

📅 更新记录

V2 版本

1. 20250623 release V2.1.0 禁用激进的性能优化选项. 显示系统信息.
2. 20250609 release V2.0.0 重构了代码, 使用新的界面 (不安全版本)

V1 版本

1. 20220613 更新对Linux的支持, Linux下需要配置gcc&g++
2. 20221123 可以通过文件头手动指定不编译的文件
3. 20230306 更新可以指定命令行头如 Python310 以此支持非Widnows系统下编译
4. 20230324 更新文档
5. 20240506 修复编译失败时遗漏复原 __init__.py 的问题