Git Contribution Heatmap

This script generates a heatmap visualizing your commit contributions over time in one or more Git repositories. It filters commit dates based on the author's email and displays the number of commits per week and weekday.

Features

• Extracts commit dates from one or more Git repositories using the author's email.
• Parses and organizes the commit data into a structured format.
• Generates a heatmap visualizing the commit contributions by week and weekday.

Requirements

• Python 3.x
• matplotlib
• seaborn
• pandas

Installation

To get started, clone the repository and install the required packages:

git clone https://github.com/mihai10001/contributions_graph
cd contributions_graph
pip install matplotlib seaborn pandas

Usage

Run the script from the command line with the following syntax:

python generate_graph.py <path_to_your_repository1> <path_to_your_repository2> ... <your_email@example.com> [--transparent]

Example

python generate_graph.py /path/to/your/repo your_email@example.com

# Multiple repositories and transparent
python generate_graph.py /path/to/first/repo /path/to/second/repo your_email@example.com --transparent

This will generate a heatmap image named contribution_heatmap.png in the current directory.

Output

The generated heatmap will show:

• X-axis: Weeks of the year with month labels
• Y-axis: Days of the week (Monday, Wednesday, Friday, Sunday)
• Color intensity: Represents the number of commits made on each day

Contributing

Contributions are welcome! Please open an issue or submit a pull request.

License

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