py2pydso 1.2.0

Compile Python source files into .pyd or .so extension modules for distribution and source protection.

py2pydso

Compile Python source files into .pyd / .so native extensions for distribution and source protection.

---

✨ Features

• 🔒 源码保护 — 将 .py 编译为 .pyd/.so 原生扩展，不暴露源码
• 📦 三种编译模式 — 单文件 / 模块目录 / 完整 wheel 包
• 🗂️ 智能过滤 — 自动保留 __init__.py 等元文件，支持自定义排除
• 📝 类型提示 — 自动生成 .pyi 存根文件，保留 IDE 补全体验
• 🌍 跨平台 — Windows (.pyd) / Linux / macOS (.so) 全支持

---

安装

pip install py2pydso

安装完成后，可通过以下命令验证：

python -m py2pydso --help

依赖

py2pydso 会自动安装以下 Python 依赖：

依赖	用途
Cython	将 .py 转译为C代码并编译为原生扩展
setuptools	驱动编译流程
mypy	通过 stubgen 生成 .pyi 类型提示文件
tomli	解析 pyproject.toml（Python < 3.11 时自动安装）

C 编译器

编译原生扩展需要 C 编译器，请根据平台安装：

• Windows: Visual Studio Build Tools（勾选 "C++ build tools"）
• macOS: xcode-select --install
• Linux: sudo apt install build-essential gcc

使用方式

1. 编译单个文件

# 输出到源文件同目录
python -m py2pydso file -i demo.py

输出 demo.pyd（或 demo.so），位于 demo.py 同目录。

# 指定输出目录
python -m py2pydso file -i demo.py -o output

输出 output/demo.pyd。

python -m py2pydso file -i utils/demo.py

输出 utils/demo.pyd（或 utils/demo.so）。

2. 编译整个模块目录

python -m py2pydso module -i utils -o output

输入：

utils/
  __init__.py
  __main__.py
  tools.py
  config.py

输出：

output/
  utils/
    __init__.py      ← 原样保留（__开头）
    __main__.py      ← 原样保留（__开头）
    config.py        ← 原样保留（--exclude-files 指定）
    tools.pyd        ← 编译产物

• __开头的 .py 文件（如 __init__.py、__main__.py）原样保留，不参与编译
• 支持 --exclude-files 指定额外排除的文件（可多个）：

  python -m py2pydso module -i utils -o output --exclude-files config.py constants.py
  

• 支持子目录递归编译

3. 构建完整 wheel 包

python -m py2pydso package --package-name loki_service

构建保护版本的 wheel 包（.pyi 类型提示 + .pyd/.so 原生扩展），不暴露源码。

# 跳过 stubgen，异常时保留临时目录用于调试
python -m py2pydso package --package-name loki_service --skip-stubgen --keep-tmp

# 指定输出目录
python -m py2pydso package --package-name loki_service --output-dir /path/to/wheelhouse

输出：<package_name>-x.x.x-cpYY-cpYY-<platform>.whl

公共参数

参数	说明
--keep-tmp	保留临时编译目录，用于调试

命令行帮助

python -m py2pydso --help
python -m py2pydso file --help
python -m py2pydso module --help
python -m py2pydso package --help