https://github.com/mcking-07/blame-g

blame-g is a cli tool that analyzes git repositories and displays contributor stats—commits, lines changed, files, pull-requests, reverts, and more—in a terminal table.
https://github.com/mcking-07/blame-g

git-stats python-git

Last synced: 7 days ago
JSON representation

blame-g is a cli tool that analyzes git repositories and displays contributor stats—commits, lines changed, files, pull-requests, reverts, and more—in a terminal table.

• Host: GitHub
• URL: https://github.com/mcking-07/blame-g
• Owner: mcking-07
• License: mit
• Created: 2025-04-13T16:14:20.000Z (12 months ago)
• Default Branch: main
• Last Pushed: 2025-04-15T17:45:40.000Z (12 months ago)
• Last Synced: 2026-01-03T18:43:03.991Z (3 months ago)
• Topics: git-stats, python-git
• Language: Python
• Homepage: https://pypi.org/project/blame-g
• Size: 60.5 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# blame-g

[![PyPI Version](https://img.shields.io/pypi/v/blame-g)](https://pypi.org/project/blame-g/)

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

[![Python Versions](https://img.shields.io/pypi/pyversions/blame-g)](https://pypi.org/project/blame-g/)

`blame-g` is a command-line tool that analyzes git repositories and generates contributor statistics — including commits, lines added/deleted, files changed, pull requests, reverts, and more — beautifully rendered in a terminal table.

**Geddit?** Blame- *ji*? ;)

![in-action](https://raw.githubusercontent.com/mcking-07/blame-g/refs/heads/main/assets/blame-g.png)

## Features

- **Contributor Statistics:**  Aggregates commits, lines added/deleted, files changed, pull requests, and reverts for each contributor.

- **Rich Output:** Uses the `rich` library to provide a visually appealing and informative table of statistics in your terminal.

- **Branch Specific Analysis:**  Analyze a specific branch of your repository.

- **Pull Request & Revert Detection:** Detects PRs and reverts based on commit message patterns.

  > **Note:** The detection only works if you use the default PR message patterns for Bitbucket, GitHub, and GitLab. Custom commit message formats might not be recognized.

- **Git-Aware Context:** Automatically detects and works within the current Git repository.

## Installation

### Install from PyPI

```sh

pip3 install blame-g

```

### Clone and Run from Source

```sh

git clone https://github.com/mcking-07/blame-g.git

cd blame-g

pip3 install -r requirements.txt

python3 blame-g [repo_path] [branch_name]

```

### Editable Install

```sh

git clone https://github.com/mcking-07/blame-g.git

cd blame-g

pip3 install -e .

blame-g [repo_path] [branch_name]

```

## Usage

```sh

blame-g [repo_path](defaults to the current working directory) [branch_name](defaults to main or master)

```

## License

This project is licensed under the [MIT License](https://opensource.org/licenses/MIT).