Folia
← 返回头版

开发者推出 Gawain:一款强制要求全变量类型注解的 Python 检查工具

Matheus Gomes 发布了名为 Gawain 的开源项目,这是一款旨在严格规范 Python 代码类型的检查工具 1。与 ruff 仅要求函数添加注解不同,Gawain 强制要求对代码中的所有变量、参数、返回值以及类属性进行类型注解 1。该工具集成了 Astral 的 ty 或 Meta 的 pyrefly 等类型检查器以验证注解的正确性,旨在消除未标注类型或使用模糊类型(如 dict[str, Any])的情况 1。

在功能配置上,用户可使用 --mode strict 标志进一步要求每一个赋值操作都包含明确的类型注解 1。安装方面,用户可通过 uv tool install "gawain[ty]" 安装默认版本,或通过指定 [pyrefly] 选项使用另一种后端 1。Gawain 定义了清晰的退出码规则:无问题时返回 0,发现错误时返回 1,若存在用法错误则返回 2 1。此外,该项目采用 MIT 许可证开源,并已在 CPython 3.14 标准库(包含 1,847 个文件、974,586 行代码)上进行过基准测试 1。


评论