Better Git of Theseus is a modern refactor of the original git-of-theseus. It provides a fully interactive Web Dashboard powered by Streamlit and Plotly, making it easier than ever to visualize how your code evolves over time.

Key Enhancements

• 🚀 One-Click Visualization: New better-git-of-theseus command automatically scans your project and launches a Web UI.
• 📊 Interactive Charts: Replaced static Matplotlib plots with Plotly. Support for zooming, panning, and detailed data hovers.
• 🧠 In-Memory Processing: Data flows directly in memory. No more mandatory intermediate .json files cluttering your repo.
• ⚡ Smart Caching: Leverages Streamlit's caching to make repeat analysis of large repos nearly instantaneous.
• 🎨 Modern UI: Adjust parameters (Cohort format, ignore rules, normalization, etc.) in real-time via the sidebar.

Installation

Install via pip:

pip install better-git-of-theseus

Quick Start

Run the following in any Git repository:

better-git-of-theseus

It will automatically open your browser to the interactive dashboard.

Show the available command-line options or installed version:

better-git-of-theseus --help
better-git-of-theseus --version

Releasing

After the release PR is merged, create and push the next patch tag with one command:

make release-patch

The command requires a clean, up-to-date master branch. It pushes the next vX.Y.Z tag and triggers the PyPI release workflow. Use make release-minor or make release-major for those version increments.

Feature Highlights

Cohort Formatting

Customize how commits are grouped by year, month, or week (based on Python strftime):

• %Y: Group by Year (Default)
• %Y-%m: Group by Month
• %Y-W%W: Group by Week

Real-time Parameters

Adjust parameters like "Max Series", "Normalization", and "Exponential Fit" directly in the Web UI without re-running any commands.

FAQ

• Duplicate Authors? Configure a .mailmap file in your repo root to merge identities.
• Performance? First-time analysis of very large repos (like the Linux Kernel) may take time, but subsequent views are extremely fast due to caching.

Credits

Special thanks to Erik Bernhardsson for creating the original git-of-theseus.

License

MIT