codesize

A simple CLI tool that scans directories for code files and displays statistics. Supports Python, Go, Rust, Elixir, JavaScript, TypeScript, C, and Objective-C.

.h files are auto-detected as C or Objective-C based on their content.

Respects .gitignore files found in the tree by default (pass --no-gitignore to disable).

Features

• Recursively scans directories for supported code files
• Reports per-language breakdown:
  • Number of files
  • Total size (KB/MB)
  • Total lines
  • Code lines (excluding blank lines, docstrings, and decorative comments)
• Combined totals when multiple languages are present
• Only shows languages that have files — no clutter
• Beautiful ASCII box output with ANSI colours (when running in a terminal)
• Plain text and JSON output formats available

Installation

# Using uv
uv pip install codesize

# Using pip
pip install codesize

Usage

# Scan current directory
codesize

# Scan a specific directory
codesize /path/to/project

# Plain text output (no box)
codesize --plain

# JSON output
codesize --json

# Ignore .gitignore files (scan everything)
codesize --no-gitignore

# Sort languages by something other than code lines
codesize --sort files   # or: size, lines, code (default), name

Languages are listed biggest first by code-line count by default. Pass --sort name for alphabetical, or --sort files|size|lines for the other fields.

Example Output

╭──────────────────────────────────────────────╮
│          Code Stats: my-project              │
│──────────────────────────────────────────────│
│              Files     Size    Lines     Code │
│  Python        42  128.50 KB   3,847    2,691 │
│  Go            18   65.20 KB   1,523    1,210 │
│  Rust           7   22.00 KB     580      445 │
│──────────────────────────────────────────────│
│  Total         67  215.70 KB   5,950    4,346 │
╰──────────────────────────────────────────────╯

Development

# Set up development environment
make dev

# Run linting and type checks
make check

# Format code
make format

# Build wheel and docs
make build

Publishing

Publishing requires cal-publish-python configuration.

# Build first
make build

# Publish wheel to PyPI and docs to GitLab Pages
make publish

Licence

Unlicense — public domain. See LICENSE.