Каждый день · проверено по первоисточникуВсе выпуски
Применяй ИИ
Новости ИИ и технологий каждый день
Находки и код

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 не нужен.
  • Строгость можно менять, а проверку типов отключить и оставить только поиск пропусков.

Что делать

  1. Установите утилиту командой uv tool install "gawain[ty]" или pip install "gawain[ty]".
  2. Запустите gawain check src/ --no-types, чтобы увидеть только пропущенные пометки.
  3. Уберите флаг --no-types, когда всё размечено, чтобы подключить проверку типов.
  4. Поставьте gawain[pyrefly] и добавьте --checker pyrefly, если хотите pyrefly вместо ty.

Чего пока неизвестно

В основе нет даты выпуска и данных о работе на реальных проектах, кроме одного замера скорости. Как поведёт себя бета-версия ty в следующих релизах, тоже не сказано.

Редакция «Применяй ИИ» · Как мы готовим новости

Ещё по теме