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-theseuscommand 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
.jsonfiles 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
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file better_git_of_theseus-0.8.0.tar.gz.
File metadata
- Download URL: better_git_of_theseus-0.8.0.tar.gz
- Upload date:
- Size: 421.4 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
66f750e0ccb3ef5d72b748f5d5fdee12212c4df1b75ac8499ef54b9c8b87aa9c
|
|
| MD5 |
8b382580b956e06b73c388d09dcccb52
|
|
| BLAKE2b-256 |
7dbcc1074843489be0f157e4e024ca1dac465b00f6c8887a4cea208caa448d40
|
Provenance
The following attestation bundles were made for better_git_of_theseus-0.8.0.tar.gz:
Publisher:
release.yml on onewesong/better-git-of-theseus
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
better_git_of_theseus-0.8.0.tar.gz -
Subject digest:
66f750e0ccb3ef5d72b748f5d5fdee12212c4df1b75ac8499ef54b9c8b87aa9c - Sigstore transparency entry: 2339637117
- Sigstore integration time:
-
Permalink:
onewesong/better-git-of-theseus@c00ad2e52550ee476eac46d7614c7743aebb9dfa -
Branch / Tag:
refs/tags/v0.8.0 - Owner: https://github.com/onewesong
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@c00ad2e52550ee476eac46d7614c7743aebb9dfa -
Trigger Event:
push
-
Statement type:
File details
Details for the file better_git_of_theseus-0.8.0-py3-none-any.whl.
File metadata
- Download URL: better_git_of_theseus-0.8.0-py3-none-any.whl
- Upload date:
- Size: 29.8 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
b58f1392eae85c08c66554a29cbe6a5dabd14ceb8c0ee1d260a8a852b081ef4b
|
|
| MD5 |
816c9e8f3de72e587d7e250564014016
|
|
| BLAKE2b-256 |
d981231e43279a60d4687e42d6b92c60c96e1426f1c37ebc503396860c289aff
|
Provenance
The following attestation bundles were made for better_git_of_theseus-0.8.0-py3-none-any.whl:
Publisher:
release.yml on onewesong/better-git-of-theseus
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
better_git_of_theseus-0.8.0-py3-none-any.whl -
Subject digest:
b58f1392eae85c08c66554a29cbe6a5dabd14ceb8c0ee1d260a8a852b081ef4b - Sigstore transparency entry: 2339637134
- Sigstore integration time:
-
Permalink:
onewesong/better-git-of-theseus@c00ad2e52550ee476eac46d7614c7743aebb9dfa -
Branch / Tag:
refs/tags/v0.8.0 - Owner: https://github.com/onewesong
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@c00ad2e52550ee476eac46d7614c7743aebb9dfa -
Trigger Event:
push
-
Statement type:
