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.
  1. 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.

  2. 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.

  3. 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.

  4. 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...

  5. 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)

More from this day

2026-11-15