linecounter lists Ruby files with lines of code, churn, branching, and avg loc per item.
Install the gem:
gem install linecounterOr add it to a Gemfile:
gem "linecounter"From a checkout you can run it without installing:
ruby -Ilib exe/linecounter --repo /path/to/repolinecounter [options]--top NShow top N rows (default: 20).--since STRLimit churn to commits since date. Supports git-parseable dates inYYYY-MM-DD(e.g.,2025-01-01), other git-parseable strings (e.g.,last friday), and relative forms:N.days.ago,N.weeks.ago,N.hours.ago,N.months.ago,N.years.ago, plustoday/yesterday.--min-loc NExclude files below N non-empty lines (default: 20).--repo PATHPath to a git repo to scan (default: current directory).--jsonOutput JSON instead of text.--show-branch-countShow per-branch keyword breakdown under each file.--show-structure-overviewShow a summary of class structure counts across all files, includingavg_loc_per_item(avg statement lines per item).--show-interaction-overviewAlias for--show-structure-overview.--detailed-structureShow overall structure averages (avg lines per item) for each regex item across all files.-h,--helpShow help.
--repo defaults to the current directory, so running linecounter with no
arguments scans the repo you're in. If the directory isn't a git repository it
exits with an error.
linecounter
linecounter --repo /path/to/repo
linecounter --repo /path/to/repo --top 50
linecounter --repo /path/to/repo --since 2025-01-01
linecounter --repo /path/to/repo --since 2.weeks.ago
linecounter --repo /path/to/repo --min-loc 50
linecounter --repo /path/to/repo --show-branch-count
linecounter --repo /path/to/repo --show-structure-overview
linecounter --repo /path/to/repo --detailed-structure
linecounter --repo /path/to/repo --json
linecounter --repo /path/to/repo --top 30 --since 3.months.ago --show-structure-overviewSignals are computed from the parsed AST (via Prism),
so keywords in strings or comments are never miscounted and avg_loc_per_item
reflects real definition length. Churn varies with git history, so your numbers
will differ:
$ linecounter --repo . --min-loc 80 --detailed-structure
Ruby Quality Signals
Files scanned: 4
Column descriptions:
Churn = total git commits touching the file (optionally since --since).
Branches = count of control-flow tokens (sum of per-keyword counts).
LOC = non-empty lines of code in the file.
File = repository-relative path.
Churn Branches LOC File
3 34 189 lib/linecounter/structure_analyzer.rb
3 0 161 test/unit/structure_analyzer_test.rb
2 13 99 lib/linecounter/report.rb
1 3 99 lib/linecounter/branch_analyzer.rb
Detailed structure (all scanned files):
constants
CONSTANT = count=11 avg_loc_per_item=8.27
public_attribute_macros
public attr_reader count=2 avg_loc_per_item=1.00
initializer
initialize count=2 avg_loc_per_item=7.00
public_methods
public def count=38 avg_loc_per_item=8.53
private_methods
private def count=8 avg_loc_per_item=9.75