Gawain - Enforce type hints on all Python variables
Show HN: Gawain – Require type hints on all Python variables
Gawain is a fast linter that requires type annotations on every Python variable, parameter, return, and class attribute, then runs a type checker like ty or pyrefly to verify correctness. Unlike ruff's ANN rules or flake8-annotations, which only check functions, Gawain also demands annotations on variables and class attributes, eliminating vague dict[str, Any] types. It offers obvious and strict modes, integrates with pre-commit, and runs in milliseconds—scanning the entire CPython standard library in under half a second. Install via pip or uv with the appropriate extra, and use it to enforce consistent typing across your codebase.
I built gawain only because I hate dict[str, Any] and wanted to do something about it.
- santiagobasulto
This is awful. I love type correctness, but going all the way to flag PORT=8080? There should be a basic level of type inference.
Especially for “typed” languages that have done typing very wrong, as Python or Typescript.
- gavmor
Gawain, the finest night alive (literally Þe most kydde knyȝtez vnder Krystes seluen) committed one indisputable, albeit minor, transgression under a regime of unsparing precision.
> ȝe han redily rehersed, bi resoun ful trwe,
Alle þe covenauntz þat I yow kende...
("You have readily recapitulated, by fully accurate accounting, all covenants that I declared.")
I can't think of a more fitting name except, perhaps, the speaker of these lines: the exacting Lord Bertilak.
- orsorna
This is cool. And I appreciate the cheeky comment about not using this program if your IDE or whatever does type checking already :)
But honestly, after I realized I appreciate types being enforced, I started writing in different languages. I rarely return to Python unless I'm scripting something that doesn't require longevity.
- michalc
I think similar to `dict[str, Any]`, my (justified?) recent pet peeve is `| None`.
I posted this yesterday pretty much on that: https://charemza.name/blog/posts/software/type-safety/type-s...
- Garlef
Maybe not for me but I love the attitude.
(And actually, my personal objection is incidental: The python syntax is not pretty to begin with and the situation does not improve with even more visual verbosity)