В Python куча инструментов — линтеры, форматтеры, анализаторы покрытия, type-checkers.
И почти каждый из них использует специальные комментарии в коде: # noqa, # type: ignore, # fmt: off, # nosec и так далее.
Проблема в том, что единого стандарта для таких комментариев до сих пор не было.
Metacode вводит простой и понятный формат машиночитаемых комментариев, основанный на подмножестве синтаксиса Python:
# key: action[arg1, arg2]
Например:
# type: ignore[error-code]
# fmt: off
Такой формат:
— легко читать человеку
— легко парсить машине
— позволяет несколько комментариев в одной строке
— не привязан к конкретному инструменту
У библиотеки минимальный API:
▪️ parse() — читает комментарии и возвращает структурированный результат
▪️ insert() — аккуратно добавляет комментарии в код
Поддерживаются строки, числа, bool, None, ..., а при желании — даже AST.
🔗 Github
📍 Навигация: Вакансии • Задачи • Собесы
🐸 Библиотека питониста
#буст