Release Notes
Added
- Thousands separator formatting for line counts: Line counts in terminal tables are now formatted with commas (e.g.
1,234 or 1,250,000), with dynamic column auto-scaling for repositories with millions of lines. Machine-readable JSON output preserves standard numeric types.
- GNU CLI flags (
-- long and - short options): Full support for standard GNU-style options across all flags:
- Long flags:
--help, --version, --json, --email, --ignore-blank, --committed-only, --ascii, --no-progress, --jobs, --ext.
- Short flags:
-h (help), -v (version), -j (jobs), -e (email), -w (ignore whitespace/blank lines), -c (committed only), -a (ASCII output), -n (no progress), -x (extension filter).
- Short option clustering (e.g.
-acn, -ew) and attached value forms (-j4, --jobs=4, -x.rs, --ext=.rs).
- Seamless backward compatibility for legacy single-dash long flags (
-json, -email, -ascii, -ext, etc.).
Performance
- Zero-allocation line counting and clean-file bypass: Bypassed
split_lines entirely for clean files in HEAD when not filtering blank lines, and replaced split_lines().len() with a zero-allocation count_lines byte scanner.
- Zero-copy CRLF normalization: Refactored
normalize_crlf to return Cow<'_, [u8]> with a fast-path scan, eliminating full-file heap allocations on Unix and CRLF-free repositories.
- Author interning and
Arc<str> caching: Cached commit authors as Arc<str> across worker threads and interned authors per file into Vec<Option<u32>>, reducing HEAD tracking slot memory from 24 bytes/line to 4 bytes/line (~83% memory reduction) and eliminating String clones and HashMap lookups from the hot per-line loop.
- Repository single-open threading: Reused the discovered
gix::Repository instance from tracked file collection in worker threads instead of opening the repository twice.
- Bounded event channels: Switched the blame event channel from unbounded to bounded (
workers * 4) to prevent unbounded memory growth on monorepos.
- Path allocation reductions: Refactored
path_to_git_string and display_path to build directly into pre-allocated strings without intermediate Vec<String> joins.
Changed
- Domain error types (
thiserror): Introduced structured domain error enums (GitError, BlameError, BlameFileError, RunError) in src/error.rs, preserving underlying error sources while guaranteeing exact user-facing error strings and exit codes.
- Typed blame event warnings:
BlameEvent::Warning now carries &BlameFileError directly to eliminate intermediate string formatting in worker event loops.
- Worker thread state bundling: Encapsulated HEAD commit and tree references into
HeadState to reduce parameter counts and improve thread-local clarity.
Fixed
- Filter zero-line authors: Excluded authors with 0 attributed lines from table and JSON outputs so deleted or fully filtered worktree authors do not render with
0.0% bars.
- Panic safety and worker resilience: Documented worker panic safety invariants and ensured per-file panics cleanly convert into structured
BlameFileError::WorkerPanic warnings without crashing worker threads.
Install blamr 0.0.7
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/ajmalbuv/blamr/releases/download/v0.0.7/blamr-installer.sh | sh
Install prebuilt binaries via powershell script
powershell -ExecutionPolicy Bypass -c "irm https://github.com/ajmalbuv/blamr/releases/download/v0.0.7/blamr-installer.ps1 | iex"
Download blamr 0.0.7