Metadata-Version: 2.4
Name: git-count
Version: 0.2.0
Summary: A Git commit activity visualization tool with detailed repository insights
Home-page: https://github.com/techUdayMungalpara/git_count
Author: Uday Mungalpara
Author-email: your.email@example.com
Project-URL: Bug Reports, https://github.com/techUdayMungalpara/git_count/issues
Project-URL: Source, https://github.com/techUdayMungalpara/git_count
Project-URL: Documentation, https://github.com/techUdayMungalpara/git_count#readme
Keywords: git commits visualization analytics statistics
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Topic :: Utilities
Classifier: Topic :: Software Development :: Version Control :: Git
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Operating System :: OS Independent
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: keywords
Dynamic: license-file
Dynamic: project-url
Dynamic: requires-python
Dynamic: summary

# git_count

A powerful Git commit activity visualization tool with detailed repository insights and beautiful ASCII charts.

[![PyPI Downloads](https://static.pepy.tech/badge/git-count)](https://pepy.tech/projects/git-count)
![Python Version](https://img.shields.io/pypi/pyversions/git-count)

## Installation

```bash
pip install git-count
```

## Features

- Visualize git commit activity with ASCII bars
- Group commits by day, month, or year
- Filter commits by author
- Date range filtering
- Directory-specific analysis
- Detailed repository insights
- Multiple output formats (text, JSON, CSV)

## Usage

```bash
# Basic usage
git-count

# Show commits by month
git-count -p month

# Filter by author
git-count -a "uday"

# Show commits since a specific date
git-count -s "2023-01-01"

# Show detailed repository insights
git-count -i

# Output as JSON
git-count -o json
```

## Options

- `-p, --period`: Group commits by period (day/month/year)
- `-a, --author`: Filter commits by author
- `-s, --since`: Show commits more recent than a specific date
- `-u, --until`: Show commits older than a specific date
- `-d, --directory`: Analyze commits in a specific directory
- `-m, --max-commits`: Limit the number of commits to display
- `-o, --output`: Output format (text/json/csv)
- `-i, --insights`: Show detailed repository insights
- `-h, --help`: Show help message

## Advanced Examples

```bash
# Combine multiple filters
git-count -a "uday" -s "2024-01-01" -p month -i

# Export data for further analysis
git-count -o json > commits.json
git-count -o csv > commits.csv

# Analyze specific directory changes
git-count -d src/ -p month

# Get insights for team productivity
git-count -i -s "2025-01-01"
```

## Customization

You can customize colors by creating a `~/.gitbarsrc` configuration file:

```ini
[colors]
reset = \033[0m
title = \033[1;36m
date = \033[0;32m
number = \033[0;33m
bar = \033[0;34m
alert = \033[0;31m
```

## What You'll See

The insights mode (`-i`) shows:

- Project timeline and age
- Average commits per day
- Most active hours and days
- Commit types distribution (features, fixes, docs, etc.)
- Top contributors
- Activity patterns with visual charts

## Requirements

- Python 3.8+
- Git must be installed and repository must be a valid Git repository

## License

MIT License
