Что такое stub-файлы и для чего они используются?

Question

Stub-файлы — это файлы с аннотациями типов без реализации кода. Они используются для статического анализа и автодополнения. Обычно применяются, когда исходный код не содержит типов или написан на другом языке. Stub-файлы имеют расширение .pyi. Они помогают улучшить качество типизации без изменения рабочего кода.

YeaHub · Accepted Answer

Stub-файлы — важная часть экосистемы статической типизации Python.ОпределениеStub-файл (.pyi) — это файл, содержащий только сигнатуры функций, методов и классов без реализации.Зачем нужны stub-файлыОни применяются, когда:библиотека не имеет аннотаций типовкод сгенерирован или написан на Cтипизация не может быть добавлена напрямуюПример stub-файла# math_utils.pyi
def add(a: int, b: int) -> int: ...Файл:описывает интерфейсне содержит логикииспользуется анализаторами (mypy, pyright)Где используются stub-файлыВнешние библиотекистандартная библиотекаC-расширенияБольшие legacy-проектыпостепенное внедрение типизацииИнструменты разработкиавтодополнениепроверка типовнавигация по кодуГде они хранятсяStub-файлы могут находиться:рядом с .py файламив typeshedв отдельных пакетах types-*ВыводStub-файлы позволяют добавить строгую типизацию без изменения исполняемого кода, что делает их незаменимыми для библиотек и legacy-систем.