Git Branch Statistics

A Streamlit application to visualize and analyze git commit history and statistics for a local repository.

Features

• Repository Selection: Point the app to any local git repository on your machine.
• Branch Analysis: Select a branch to analyze.
• Commit History: View detailed commit history including hash, date, message, insertions, and deletions.
• Visualizations:
  • Lines added per commit over time.
  • Cumulative growth of the codebase (lines added).
• Metrics:
  • Total commits analyzed.
  • Total lines added.
  • Current total Lines of Code (LOC) estimation.

Prerequisites

• Python 3.7+: Ensure Python is installed and added to your PATH.
• Git: The application requires git to be installed and available in your command line.

Installation and Running

The application comes with helper scripts to automatically set up a virtual environment, install dependencies, and launch the app.

Windows

Double-click run.bat or run it from the command line:

run.bat

Linux / macOS

Make the script executable (first time only) and run it:

chmod +x run.sh
./run.sh

Manual Setup

If you prefer to run it manually:

1. Create a virtual environment:

   python -m venv .venv

2. Activate the virtual environment:
   • Windows: .venv\Scripts\activate
   • Linux/macOS: source .venv/bin/activate
3. Install dependencies:

   pip install -r requirements.txt

4. Run the app:

   streamlit run app.py

Usage

1. Launch the application.
2. Enter the absolute path to the local git repository you want to analyze in the "Git Repository Path" text box.
3. If the path is valid, a success message will appear.
4. Select a branch from the dropdown menu.
5. Adjust the "Number of commits to analyze" slider if needed.
6. Explore the charts and data tables.

License

This project is licensed under the MIT License - see the LICENSE file for details.