PyBuilder:一个专门为 Python 项件量身定做的构建工具

PyBuilder 是啥玩意儿？PyBuilder 就是专门为 Python 项件量身定做的构建工具，整个代码全是纯 Python 写的，装上以后，你可以把“跑测试、生成文档、打包发布”这些琐碎活儿全交给它。它的理念跟 Java 那些老牌构建工具（Maven、Gradle）有点像——基于依赖的插件系统，想干啥就装啥插件，灵活得很。

为啥要用 PyBuilder？

• • 手动操作太繁琐：每次跑测试、生成文档、打包，都得敲一堆命令，尤其是项目大了以后，容易忘记哪个步骤漏了。
• • 团队协作不统一：新人进来，环境不对，构建失败，大家只能在 Slack 里互相求助。
• • 插件生态还行：官方自带的插件已经能覆盖大多数需求，想要更高级的功能，只要自己写个插件也不难。

换句话说，PyBuilder 就是帮你把这些“重复劳动”搬到配置文件里，让 CI/CD 流程跑得更顺畅。

装起来超简单

# 正式版pip install pybuilder# 想尝鲜（pre-release）可以加上 --prepip install --pre pybuilder

装完以后，项目根目录里新建 build.py，写几行代码就能跑起来。下面给你演示一个最小示例：

# build.pyfrom pybuilder.core import use_plugin, init# 必装插件use_plugin("python.core")use_plugin("python.unittest")use_plugin("python.coverage")use_plugin("python.distutils")# 默认任务：执行完所有步骤后直接 publish（发布到 PyPI）default_task = "publish"

保存后，执行：

pyb clean install

• • clean → 把旧的产物删掉
• • install → 安装依赖、跑测试、生成覆盖率报告、打包

如果想一步到位直接发布，直接跑 pyb（默认执行 publish）。

基本使用流程

小贴士：如果你只想跑测试，pyb run_unit_tests 就能搞定；想看覆盖率报告，pyb coverage_report。

优点 & 缺点

小结PyBuilder 把传统的构建流程搬进了 Python 世界，用插件化的方式把测试、覆盖率、文档、打包全都串起来。装个 pip install pybuilder，写几行 build.py，基本的 CI/CD 就能跑起来。它的缺点主要是生态和社区规模不如 poetry、tox 那么大，但如果你追求“一次配置，处处可用”的便利感，PyBuilder 完全能满足需求。赶紧在你的下一个项目里试试吧，省下的时间可以去写代码、喝咖啡甚至追剧。

项目地址： https://github.com/pybuilder/pybuilder