Skip to content

v1.0.1 —— 首个发布到 PyPI 的版本

Choose a tag to compare

View all tags
@lddd1026 lddd1026 released this 13 Oct 06:13
· 6 commits to main since this release
v1.0.1
1df6019

v1.0.1 —— 首个发布到 PyPI 的版本

pip install preflight-check-cli
preflight-check demo

CI 告诉你「测试通过了没有」。
这个工具告诉你「该做的测试有没有被做过」。

这一版为什么换了分发名

preflight-check 在 PyPI 上注册不了。PyPI 的「名字太相似」检查会把 - _ . 全删掉、
再把 l/L/i/I 换成 1、o/O 换成 0，然后全等比较 —— 而 preflight-check 与已存在的
pre-flight-check（v1.4.0，一个活跃的 AI agent
质量门禁项目）归一化后是同一个字符串。去掉连字符也救不了：preflightcheck 归一化后还是它。

所以只改了分发名，命令名和导入名一个都没变：

名字
分发（PyPI） preflight-check-cli
导入包 preflight_check
命令 preflight-check

v1.0.0 只发在 GitHub（那时 pyproject.toml 里还是旧名字）—— 所以 PyPI 首发是 1.0.1。

这一版验证到了什么

项 证据
CI 六格全绿：ubuntu / windows × Python 3.11 / 3.12 / 3.13（每格 544 passed, 5 skipped）
本地 546 passed + 3 skipped；mypy 44 个文件无错误；ruff check + format 干净
打包 sdist + wheel 构建、twine check 通过，PyPI 上有构建来源证明（OIDC attestation）
干净安装 新建虚拟环境里 pip install preflight-check-cli，preflight-check demo 的输出与 README 第一屏逐行一致

顺带一提：v1.0.0 之前那次 CI 是第一次真跑，它在 windows-latest 上抓出 4 个本地
一条都看不到的失败（3 条是子进程输出编码只钉了一头 —— 把一次崩溃读成了「没问题」；
1 条是断言假设只在虚拟环境里成立）。修完才有这一版。

还没做的（说清楚比含糊好）

  • 矩阵覆盖 3/60 —— 60 个「机制 × 不变量」格子里只有 3 格有规则真的去查。最大的功能缺口。
  • 问卷的 5 条答案目前只进报告，还没接到严重度 / 门禁上。
  • demo 在中文区域的 Windows 上、输出被重定向时会崩（🔴 这类 emoji 编不进 cp936 代码页；
    加 PYTHONIOENCODING=utf-8 正常，其余命令不受影响）。
  • 只在 2 个真实项目上验证过，换一种文档风格表现未知。

MIT 许可。踩过的 18 个坑在
docs/PITFALLS.md
—— 那可能是这个仓库里最值钱的一份文档。

Assets 2
Loading