用 Pyrig 配合 uv 快速搭建 Python 项目简直是效率起

PromptCube 高级 2小时前 368 浏览 7 点赞 约 1 分钟

Python 项目最烦的就是初始化那一套,得配 linter、formatter、类型检查,还得手动写 GitHub Actions 的 CI 流程,每次新开项目都要重复这些机械劳动。我试了下 Pyrig,它把这套流程给自动化了,核心逻辑就是用一个命令把整个工程的骨架、配置甚至 CLI 界面全部直接生成好。

最让我觉得有意思的是它的配置管理机制。很多脚手架工具生成完文件就完事了,但 Pyrig 的配置文件背后其实对应着 Python 类。如果你想修改某个配置,不用在 YAML 或 TOML 里死磕,直接通过子类化(subclassing)就能覆盖。这种把配置“代码化”的思路在维护大型项目时应该挺好用,运行 pyrig sync 就能把所有配置同步更新。

对于习惯用 uv 的开发者来说,这个工具的集成度很高。一个简单的实操流程如下:

一、初始化环境
先用 uv 创建项目并安装 pyrig 为开发依赖:

uv init my-project --python 3.12
cd my-project
uv add pyrig --dev

二、执行项目初始化
运行初始化命令,它会自动帮你把目录结构、测试框架、Git hooks 以及一套完整的 GitHub Actions 工作流全部搞定:

uv run pyrig init

三、扩展功能
如果你需要给项目增加命令行指令,不用自己去写 argparse,直接运行:

uv run pyrig mk cmd <command_name>

它的测试同步功能也挺实用,运行 pyrig sync 会根据你的源代码模块自动生成测试骨架。这种“镜像式”的测试维护能很大程度上避免漏写测试用例的情况。

整体来看,Pyrig 不是简单的模板拷贝,而是一套带有继承机制的工程管理方案。如果你厌倦了每次建项目都要手动复制粘贴 .github/workflows 文件夹,这个工具绝对值得试一下。

pythonuvPyrigGitHub Actions

全部回复 (4)

极客阿强 中级 2小时前
配合uv确实快,我之前试过直接生成ci,省了好多写yaml的时间。
0 回复
产品经理大熊 高级 2小时前
之前手动配ruff和mypy真的心累,用这个确实能少写不少样板代码。
0 回复
前端大鹏 初级 2小时前
这玩意儿能直接配好pyproject.toml吗?还是得手动改下?
0 回复
产品经理阿强 中级 2小时前
基本都能自动生成,不过有些细节还是得手动微调下,你试过了吗?
0 回复

发表回复

支持 Markdown 格式