Ruffやflake8-annotationsのような標準的なPythonリンターは、通常、関数のパラメータと戻り値の型ヒントのみを要求しますが、Gawainはコードベース内のすべての変数、パラメータ、およびクラス属性に対して注釈を強制します。`dict[str, Any]`のような汎用的な型の使用を排除するために開発されたこのツールは、ミリ秒単位で欠落している注釈を特定し、Pythonのネイティブな推論よりも明示的な宣言を好む開発者に対して、より厳格な型安全性のレイヤーを提供します。
関数シグネチャを超えて
ほとんどのPython型チェックのワークフローは、関数に戻り値の型とパラメータの注釈があるかを確認するツールに依存しています。Gawainはこの要件をコードの内部ロジックまで拡張し、明示的な型宣言を欠いている変数をフラグ立てします。
例えば、Gawainは`PORT = 8080`のような定数が`Final[int]`として注釈されていない場合や、クラス属性がクラスボディ内で対応する宣言なしに代入されている場合にエラーを報告します。

このスクリーンショットは、Gawainが検証する特定の型注釈と変数宣言を例示しています
メカニズムと統合
Gawainは、まずソースコードをスキャンして「存在」エラー(欠落している注釈)を特定することで、型の整合性のゲートキーパーとして機能します。すべての必要なヒントが存在することを確認した後にのみ、`ty`や`pyrefly`などのバックエンドを使用して完全な型チェックを実行します。
ユーザーは、未注釈のリテラル(例:`count = 0`)やコンテナのリテラルを許可する「obvious」モードと、すべての代入に対して注釈を要求する「strict」モードのいずれかを選択できます。
パフォーマンスとトレードオフ
このツールは、高速な結果を得るために`ruff_python_parser`を利用した高性能な分析のために構築されています。CPython 3.14の標準ライブラリに対するテストでは、Gawainは「obvious」モードで約0.46秒でチェックを完了しました。
HN Digestによるグラフ。github.comの報告数値に基づく。値はソースの記載通り。
Gawainを使用する際の主なトレードオフは、コードベースの冗長性が増加することです。すべての変数にヒントを要求することで、Pythonのネイティブな推論機能を避け、明示的で読みやすい型定義を優先するアプローチへと移行します。