Repolode
PyCQA

PyCQA/pycodestyle

Однофайловый анализатор Python, который проверяет соответствие кода стилю PEP 8 и использует только стандартную библиотеку.

Звёзды
5,165
Форки
762
Открытые issues
105
Последний коммит
позавчера

Что это?

pycodestyle проверяет исходный код Python на соответствие некоторым правилам стиля из PEP 8 — официального руководства по стилю Python. Он сообщает о нарушениях: например, нескольких импортах в одной строке, неверном количестве пустых строк между функциями, лишних пробелах и слишком длинных строках. Каждому нарушению присваивается код, например E401 или E302, и указывается его расположение в файле.

Проект поставляется в виде одного Python-файла и использует только стандартную библиотеку, поэтому его можно просто добавить в проект. Вывод можно настроить так, чтобы редактор переходил к каждой ошибке; также инструмент может показывать строку исходного кода с нарушением и соответствующее правило PEP 8. Режим статистики подсчитывает, как часто встречается каждая ошибка в кодовой базе.

Инструмент построен на архитектуре плагинов, которая позволяет добавлять новые проверки. Раньше он назывался pep8, но название изменили, чтобы его не путали с документом PEP 8.

Ключевые возможности

  • 01Проверяет код на соответствие множеству правил стиля PEP 8 и присваивает каждому нарушению стабильный код.
  • 02Поставляется в виде одного файла и зависит только от стандартной библиотеки Python.
  • 03Указывает файл, строку и столбец каждой ошибки, чтобы редактор мог перейти к ней.
  • 04Может показывать строку исходного кода с нарушением и соответствующее правило PEP 8.
  • 05В режиме статистики подсчитывает ошибки в кодовой базе.
  • 06Поддерживает плагины для добавления пользовательских проверок.

Сценарии использования

  • Соблюдение единых правил форматирования PEP 8 в CI-процессах проекта на Python.
  • Получение подсказок по стилю прямо в редакторе во время написания кода на Python.
  • Анализ большой устаревшей кодовой базы, чтобы выяснить, какие нарушения стиля встречаются чаще всего.
  • Запуск лёгкой проверки стиля без установки дополнительных тяжёлых зависимостей.

Быстрый старт

  1. 1

    Установите pycodestyle с помощью pip

    pip install pycodestyle
  2. 2

    Запустите его для файла Python, чтобы проверить стиль

    pycodestyle --first optparse.py

Что важно знать

  • Лицензия не указана однозначно в метаданных (NOASSERTION), поэтому перед повторным использованием проверьте репозиторий.

В подборках

Темы

Частые вопросы

Что такое pycodestyle?
Однофайловый анализатор Python, который проверяет соответствие кода стилю PEP 8 и использует только стандартную библиотеку. pycodestyle проверяет исходный код Python на соответствие некоторым правилам стиля из PEP 8 — официального руководства по стилю Python. Он сообщает о нарушениях: например, нескольких импортах в одной строке, неверном количестве пустых строк между функциями, лишних пробелах и слишком длинных строках. Каждому нарушению присваивается код, например E401 или E302, и указывается его расположение в файле.
pycodestyle можно использовать бесплатно? Какая у него лицензия?
pycodestyle распространяется с открытым исходным кодом под лицензией Other. Перед использованием в коммерческих продуктах проверьте условия лицензии.
pycodestyle всё ещё поддерживается?
Активно поддерживается. Последний коммит в pycodestyle — 4 нояб. 2026 г..
Для чего можно использовать pycodestyle?
Соблюдение единых правил форматирования PEP 8 в CI-процессах проекта на Python. Получение подсказок по стилю прямо в редакторе во время написания кода на Python. Анализ большой устаревшей кодовой базы, чтобы выяснить, какие нарушения стиля встречаются чаще всего. Запуск лёгкой проверки стиля без установки дополнительных тяжёлых зависимостей.
Как установить pycodestyle?
Установите pycodestyle с помощью pip: pip install pycodestyle Запустите его для файла Python, чтобы проверить стиль: pycodestyle --first optparse.py
Где скачать pycodestyle?
Исходный код и инструкции по установке — на GitHub: https://github.com/PyCQA/pycodestyle

Описание создано ИИ на основе README проекта. Статистика GitHub обновляется ежедневно.

Похожие проекты