Проанализировать кодовую базу с помощью pygount

Как применить

Используйте этот вариант, когда пользователь запрашивает количество строк кода.

Используйте этот вариант, когда пользователь хочет увидеть распределение кода по языкам в репозитории.

Используйте этот вариант, когда пользователь интересуется размером или составом кодовой базы.

Используйте этот вариант, когда пользователь хочет узнать соотношение кода и комментариев.

Используйте этот вариант для общих вопросов о размере репозитория.

Сначала установите pygount в систему.

pip install --break-system-packages pygount 2>/dev/null || pip install pygount

Запустите базовую сводку из корня репозитория, чтобы получить полное распределение по языкам с указанием числа файлов, строк кода и комментариев.

cd /path/to/repo
pygount --format=summary \
  --folders-to-skip=".git,node_modules,venv,.venv,__pycache__,.cache,dist,build,.next,.tox,.eggs,*.egg-info" \
  .

Важно: всегда используйте параметр --folders-to-skip, чтобы исключить директории зависимостей и сборки; в противном случае pygount будет обрабатывать их, что займет много времени или приведет к зависанию.

Настройте списки исключений директорий в зависимости от типа проекта.

Для проектов на Python, JavaScript/TypeScript и для общих случаев предусмотрены отдельные списки исключений.

# Python projects
--folders-to-skip=".git,venv,.venv,__pycache__,.cache,dist,build,.tox,.eggs,.mypy_cache"

# JavaScript/TypeScript projects
--folders-to-skip=".git,node_modules,dist,build,.next,.cache,.turbo,coverage"

# General catch-all
--folders-to-skip=".git,node_modules,venv,.venv,__pycache__,.cache,dist,build,.next,.tox,vendor,third_party"

Фильтруйте результаты анализа по конкретным языкам, если нужно учитывать только определенные типы файлов.

# Only count Python files
pygount --suffix=py --format=summary .

# Only count Python and YAML
pygount --suffix=py,yaml,yml --format=summary .

Используйте формат по умолчанию для подробного разбора по файлам, а затем передайте вывод через sort, чтобы отсортировать файлы по количеству строк кода.

# Default format shows per-file breakdown
pygount --folders-to-skip=".git,node_modules,venv" .

# Sort by code lines (pipe through sort)
pygount --folders-to-skip=".git,node_modules,venv" . | sort -t$'\t' -k1 -nr | head -20

Выберите формат вывода: таблицу сводки, JSON для программной обработки или удобный для конвейеров формат.

# Summary table (default recommendation)
pygount --format=summary .

# JSON output for programmatic use
pygount --format=json .

# Pipe-friendly: Language, file count, code, docs, empty, string
pygount --format=summary . 2>/dev/null

Всегда исключайте директории .git, node_modules и venv: без параметра --folders-to-skip pygount будет обрабатывать всё, что может занять минуты или привести к зависанию при больших деревьях зависимостей.

В формате Markdown отображается 0 строк кода, так как pygount относит весь контент Markdown к комментариям, а не к коду; это ожидаемое поведение.

В JSON-файлах указывается низкое количество строк кода, так как pygount может занижать их счёт; для точного подсчёта строк JSON используйте команду wc -l напрямую.

Для очень больших монорепозиториев рассмотрите возможность использования параметра --suffix для ограничения анализа конкретными языками вместо сканирования всего содержимого.