trueloc 0.3.0

Count lines of code from GitHub pull requests

trueloc - Lines of Code Counter

A CLI tool to analyze your coding activity via GitHub pull requests and direct commits:

• Total lines written since any date
• Per-PR and per-commit breakdown showing when each contribution was made
• File type analysis revealing which languages you've worked with most

Counts ALL lines touched across every commit in a PR—even for squash merges where GitHub only shows the final diff. For example, a PR where you add 1000 lines, delete them, then add 1 line shows +1001 / -1000 (not just +1).

Installation

Recommended (installs in isolated environment):

uv tool install trueloc

Or run directly without installing:

uvx trueloc count USERNAME --since 1m

Alternatively, with pip:

pip install trueloc

Requires the GitHub CLI (gh) to be installed and authenticated:

gh auth login

Usage

# Count lines from PRs and direct commits since a date
trueloc count USERNAME --since 2023-01-01

# Use relative dates
trueloc count USERNAME --since 5d      # 5 days ago
trueloc count USERNAME --since 2w      # 2 weeks ago
trueloc count USERNAME --since 3m      # 3 months ago
trueloc count USERNAME --since 1y      # 1 year ago
trueloc count USERNAME --since "last month"

# Specify a date range
trueloc count USERNAME --since 2024-01-01 --until 2024-06-30

# Count only net diff (not per-commit)
trueloc count USERNAME --since 2023-01-01 --net

# Exclude direct commits (PRs only)
trueloc count USERNAME --since 2023-01-01 --no-direct-commits

# Hide file extension breakdown
trueloc count USERNAME --since 2023-01-01 --no-extensions

# Disable caching (fresh API calls)
trueloc count USERNAME --since 2023-01-01 --no-cache

# Output as JSON for scripting/postprocessing
trueloc count USERNAME --since 2023-01-01 --json

# Clear the cache
trueloc clear-cache

CLI Reference

Main Commands

echo '```'
trueloc --help
echo '```'

                                                                                
 Usage: trueloc [OPTIONS] COMMAND [ARGS]...                                     
                                                                                
 Count lines of code from GitHub pull requests.

╭─ Options ────────────────────────────────────────────────────────────────────╮
│ --install-completion            Install completion for the current shell.    │
│ --show-completion               Show completion for the current shell, to    │
│                                 copy it or customize the installation.       │
│ --help                -h        Show this message and exit.                  │
╰──────────────────────────────────────────────────────────────────────────────╯
╭─ Commands ───────────────────────────────────────────────────────────────────╮
│ count         Count lines of code from merged PRs and direct commits.        │
│ clear-cache   Clear the disk cache.                                          │
│ count-local   Count lines of code from a local git repository.               │
╰──────────────────────────────────────────────────────────────────────────────╯

Count Command Options

echo '```'
trueloc count --help
echo '```'

                                                                                
 Usage: trueloc count [OPTIONS] USERNAME                                        
                                                                                
 Count lines of code from merged PRs and direct commits.

 By default, counts all lines touched across all commits in each PR,
 plus direct commits to the main branch (not from PRs).

 Example: a single PR where you add 1000 lines, delete them, then add
 1 line = +1001 / -1000 (even though the PR's net diff shows only +1).
 Additions and deletions are summed separately across all commits.

 Use --net to count only the final diff (net additions/deletions).
 Use --no-direct-commits to exclude direct commits to main branch.

╭─ Arguments ──────────────────────────────────────────────────────────────────╮
│ *    username      TEXT  GitHub username [required]                          │
╰──────────────────────────────────────────────────────────────────────────────╯
╭─ Options ────────────────────────────────────────────────────────────────────╮
│ *  --since           -s                         TEXT  Start date (e.g., 5d,  │
│                                                       2w, 3m, 1y, 'last      │
│                                                       month', 2024-01-01)    │
│                                                       [required]             │
│    --until           -u                         TEXT  End date (e.g., 1d,    │
│                                                       'yesterday',           │
│                                                       2024-12-31)            │
│    --no-cache                                         Disable disk cache     │
│    --extensions          --no-extensions              Show breakdown by file │
│                                                       extension              │
│                                                       [default: extensions]  │
│    --per-commit          --net                        Count all lines        │
│                                                       touched per commit     │
│                                                       (default) vs net diff  │
│                                                       only                   │
│                                                       [default: per-commit]  │
│    --direct-commits      --no-direct-commits          Include direct commits │
│                                                       to main branch (not    │
│                                                       from PRs)              │
│                                                       [default:              │
│                                                       direct-commits]        │
│    --json                                             Output results as JSON │
│                                                       for scripting          │
│    --repo            -r                         TEXT  Only process a single  │
│                                                       repository (e.g.,      │
│                                                       'owner/repo' or        │
│                                                       'repo')                │
│    --help            -h                               Show this message and  │
│                                                       exit.                  │
╰──────────────────────────────────────────────────────────────────────────────╯

Features

• Per-commit counting (default): Counts every line touched in every commit
• Net diff mode: Alternative mode that only counts final diff (--net)
• Direct commits: Includes commits pushed directly to main (not via PR)
• File extension breakdown: Shows which languages you've worked with
• JSON output: Machine-readable output for scripting (--json)
• Disk caching: Uses diskcache to avoid hammering the GitHub API
• Rate limit handling: Automatically waits when rate limited with progress bar
• Flexible dates: Supports relative (5d, 2w, 3m, 1y) and natural language (last month)

Caching Strategy

• Immutable data (cached forever): commit stats, PR commits, PR files
• Mutable data (1 day TTL): user repos, merged PR lists

Cache is stored in ~/.cache/trueloc/.

Tech Stack

• Python 3.12+
• Typer - CLI framework
• httpx - HTTP client
• Rich - Terminal output
• diskcache - Persistent caching
• dateparser - Flexible date parsing
• Hatch - Build system
• Ruff + mypy - Linting/typing

Development

# Install dev dependencies
uv sync --group dev

# Run tests
pytest

# Run linting
ruff check .
ruff format .
mypy .

License

MIT