gawain требует аннотации типов в Python и проверяет их через ty
Утилита gawain с GitHub требует расставить в Python-коде аннотации типов и проверяет их. Аннотация — пометка, какие данные ждут: число, строку или список.
Так ошибку вроде «ждали число, а вернули строку» видно при проверке, до запуска программы. Проект открытый, ty автор называет бетой.
Коротко
- Ищет пропуски у переменных, параметров, возвращаемых значений и атрибутов классов.
- Типы сверяет ty (по умолчанию) или pyrefly — программы, которые проверяют, сходятся ли типы.
- Скорость замерили в одном тесте на одном компьютере: медиана 0,46 с на почти миллионе строк.
Сначала ищет пропуски, и только потом сверяет типы
Пока в коде есть места без пометок, gawain пропускает проверку типов и пишет об этом в отчёте. Когда всё размечено, подключается ty или pyrefly.
В примере из описания функция должна вернуть целое число, а возвращает строку «0». ty сообщает об ошибке в нужной строке.
Если нужны только пометки, проверку типов отключает флаг --no-types.
От ruff его отличает внимание к переменным
Программы вроде ruff и flake8-annotations требуют пометки только у функций. gawain просит их ещё у переменных и атрибутов классов.
В обычном режиме пометка не нужна, если тип значения очевиден и имени больше ничего не присваивают. Это литерал, список литералов или вызов конструктора вроде User("ada"). Строгий режим просит пометку на каждое присваивание.
Константе вроде PORT = 8080 нужна особая пометка. Отдельную строку можно исключить комментарием с кодом правила.
Скорость близка к ruff, но замер только один
Тест шёл без проверки типов на стандартной библиотеке Python. gawain в обычном режиме справился за 0,46 с, в строгом — за 0,36 с, ruff — за 0,35 с, flake8-annotations — за 11,4 с. Ruff при этом проверяет меньше: только функции.
Автор оговаривает, что это один тест на одном компьютере. Он же предупреждает: ty в бете, и её сообщения могут меняться между версиями.
Что это значит для вас
- Инструмент рассчитан на тех, кто пишет на Python.
- Автор пишет, что тем, кому хватает вывода типов в редакторе, gawain не нужен.
- Строгость можно менять, а проверку типов отключить и оставить только поиск пропусков.
Что делать
- Установите утилиту командой uv tool install "gawain[ty]" или pip install "gawain[ty]".
- Запустите gawain check src/ --no-types, чтобы увидеть только пропущенные пометки.
- Уберите флаг --no-types, когда всё размечено, чтобы подключить проверку типов.
- Поставьте gawain[pyrefly] и добавьте --checker pyrefly, если хотите pyrefly вместо ty.
Чего пока неизвестно
В основе нет даты выпуска и данных о работе на реальных проектах, кроме одного замера скорости. Как поведёт себя бета-версия ty в следующих релизах, тоже не сказано.
Редакция «Применяй ИИ» · Как мы готовим новости