better-git-of-theseus 0.4.0__py3-none-any.whl → 0.4.2__py3-none-any.whl

better_git_of_theseus-0.4.2.dist-info/METADATA

@@ -0,0 +1,96 @@
+Metadata-Version: 2.4
+Name: better-git-of-theseus
+Version: 0.4.2
+Summary: Plot stats on Git repositories with interactive Plotly charts
+Home-page: https://github.com/onewesong/better-git-of-theseus
+Author: Erik Bernhardsson
+Author-email: mail@erikbern.com
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: gitpython
+Requires-Dist: numpy
+Requires-Dist: tqdm
+Requires-Dist: wcmatch
+Requires-Dist: pygments
+Requires-Dist: plotly
+Requires-Dist: streamlit
+Requires-Dist: python-dateutil
+Requires-Dist: scipy
+Dynamic: author
+Dynamic: author-email
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: requires-dist
+Dynamic: summary
+
+<div align="center">
+
+# Better Git of Theseus
+
+[![pypi badge](https://img.shields.io/pypi/v/better-git-of-theseus.svg?style=flat)](https://pypi.python.org/pypi/better-git-of-theseus)
+[![PyPI - Downloads](https://img.shields.io/pypi/dm/better-git-of-theseus)](https://pypi.org/project/better-git-of-theseus/)
+[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/better-git-of-theseus)](https://pypi.org/project/better-git-of-theseus/)
+[![GitHub License](https://img.shields.io/github/license/onewesong/better-git-of-theseus)](https://github.com/onewesong/better-git-of-theseus/blob/master/LICENSE)
+[![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/onewesong/better-git-of-theseus)
+
+[中文版](README_zh.md)
+
+</div>
+
+**Better Git of Theseus** is a modern refactor of the original [git-of-theseus](https://github.com/erikbern/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.
+
+![Git of Theseus Dashboard](https://raw.githubusercontent.com/erikbern/git-of-theseus/master/pics/git-git.png) *(Note: Charts are now fully interactive!)*
+
+## 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:
+
+```bash
+pip install better-git-of-theseus
+```
+
+## Quick Start
+
+Run the following in any Git repository:
+
+```bash
+better-git-of-theseus
+```
+
+It will automatically open your browser to the interactive dashboard.
+
+## 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](https://git-scm.com/docs/gitmailmap) 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](https://github.com/erikbern) for creating the original `git-of-theseus`.
+
+## License
+
+MIT

{better_git_of_theseus-0.4.0.dist-info → better_git_of_theseus-0.4.2.dist-info}/RECORD

@@ -1,15 +1,15 @@
-better_git_of_theseus-0.4.0.dist-info/licenses/LICENSE,sha256=yNNDAWUe1WLKnuUcRp9X95C-yP2lfGl69m97Ftw-DUw,11345
+better_git_of_theseus-0.4.2.dist-info/licenses/LICENSE,sha256=yNNDAWUe1WLKnuUcRp9X95C-yP2lfGl69m97Ftw-DUw,11345
 git_of_theseus/__init__.py,sha256=LeG5tCOgvZMmKOjmO_HRg54sWF2K3-lTBf8H_vHMFio,273
 git_of_theseus/analyze.py,sha256=78E1G2FdSS9VZd0jKSnO5gpXwzNCjtzkSAxSzadYM3A,21547
-git_of_theseus/app.py,sha256=qbEV6RHIVkAjzlZijjOpxlLalyv0_Ub5Dh8KIZMtshM,5219
+git_of_theseus/app.py,sha256=8aS72pMg4CyEqdYhcsz1QZSxYw8wh_iQLvb-2LOK25A,5192
 git_of_theseus/cmd.py,sha256=4W8C0tb-9Uejq4WRjGyYKXmZgE4HQBk7KFIKrozY4Og,639
 git_of_theseus/line_plot.py,sha256=LegoVy0VEFT4sM5fYCES-I_2H9UaerCopDI3J2dyHeU,3117
 git_of_theseus/plotly_plots.py,sha256=c_9rJo3qlOy-TdHPsvuDH-6hVVO0_xYq-DmOnmgqOCE,7414
 git_of_theseus/stack_plot.py,sha256=q4-YlW3PyiwbIBFeHBA3dsdR1I_XKUQD74hAuSfhIR4,3150
 git_of_theseus/survival_plot.py,sha256=NEITAa0pMD9uJVsPd7JA71ucavnG1RxgC-F6Jk-K5bE,4868
 git_of_theseus/utils.py,sha256=Xw2udch9ixSgFInGhIC4_RJ_9IB3E8MmV1dmznavCWc,1026
-better_git_of_theseus-0.4.0.dist-info/METADATA,sha256=3-L_lKf0AqSnwizwWoUGj3reL13vbzP-v4SwUIpDFnU,5391
-better_git_of_theseus-0.4.0.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
-better_git_of_theseus-0.4.0.dist-info/entry_points.txt,sha256=F6qG6hzkuqjyrRu2zwzRpjbq77YCAUQu9mjmEzkabqA,323
-better_git_of_theseus-0.4.0.dist-info/top_level.txt,sha256=2kpp8WgiBzqVLxua_mBS00Nj4cUORaRbJi121THJ_0o,15
-better_git_of_theseus-0.4.0.dist-info/RECORD,,
+better_git_of_theseus-0.4.2.dist-info/METADATA,sha256=ZqXuZz94OODNr50giDYHD5Iihw5D_38undkBRXIeHDI,3633
+better_git_of_theseus-0.4.2.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+better_git_of_theseus-0.4.2.dist-info/entry_points.txt,sha256=dEBL6oCDAozY13Y_qxS_6-qkyCA7R2TpjoLH6QJR72g,66
+better_git_of_theseus-0.4.2.dist-info/top_level.txt,sha256=2kpp8WgiBzqVLxua_mBS00Nj4cUORaRbJi121THJ_0o,15
+better_git_of_theseus-0.4.2.dist-info/RECORD,,

better_git_of_theseus-0.4.2.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+better-git-of-theseus = git_of_theseus.cmd:main

git_of_theseus/app.py

@@ -93,7 +93,7 @@ if st.session_state.analysis_results:
             data = results.get(data_key)
             if data:
                 fig = plotly_stack_plot(data, normalize=normalize, max_n=max_n, title=project_name)
-                st.plotly_chart(fig, use_container_width=True)
+                st.plotly_chart(fig, width="stretch")
             else:
                 st.warning(f"Data for {data_source_label} not found.")
 
@@ -110,7 +110,7 @@ if st.session_state.analysis_results:
             data_line = results.get(data_key_line)
             if data_line:
                 fig = plotly_line_plot(data_line, normalize=normalize_line, max_n=max_n_line, title=project_name)
-                st.plotly_chart(fig, use_container_width=True)
+                st.plotly_chart(fig, width="stretch")
             else:
                 st.warning(f"Data for {data_source_label_line} not found.")
 
@@ -125,7 +125,7 @@ if st.session_state.analysis_results:
             survival_data = results.get("survival")
             if survival_data:
                 fig = plotly_survival_plot(survival_data, exp_fit=exp_fit, years=years, title=project_name)
-                st.plotly_chart(fig, use_container_width=True)
+                st.plotly_chart(fig, width="stretch")
             else:
                 st.warning("Survival data not found.")
 

better_git_of_theseus-0.4.0.dist-info/METADATA

@@ -1,122 +0,0 @@
-Metadata-Version: 2.4
-Name: better-git-of-theseus
-Version: 0.4.0
-Summary: Plot stats on Git repositories with interactive Plotly charts
-Home-page: https://github.com/onewesong/better-git-of-theseus
-Author: Erik Bernhardsson
-Author-email: mail@erikbern.com
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: gitpython
-Requires-Dist: numpy
-Requires-Dist: tqdm
-Requires-Dist: wcmatch
-Requires-Dist: pygments
-Requires-Dist: plotly
-Requires-Dist: streamlit
-Requires-Dist: python-dateutil
-Requires-Dist: scipy
-Dynamic: author
-Dynamic: author-email
-Dynamic: description
-Dynamic: description-content-type
-Dynamic: home-page
-Dynamic: license-file
-Dynamic: requires-dist
-Dynamic: summary
-
-[![pypi badge](https://img.shields.io/pypi/v/git-of-theseus.svg?style=flat)](https://pypi.python.org/pypi/git-of-theseus)
-
-Some scripts to analyze Git repos. Produces cool looking graphs like this (running it on [git](https://github.com/git/git) itself):
-
-![git](https://raw.githubusercontent.com/erikbern/git-of-theseus/master/pics/git-git.png)
-
-Installing
-----------
-
-Run `pip install git-of-theseus`
-
-Running
--------
-
-First, you need to run `git-of-theseus-analyze <path to repo>` (see `git-of-theseus-analyze --help` for a bunch of config). This will analyze a repository and might take quite some time.
-
-After that, you can generate plots! Some examples:
-
-1. Run `git-of-theseus-stack-plot cohorts.json` will create a stack plot showing the total amount of code broken down into cohorts (what year the code was added)
-1. Run `git-of-theseus-line-plot authors.json --normalize` will show a plot of the % of code contributed by the top 20 authors
-1. Run `git-of-theseus-survival-plot survival.json`
-
-You can run `--help` to see various options.
-
-If you want to plot multiple repositories, have to run `git-of-theseus-analyze` separately for each project and store the data in separate directories using the `--outdir` flag. Then you can run `git-of-theseus-survival-plot <foo/survival.json> <bar/survival.json>` (optionally with the `--exp-fit` flag to fit an exponential decay)
-
-Help
-----
-
-`AttributeError: Unknown property labels` – upgrade matplotlib if you are seeing this. `pip install matplotlib --upgrade`
-  
-Some pics
----------
-
-Survival of a line of code in a set of interesting repos:
-
-![git](https://raw.githubusercontent.com/erikbern/git-of-theseus/master/pics/git-projects-survival.png)
-
-This curve is produced by the `git-of-theseus-survival-plot` script and shows the *percentage of lines in a commit that are still present after x years*. It aggregates it over all commits, no matter what point in time they were made. So for *x=0* it includes all commits, whereas for *x>0* not all commits are counted (because we would have to look into the future for some of them). The survival curves are estimated using [Kaplan-Meier](https://en.wikipedia.org/wiki/Kaplan%E2%80%93Meier_estimator).
-
-You can also add an exponential fit:
-
-![git](https://raw.githubusercontent.com/erikbern/git-of-theseus/master/pics/git-projects-survival-exp-fit.png)
-
-Linux – stack plot:
-
-![git](https://raw.githubusercontent.com/erikbern/git-of-theseus/master/pics/git-linux.png)
-
-This curve is produced by the `git-of-theseus-stack-plot` script and shows the total number of lines in a repo broken down into cohorts by the year the code was added.
-
-Node – stack plot:
-
-![git](https://raw.githubusercontent.com/erikbern/git-of-theseus/master/pics/git-node.png)
-
-Rails – stack plot:
-
-![git](https://raw.githubusercontent.com/erikbern/git-of-theseus/master/pics/git-rails.png)
-
-Tensorflow – stack plot:
-
-![git](https://raw.githubusercontent.com/erikbern/git-of-theseus/master/pics/git-tensorflow.png)
-
-Rust – stack plot:
-
-![git](https://raw.githubusercontent.com/erikbern/git-of-theseus/master/pics/git-rust.png)
-
-Plotting other stuff
---------------------
-
-`git-of-theseus-analyze` will write `exts.json`, `cohorts.json` and `authors.json`. You can run `git-of-theseus-stack-plot authors.json` to plot author statistics as well, or `git-of-theseus-stack-plot exts.json` to plot file extension statistics. For author statistics, you might want to create a [.mailmap](https://git-scm.com/docs/gitmailmap) file in the root directory of the repository to deduplicate authors. If you need to create a .mailmap file the following command can list the distinct author-email combinations in a repository:
-
-Mac / Linux
-
-```shell
-git log --pretty=format:"%an %ae" | sort | uniq
-```
-
-Windows Powershell
-
-```powershell
-git log --pretty=format:"%an %ae" | Sort-Object | Select-Object -Unique
-```
-
-For instance, here's the author statistics for [Kubernetes](https://github.com/kubernetes/kubernetes):
-
-![git](https://raw.githubusercontent.com/erikbern/git-of-theseus/master/pics/git-kubernetes-authors.png)
-
-You can also normalize it to 100%. Here's author statistics for Git:
-
-![git](https://raw.githubusercontent.com/erikbern/git-of-theseus/master/pics/git-git-authors-normalized.png)
-
-Other stuff
------------
-
-[Markovtsev Vadim](https://twitter.com/tmarkhor) implemented a very similar analysis that claims to be 20%-6x faster than Git of Theseus. It's named [Hercules](https://github.com/src-d/hercules) and there's a great [blog post](https://web.archive.org/web/20180918135417/https://blog.sourced.tech/post/hercules.v4/) about all the complexity going into the analysis of Git history.

better_git_of_theseus-0.4.0.dist-info/entry_points.txt

@@ -1,6 +0,0 @@
-[console_scripts]
-git-of-theseus-analyze = git_of_theseus.analyze:analyze_cmdline
-git-of-theseus-line-plot = git_of_theseus:line_plot_cmdline
-git-of-theseus-stack-plot = git_of_theseus:stack_plot_cmdline
-git-of-theseus-survival-plot = git_of_theseus:survival_plot_cmdline
-git-of-theseus-visualize = git_of_theseus.cmd:main