swiftree

Easily visualize the Swift vs Objective-C file distribution in a hybrid iOS codebase as an interactive treemap.

Examples

Usage

uv run swiftree.py <directory>

Example:

uv run swiftree.py /path/to/wikipedia-ios
# → Saves migration_progress.html and opens it in the default browser

Overview

swiftree recursively scans a directory, counts .swift and Objective-C (.h, .m) files per folder, and renders an interactive Plotly Treemap saved to migration_progress.html.

Color encoding:

• Blue — Swift-heavy (migration complete)
• White — equal mix
• Red — Objective-C-heavy (migration needed)

Each cell displays the directory name and lists the Objective-C files it contains directly, so files that need conversion are visible at a glance. Hovering over a cell shows the Swift/ObjC counts and percentages for that subtree.

Output

migration_progress.html — a self-contained interactive HTML file. The title shows the project name and overall Swift/Objective-C split (e.g. wikipedia-ios — Swift: 67%, Objective-C: 33%).

Requirements

• uv