Metadata-Version: 2.4
Name: ghweekly
Version: 0.1.2
Summary: Visualize weekly GitHub commit activity across repositories.
Home-page: https://github.com/bhimrazy/gh-weekly-commits
Author: Bhimraj Yadav
License: MIT
Project-URL: Bug Tracker, https://github.com/bhimrazy/gh-weekly-commits/issues
Project-URL: Documentation, https://github.com/bhimrazy/gh-weekly-commits#readme
Project-URL: Source Code, https://github.com/bhimrazy/gh-weekly-commits
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: requests
Requires-Dist: pandas
Requires-Dist: matplotlib
Dynamic: author
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: license
Dynamic: license-file
Dynamic: project-url
Dynamic: requires-dist
Dynamic: summary

# gh-weekly-commits

📊 Visualize your weekly GitHub contributions across multiple repositories.

## Features
- Fetch weekly commit data for a GitHub user across multiple repositories.
- Visualize the data as a stacked bar chart.
- CLI support for easy usage.

## Installation

You can install the package directly from the GitHub repository:

```bash
pip install ghweekly
```

```bash
pip install -r requirements.txt
```

## Usage

### CLI

```bash
ghweekly --username <your-username> \
         --repos org/repo1 org/repo2 \
         --start 2025-01-01 \
         --plot
```

### Script

Edit `scripts/plot_commits.py` to set your GitHub username and repository list, then run:

```bash
python scripts/plot_commits.py
```

## Weekly Commits Visualization

The latest weekly commits visualization is updated daily and can be found below:

![Weekly Commits](./weekly_commits.png)

## Development

### Run Tests

```bash
pytest tests/
```

## License

MIT
