pretty-git 0.1.4 → 0.1.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7e190585a91de27221e54bc2cbc58b5f6d26a1428c2e5cd5189ff0c18d362e6c
-  data.tar.gz: f8d2bc8f5d6c6a4887a745abd611a038166bcb54e95267a15d4868ee9d530003
+  metadata.gz: 00b27dd7b14328c3aa2e5d3bf865dd778d512131d3f3b1c7d9fe1ca76939c5e6
+  data.tar.gz: 36c9f80ac26f1982bf2a4b2f1616bf5d309dec2c9dcda12603e2e2422500e3a4
 SHA512:
-  metadata.gz: e11fd51d24ed1e63fd5c773f76a46510bbcedad23c02ace63b25d7d80c366479fd02fe2bfabaa58693389c222bafe4fd9e6fc0b157b7d598e96294a3f888fbef
-  data.tar.gz: 38fc87c6467d72ae6a1cb63a13b06c417e81f714d5b074feae961f121e061cea0733494020e0b8f562f36ea00b2d537a0d6fd5ac36eea942465680376f8eb71e
+  metadata.gz: 8518117f9b018c89a31db647920d871fe68f1ba1a2ddb90e43f58ec08342c4d345393617144ba29705ef6a13f86c184123c72b99ee2de81ada45824df875593d
+  data.tar.gz: 59505cbed77cdf230c6b5c2960caa1bde851a4a17820d886b788b409a04f5b042cfe51e5a4e060471e90a303743369df335206f3fc51b97759c637086775abcf

data/CHANGELOG.md

@@ -5,66 +5,144 @@ All notable changes to this project will be documented in this file.
 The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.
 
 ## [Unreleased]
- 
+
+## [0.1.6] - 2025-10-10
+
+### Security
+
+- Git::Provider: added input validation for `--author` and `--branch` parameters to prevent command injection attacks
+- Git::Provider: `validate_safe_string` method checks for shell metacharacters (`; & | \` $ ( ) < >`)
+- Git::Provider: `validate_git_ref` method validates git reference format and rejects refs starting with `-`
+
+### Added
+
+- Render::ConsoleRenderer: named constants for ANSI color codes (`Colors::AnsiCodes` module)
+- Render::ReportSchema: centralized module for report headers (eliminates duplication across CSV/Markdown renderers)
+- CLI: verbose mode now includes full backtrace for `StandardError` exceptions (helps with debugging)
+- Analytics::Languages: `safe_file_size` and `safe_count_lines` now log warnings to stderr when `verbose=true`
+- Tests: 20+ negative test cases for input validation (`spec/pretty_git/git/provider_validation_spec.rb`)
+- Tests: CLI error handling coverage (`spec/pretty_git/cli_error_handling_spec.rb`)
+
+### Changed
+
+- CLI: enhanced error handling with specific exit codes: `ArgumentError` → 1, file system errors (`ENOENT`, `EACCES`) → 2, other errors → 99
+- CLI: improved error messages for `ArgumentError`, `Errno::ENOENT`, and `Errno::EACCES`
+- Render::CsvRenderer: refactored to use `ReportSchema.headers_for` instead of local `HEADERS` constant
+- Render::MarkdownRenderer: refactored to use `ReportSchema.headers_for` instead of local `HEADERS` constant
+
+### Fixed
+
+- Security: command injection vulnerabilities via `--author` and `--branch` parameters accepting unvalidated shell input
+
+### Documentation
+
+- Docs: `docs/testing.md` covering the golden workflow, snapshot update/validation; linked from `README.md`, `README.ru.md`, and `CONTRIBUTING.md`.
+- Tests: determinism invariants for YAML/XML renderers (stable output regardless of input order).
+- Scripts: `scripts/release.sh` automated release workflow with validation, testing, and git operations
+
+### Refactoring
+
+- Code quality: eliminated ~40 lines of duplicated `HEADERS` definitions across renderers
+- Readability: replaced magic numbers (`'1;35'`, `'1;36'`) with descriptive constant names (`BRIGHT_TITLE`, `BASIC_TITLE`)
+
+### Changed (from previous Unreleased)
+
+- Completions: refreshed bash/zsh completions — added short flags `-f`/`-o`/`-l`, values for `--time-bucket` (`day|week|month`), and repo path completion as the 2nd positional argument.
+
+## [0.1.5] - 2025-08-17
+
+### Added
+
+- CLI: warn to stderr when `--theme`/`--no-color` are used with non-console `--format` values.
+- Docs: expanded Filters documentation (branches, authors, paths, time semantics, verbose diagnostics), schemas/examples pointers, performance and CI usage.
+- Tests: unit tests for `PrettyGit::Utils::TimeUtils`.
+
+### Changed
+
+- Internals: extracted time parsing/normalization to `PrettyGit::Utils::TimeUtils` and centralized verbose logging via `PrettyGit::Logger`. `Git::Provider` routes verbose messages through the centralized logger (stderr).
+- Verbose mode: documentation clarified to note that diagnostics are printed to stderr for easier CI parsing.
+
+### Deprecated
+
+- Filters: legacy `:until` keyword in `PrettyGit::Filters` initialization is accepted for backward compatibility and emits a deprecation warning; use `:until_at` instead.
+
+### Fixed
+
+- Filters: allow initialization via a single Hash argument (legacy call sites) while preserving `Struct` keyword semantics.
 
 ## [0.1.4] - 2025-08-17
+
 ### Added
+
 - Integration tests for new reports exports: CSV/Markdown/YAML/XML for `hotspots`, `churn`, `ownership`.
 - Schema validations: `rake validate:json`, `rake validate:xml` to ensure format compatibility.
 - CI: expanded matrix to include macOS; smoke test for installed binary (`--help`, `--version`).
 
 ### Changed
+
 - Renderers (`MarkdownRenderer`, `YamlRenderer`, `XmlRenderer`): deterministic sorting for all new reports according to `docs/determinism.md`.
 - XML: per-report root elements in XML exports to match XSDs (`hotspotsReport`, `churnReport`, `ownershipReport`, `languagesReport`, etc.).
 - Documentation: `README.md` and `README.ru.md` updated with sections and examples for new reports and all export formats.
 - CLI: keep `--time-bucket` permissive; default `time_bucket=nil`.
 
 ### Fixed
+
 - Time parsing: interpret date-only inputs (`YYYY-MM-DD`) as UTC midnight and normalize to UTC ISO8601.
 - CLI UX: error when `--metric` is used outside `languages` report.
 - Tests/specs: updated XML specs to per-report roots; added timezone edge cases; fixed Open3 `popen3` stubs (`chdir:`) and integration requires.
 
-
 ## [0.1.3] - 2025-08-14
+
 ### Added
+
 - New analytics reports: `hotspots`, `churn`, `ownership` with sorting, scoring, and limits.
 - Exporters: CSV and Markdown support for new reports with dynamic headers via mapping constants.
 - Docs: Detailed sections for new reports in `README.md` and `README.ru.md` with usage and examples (CSV/JSON/YAML/XML).
 
 ### Changed
+
 - Console: dispatching and rendering wired for new reports; consistent theming and width handling.
 - CLI/App: unified analytics dispatch for all reports.
-- Docs: public READMEs cleaned up from internal DR-* mentions; anchors and headings aligned (CSV).
+- Docs: public READMEs cleaned up from internal DR-\* mentions; anchors and headings aligned (CSV).
 
 ### Fixed
-- Minor documentation inaccuracies and anchor mismatches.
 
+- Minor documentation inaccuracies and anchor mismatches.
 
 ## [0.1.2] - 2025-08-13
+
 ### Added
+
 - Languages report: support multiple metrics — `bytes`, `files`, `loc`; dynamic columns in Console/CSV/Markdown; color and percent fields in output.
 - CLI: `--metric` option for the `languages` report with value validation.
 
 ### Changed
+
 - Languages: JSON language reinstated in the mapping and color scheme; sorting and percent calculations are based on the selected metric; percentages rounded to two decimals.
 - Renderers: updated `csv`, `markdown`, and console renderers to work with dynamic metrics.
 - Internal specs updated: `docs/output_formats.md`, `docs/cli_spec.md`, `docs/languages_map.md`.
 
 ### Fixed
+
 - Git provider: correct commit counting — emit a new commit when a header is read and remove the record separator from the subject (`lib/pretty_git/git/provider.rb`).
 - RuboCop: targeted suppressions for complex methods/classes and style fixes in `cli_helpers.rb`.
 
 ## [0.1.1] - 2025-08-13
+
 ### Changed
+
 - Release automation: added GitHub Actions workflow to publish gem on tags and open PR to Homebrew tap (`.github/workflows/release.yml`).
 - Documentation: README badges and installation instructions for Homebrew and RubyGems in `README.md` and `README.ru.md`.
 - Gemspec: bounded runtime dependencies for `csv` and `rexml` to satisfy RubyGems recommendations.
 
 ### Fixed
+
 - Homebrew formula installation stability: formula installs gem into `libexec/vendor` and wraps `pretty-git` binary to avoid file collisions on reinstall.
 
 ## [0.1.0] - 2025-08-13
+
 ### Added
+
 - Languages report: bytes per language, percentages, sorting, limit.
 - Console: colorized languages section; terminal width handling via `TerminalWidth`.
 - Export: languages in Markdown/CSV/JSON/YAML/XML.
@@ -75,10 +153,12 @@ The format is based on Keep a Changelog, and this project adheres to Semantic Ve
 - Docs: Added screenshot `PrettyGitConsoleLanguages.png`.
 
 ### Changed
+
 - Analytics: exclude JSON from language mapping by default to avoid data skew.
 - Analytics: ignore Python env/cache directories by default.
 - Refactor: `ConsoleRenderer` split (LanguagesSection, TerminalWidth); reduced complexity.
 - App: extracted `analytics_for` from `App#run`.
 
 ### Fixed
+
 - RuboCop violations in new specs and minor guard clause spacing.

data/README.md

@@ -58,6 +58,13 @@ Generator of rich reports for a local Git repository: summary, activity, authors
 * **Exports**: `console`, `json`, `csv`, `md`, `yaml`, `xml`.
 * **Output**: to stdout or file via `--out`.
 
+## ❓ Why Pretty Git
+* **One tool, many views**: activity, authorship, hotspots, languages, ownership — consistent UX and outputs.
+* **Deterministic results**: stable sorting and formatting make it reliable for CI and diffs.
+* **Format-first**: JSON/CSV/Markdown/YAML/XML out of the box with strict and documented rules.
+* **Fast enough for daily use**: streams `git log` and aggregates in-memory; tips below for large repos.
+* **Safe defaults**: sensible path and binary ignores for the `languages` report; colorized console output with themes.
+
 ## ⚙️ Requirements
 * **Ruby**: >= 3.4 (recommended 3.4.x)
 * **Git**: installed and available in `PATH`
@@ -142,12 +149,15 @@ Key options:
 * **--no-color** Disable colors in console
 * **--theme** `basic|bright|mono` — console theme (default `basic`; `mono` forces monochrome)
 * **--metric** `bytes|files|loc` — metric for `languages` report (default `bytes`)
+* **--verbose** Print debug information (effective git command, filters)
 
 Examples with multiple values:
 
 ```bash
-# Multiple branches
+# Multiple branches (treated as explicit revisions)
 pretty-git summary . --branch main --branch develop
+## This is equivalent to:
+## git log main develop -- ...
 
 # Filter authors (include/exclude)
 pretty-git authors . --author alice@example.com --exclude-author bot@company
@@ -157,7 +167,30 @@ pretty-git files . --path app,lib --exclude-path vendor,node_modules
 ```
 
 ### Filters
-Filters apply at commit fetch and later aggregation. Date format: ISO8601 or `YYYY-MM-DD`. If timezone is omitted — your local zone is assumed; output timestamps are normalized to UTC.
+Filters apply at commit fetch and later aggregation. Below — exact semantics and tips.
+
+#### Branches / revisions
+* `--branch BRANCH` may be provided multiple times.
+* Multiple branches are treated as explicit revisions to `git log` (no implicit merge-base range). Example: `--branch main --branch develop` → `git log main develop -- ...`.
+* If no branches are specified, the repository’s current `HEAD` is used.
+
+#### Authors
+* `--author` and `--exclude-author` accept name or email substrings (case-insensitive match by `git log`).
+* Multiple values may be provided by repeating the option.
+
+#### Paths
+* `--path` and `--exclude-path` accept comma-separated values or repeated options.
+* Globs are supported by git pathspec. Excludes are translated to `:(exclude)pattern` and applied consistently.
+* When only excludes are present, `.` is included to ensure the pathspec is valid (mirrors tests in `spec/pretty_git/git/provider_spec.rb`).
+
+#### Time period
+* `--since` / `--until`: ISO8601 (e.g. `2025-01-31T12:00:00Z`) or `YYYY-MM-DD`.
+* Date-only values are interpreted as UTC midnight to avoid timezone drift in different environments.
+* Time values are normalized to UTC in outputs.
+
+#### Verbose diagnostics
+* `--verbose` prints the effective `git log` command and active filters to stderr.
+* Useful for debugging filters, CI logs, or when reproducing results locally.
 
 ### Output format
 Set via `--format`. For file formats it’s recommended to use `--out`.
@@ -397,6 +430,13 @@ _Example terminal output (theme: basic)._
   {"report":"summary","generated_at":"2025-01-31T00:00:00Z","totals":{"commits":123}}
   ```
 
+## 🧾 Schemas and Examples
+Machine-readable examples and schemas live under `docs/export_schemas/` and `docs/examples/`.
+
+* **Schemas**: see `docs/export_schemas/README.md` for JSON and XML schema notes.
+* **Examples**: example payloads for JSON/XML for each report under `docs/examples/`.
+* Intended use: validation in CI, contract documentation, and integration tests.
+
 ### CSV
 * **Structure**: flat table, first line is header.
 * **Encoding**: UTF‑8 without BOM.
@@ -495,16 +535,46 @@ These lists mirror the implementation in `lib/pretty_git/analytics/languages.rb`
 ## 🔁 Determinism and Sorting
 Output is deterministic given the same input. Sorting for files/authors: by changes (desc), then by commits (desc), then by path/name (asc). Limits are applied after sorting; `all` or `0` means no limit.
 
+## ⚡ Performance Tips
+* Prefer narrowing by `--path`/`--exclude-path` and `--since/--until` on large repositories.
+* Use multiple `--branch` only when you explicitly want to include several heads; otherwise rely on current `HEAD`.
+* For CI, cache the repository and fetch shallow history if full history is unnecessary for your report.
+
+## 🤖 CI Usage
+Examples for common pipelines:
+
+```yaml
+# GitHub Actions (excerpt)
+jobs:
+  reports:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: '3.4'
+      - run: gem install pretty-git
+      - run: pretty-git authors . --format json --out authors.json
+      - uses: actions/upload-artifact@v4
+        with:
+          name: authors-report
+          path: authors.json
+```
+
 ## 🪟 Windows Notes
-Primary targets — macOS/Linux. Windows is supported best‑effort:
-* Running via Git Bash/WSL is OK
-* Colors can be disabled by `--no-color`
-* Carefully quote arguments when working with paths
+Primary targets — macOS/Linux. Windows is supported best‑effort. See detailed notes in [docs/windows.md](docs/windows.md).
+
+Highlights:
+* Running via Git Bash/WSL is recommended.
+* CRLF output from git is handled by the parser; exports use UTF‑8 with LF.
+* Path filters are normalized to Unicode NFC when available; otherwise pass‑through.
+* Colors can be disabled by `--no-color` or `--theme mono`.
 
 ## 🩺 Diagnostics and Errors
 Typical issues and solutions:
 
 * **Unknown report/format** — check the first argument and `--format`.
+* **Debugging** — add `--verbose` to see the effective `git log` command and applied filters.
 * **Invalid date format** — use ISO8601 or `YYYY-MM-DD` (e.g., `2025-01-31` or `2025-01-31T12:00:00Z`).
 * **Git not available** — ensure `git` is installed and in the `PATH`.
 * **Empty result** — check your filters (`--since/--until`, `--branch`, `--path`); your selection might be too narrow.
@@ -527,5 +597,7 @@ bundle exec rubocop
 
 Style — RuboCop clean. Tests cover aggregators, renderers, CLI, and integration scenarios (determinism, format correctness).
 
+For detailed testing strategy, determinism rules, and golden tests workflow (how to run/update snapshots), see `docs/testing.md`.
+
 ## 📄 License
 MIT © Contributors

data/README.ru.md

@@ -20,6 +20,7 @@
 
 ## Содержание
 - [Возможности](#возможности)
+- [Почему Pretty Git](#почему-pretty-git)
 - [Требования](#требования)
 - [Установка](#установка)
 - [Быстрый старт](#быстрый-старт)
@@ -41,11 +42,14 @@
 - [Экспорт в форматы](#экспорт-в-форматы)
   - [Console](#console)
   - [JSON](#json)
+  - [Схемы и примеры](#схемы-и-примеры)
   - [CSV](#csv)
   - [Markdown](#markdown)
   - [YAML](#yaml)
   - [XML](#xml)
 - [Детерминизм и сортировка](#детерминизм-и-сортировка)
+- [Советы по производительности](#советы-по-производительности)
+- [Использование в CI](#использование-в-ci)
 - [Советы по Windows](#советы-по-windows)
 - [Диагностика и ошибки](#диагностика-и-ошибки)
 - [FAQ](#faq)
@@ -58,6 +62,13 @@
 * __Экспорт__: `console`, `json`, `csv`, `md`, `yaml`, `xml`.
 * __Вывод__: в stdout или файл через `--out`.
 
+## ❓ Почему Pretty Git
+* __Один инструмент — много представлений__: активность, авторство, риск, языки, владение — единый UX и форматы.
+* __Детерминированные результаты__: стабильные сортировки и форматирование — удобно для CI и диффов.
+* __Сразу форматы__: JSON/CSV/Markdown/YAML/XML из коробки с чёткими правилами.
+* __Достаточно быстро__: потоковый `git log` и ин‑мемори агрегации; советы для больших репозиториев ниже.
+* __Безопасные дефолты__: разумные игноры путей и бинарников для отчёта `languages`; цветной консольный вывод с темами.
+
 ## ⚙️ Требования
 * __Ruby__: >= 3.4 (рекомендуется 3.4.x)
 * __Git__: установлен и доступен в `PATH`
@@ -142,12 +153,15 @@ pretty-git <report> <repo_path> [options]
 * __--no-color__ Отключить цвета в консоли
 * __--theme__ `basic|bright|mono` — тема оформления консольного вывода (по умолчанию `basic`; `mono` принудительно отключает цвета)
 * __--metric__ `bytes|files|loc` — метрика для отчёта `languages` (по умолчанию `bytes`)
+* **--verbose** Печатать отладочную информацию (эффективная команда git, применённые фильтры)
 
 Примеры значений с несколькими параметрами:
 
 ```bash
-# Несколько веток
+# Несколько веток (трактуются как явные ревизии)
 pretty-git summary . --branch main --branch develop
+## Эквивалентно:
+## git log main develop -- ...
 
 # Фильтрация по авторам (включая/исключая)
 pretty-git authors . --author alice@example.com --exclude-author bot@company
@@ -157,7 +171,30 @@ pretty-git files . --path app,lib --exclude-path vendor,node_modules
 ```
 
 ### Фильтры
-Фильтры применяются на этапе выборки коммитов и последующей агрегации. Формат дат: ISO8601 или `YYYY-MM-DD`. Если часовой пояс не указан — используется локальная зона пользователя; на выводе время нормализуется к UTC.
+Фильтры применяются на этапе выборки коммитов и последующей агрегации. Ниже — точные правила и советы.
+
+#### Ветки / ревизии
+* `--branch BRANCH` можно указывать несколько раз.
+* Несколько веток трактуются как явные ревизии для `git log` (без неявного диапазона от merge-base). Пример: `--branch main --branch develop` → `git log main develop -- ...`.
+* Если ветки не указаны — используется текущий `HEAD` репозитория.
+
+#### Авторы
+* `--author` и `--exclude-author` принимают подстроки имени или email (регистронезависимо по логике `git log`).
+* Можно передавать несколько значений повтором опции.
+
+#### Пути
+* `--path` и `--exclude-path` принимают значения через запятую или повтором опции.
+* Поддерживаются glob‑маски git pathspec. Исключения переводятся в `:(exclude)pattern` и применяются последовательно.
+* Если заданы только исключения — автоматически добавляется `.` для корректного pathspec (как в тестах `spec/pretty_git/git/provider_spec.rb`).
+
+#### Период времени
+* `--since` / `--until`: ISO8601 (например, `2025-01-31T12:00:00Z`) или `YYYY-MM-DD`.
+* Даты без времени интерпретируются как полночь UTC, чтобы исключить сдвиги между средами.
+* На выводе время нормализуется к UTC.
+
+#### Подробная диагностика (verbose)
+* `--verbose` печатает эффективную команду `git log` и активные фильтры в stderr.
+* Полезно для отладки фильтров, логов CI и воспроизведения результатов локально.
 
 ### Формат вывода
 Задаётся через `--format`. Для файловых форматов рекомендуется использовать `--out`.
@@ -423,6 +460,13 @@ _Пример вывода в терминале (тема: basic)._
   {"report":"summary","generated_at":"2025-01-31T00:00:00Z","totals":{"commits":123}}
   ```
 
+## 🧾 Схемы и примеры
+Машиночитаемые примеры и схемы лежат в `docs/export_schemas/` и `docs/examples/`.
+
+* __Схемы__: смотрите `docs/export_schemas/README.md` с заметками по JSON и XML схемам.
+* __Примеры__: примеры нагрузок для JSON/XML по каждому отчёту — в `docs/examples/`.
+* Назначение: валидация в CI, документация контрактов и интеграционные тесты.
+
 ### CSV
 * __Структура__: плоская таблица, первая строка — заголовок.
 * __Кодировка__: UTF‑8, без BOM.
@@ -496,6 +540,32 @@ _Пример вывода в терминале (тема: basic)._
 ## 🔁 Детерминизм и сортировка
 Вывод детерминирован при одинаковых входных данных. Сортировка для файлов/авторов: по количеству изменений (desc), затем по числу коммитов (desc), затем по пути/имени (asc). Лимиты применяются поверх отсортированного списка; значение `all` или `0` означает отсутствие ограничения.
 
+## ⚡ Советы по производительности
+* На больших репозиториях сужайте выборку `--path/--exclude-path` и `--since/--until`.
+* Несколько `--branch` используйте, только если нужно включить несколько голов; иначе полагайтесь на текущий `HEAD`.
+* В CI кешируйте репозиторий и используйте shallow‑fetch, если полная история не нужна для выбранного отчёта.
+
+## 🤖 Использование в CI
+Пример для GitHub Actions:
+
+```yaml
+# GitHub Actions (фрагмент)
+jobs:
+  reports:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: '3.4'
+      - run: gem install pretty-git
+      - run: pretty-git authors . --format json --out authors.json
+      - uses: actions/upload-artifact@v4
+        with:
+          name: authors-report
+          path: authors.json
+```
+
 ## 🪟 Советы по Windows
 Целевая платформа — macOS/Linux. Windows поддерживается в режиме best‑effort:
 * Запуск через Git Bash/WSL допустим
@@ -505,7 +575,8 @@ _Пример вывода в терминале (тема: basic)._
 ## 🩺 Диагностика и ошибки
 Типичные ошибки и решения:
 
-* __Неизвестный отчёт/формат__ — проверьте значение первого аргумента и `--format`.
+* **Неизвестный отчёт/формат** — проверьте первый аргумент и `--format`.
+* **Отладка** — добавьте `--verbose`, чтобы увидеть фактическую команду `git log` и применённые фильтры.
 * __Неверный формат даты__ — используйте ISO8601 или `YYYY-MM-DD` (например, `2025-01-31` или `2025-01-31T12:00:00Z`).
 * __Git недоступен__ — убедитесь, что `git` установлен и доступен в `PATH`.
 * __Пустой результат__ — проверьте фильтры (`--since/--until`, `--branch`, `--path`), возможно, выборка слишком узкая.
@@ -528,5 +599,7 @@ bundle exec rubocop
 
 Стиль — RuboCop без ошибок. Тесты покрывают агрегаторы, рендереры, CLI и интеграционные сценарии (детерминизм, корректность форматов).
 
+Подробнее о стратегии тестирования, правилах детерминизма и процессе работы с golden‑тестами (как запускать/обновлять снапшоты) см. `docs/testing.md`.
+
 ## 📄 Лицензия
 MIT © Contributors

data/lib/pretty_git/analytics/languages.rb

@@ -1,6 +1,8 @@
 # frozen_string_literal: true
 
 require 'time'
+require 'json'
+require 'find'
 
 module PrettyGit
   module Analytics
@@ -79,30 +81,47 @@ module PrettyGit
     # Default metric: bytes (similar to GitHub Linguist approach).
     # rubocop:disable Metrics/ClassLength
     class Languages
+      # rubocop:disable Metrics/AbcSize, Metrics/MethodLength
       def self.call(_enum, filters)
         repo = filters.repo_path
-        items = calculate(repo, include_globs: filters.paths, exclude_globs: filters.exclude_paths)
+        prof = ENV['PG_PROF'] == '1'
+        t0 = Process.clock_gettime(Process::CLOCK_MONOTONIC) if prof
         metric = (filters.metric || 'bytes').to_s
+        items = calculate(repo, include_globs: filters.paths, exclude_globs: filters.exclude_paths, metric: metric)
         totals = compute_totals(items)
         items = add_percents(items, totals, metric)
         items = add_colors(items)
         items = sort_and_limit(items, filters.limit, metric)
 
-        build_result(repo, items, totals, metric)
+        res = build_result(repo, items, totals, metric)
+        if prof
+          t1 = Process.clock_gettime(Process::CLOCK_MONOTONIC)
+          elapsed = (t1 - t0)
+          files = totals[:files]
+          warn format(
+            '[pg_prof] languages: time=%<sec>.3fs files=%<files>d metric=%<metric>s',
+            { sec: elapsed, files: files, metric: metric }
+          )
+          summary = { component: 'languages', time_sec: elapsed, files: files, metric: metric }
+          warn("[pg_prof_json] #{summary.to_json}")
+        end
+        res
       end
+      # rubocop:enable Metrics/AbcSize, Metrics/MethodLength
 
       # rubocop:disable Metrics/AbcSize
-      def self.calculate(repo_path, include_globs:, exclude_globs:)
+      def self.calculate(repo_path, include_globs:, exclude_globs:, metric: 'bytes')
         by_lang = Hash.new { |h, k| h[k] = { bytes: 0, files: 0, loc: 0 } }
+        verbose = ENV['PG_VERBOSE'] == '1'
         Dir.chdir(repo_path) do
-          each_source_file(include_globs, exclude_globs) do |abs_path|
-            basename = File.basename(abs_path)
-            ext = File.extname(abs_path).downcase
+          each_source_file(include_globs, exclude_globs) do |path|
+            basename = File.basename(path)
+            ext = File.extname(path).downcase
             lang = FILENAME_TO_LANG[basename] || EXT_TO_LANG[ext]
             next unless lang
 
-            size = safe_file_size(abs_path)
-            lines = safe_count_lines(abs_path)
+            size = safe_file_size(path, verbose: verbose)
+            lines = metric == 'loc' ? safe_count_lines(path, verbose: verbose) : 0
             agg = by_lang[lang]
             agg[:bytes] += size
             agg[:files] += 1
@@ -113,26 +132,47 @@ module PrettyGit
       end
       # rubocop:enable Metrics/AbcSize
 
-      def self.each_source_file(include_globs, exclude_globs)
-        # Build list of files under repo respecting includes/excludes
-        all = Dir.glob('**/*', File::FNM_DOTMATCH).select { |p| File.file?(p) }
-        files = all.reject { |p| vendor_path?(p) || binary_ext?(p) }
+      # rubocop:disable Metrics/AbcSize, Metrics/CyclomaticComplexity, Metrics/PerceivedComplexity
+      def self.each_source_file(include_globs, exclude_globs, &block)
+        # Traverse tree with early prune for vendor/binary paths, then apply include/exclude
+        files = []
+        Find.find('.') do |path|
+          rel = path.sub(%r{^\./}, '')
+          # Prune vendor dirs early
+          if File.directory?(path)
+            dir = File.basename(path)
+            if VENDOR_DIRS.include?(dir)
+              Find.prune
+              next
+            end
+            next
+          end
+          next unless File.file?(path)
+          next if rel.empty?
+          next if vendor_path?(rel) || binary_ext?(rel)
+
+          files << rel
+        end
+
         files = filter_includes(files, include_globs)
         files = filter_excludes(files, exclude_globs)
-        files.each { |rel| yield File.expand_path(rel) }
+        files.each { |rel| block.call(rel) }
       end
+      # rubocop:enable Metrics/AbcSize, Metrics/CyclomaticComplexity, Metrics/PerceivedComplexity
 
-      def self.safe_file_size(path)
+      def self.safe_file_size(path, verbose: false)
         File.size(path)
-      rescue StandardError
+      rescue StandardError => e
+        warn("Warning: failed to read size of #{path}: #{e.message}") if verbose
         0
       end
 
-      def self.safe_count_lines(path)
+      def self.safe_count_lines(path, verbose: false)
         count = 0
         File.foreach(path) { |_l| count += 1 }
         count
-      rescue StandardError
+      rescue StandardError => e
+        warn("Warning: failed to count lines in #{path}: #{e.message}") if verbose
         0
       end
 
@@ -141,7 +181,8 @@ module PrettyGit
         return files if globs.empty?
 
         allowed = globs.flat_map { |g| Dir.glob(g) }
-        files.select { |f| allowed.include?(f) }
+        allowed_map = allowed.each_with_object({}) { |f, h| h[f] = true }
+        files.select { |f| allowed_map[f] }
       end
 
       def self.filter_excludes(files, globs)
@@ -149,7 +190,8 @@ module PrettyGit
         return files if globs.empty?
 
         blocked = globs.flat_map { |g| Dir.glob(g) }
-        files.reject { |f| blocked.include?(f) }
+        blocked_map = blocked.each_with_object({}) { |f, h| h[f] = true }
+        files.reject { |f| blocked_map[f] }
       end
 
       def self.vendor_path?(path)

data/lib/pretty_git/app.rb

@@ -1,5 +1,6 @@
 # frozen_string_literal: true
 
+require 'open3'
 require_relative 'git/provider'
 require_relative 'analytics/summary'
 require_relative 'analytics/activity'
@@ -37,7 +38,9 @@ module PrettyGit
     private
 
     def ensure_repo!(path)
-      return if File.directory?(File.join(path, '.git'))
+      # Use git to reliably detect work-trees/worktrees/bare repos
+      stdout, _stderr, status = Open3.capture3('git', 'rev-parse', '--is-inside-work-tree', chdir: path)
+      return if status.success? && stdout.to_s.strip == 'true'
 
       raise ArgumentError, "Not a git repository: #{path}"
     end
@@ -47,21 +50,25 @@ module PrettyGit
     end
 
     def renderer_for(filters, io)
-      case filters.format
-      when 'console'
-        use_color = !filters.no_color && filters.theme != 'mono'
-        Render::ConsoleRenderer.new(io: io, color: use_color, theme: filters.theme)
-      when 'csv'
-        Render::CsvRenderer.new(io: io)
-      when 'md'
-        Render::MarkdownRenderer.new(io: io)
-      when 'yaml'
-        Render::YamlRenderer.new(io: io)
-      when 'xml'
-        Render::XmlRenderer.new(io: io)
-      else
-        Render::JsonRenderer.new(io: io)
+      if filters.format == 'console'
+        return Render::ConsoleRenderer.new(
+          io: io,
+          color: !filters.no_color && filters.theme != 'mono',
+          theme: filters.theme
+        )
       end
+
+      dispatch = {
+        'csv' => Render::CsvRenderer,
+        'md' => Render::MarkdownRenderer,
+        'yaml' => Render::YamlRenderer,
+        'xml' => Render::XmlRenderer,
+        'json' => Render::JsonRenderer
+      }
+      klass = dispatch[filters.format]
+      raise ArgumentError, "Unknown format: #{filters.format}" unless klass
+
+      klass.new(io: io)
     end
 
     def analytics_for(report, enum, filters)