Metadata-Version: 2.4
Name: gh-pr-digest
Version: 0.1.0
Summary: Developer-friendly digest of GitHub PRs that need your attention
Project-URL: Homepage, https://github.com/AshSgDe29071999/gh-pr-digest
Project-URL: Documentation, https://github.com/AshSgDe29071999/gh-pr-digest#readme
Project-URL: Repository, https://github.com/AshSgDe29071999/gh-pr-digest
Project-URL: Issues, https://github.com/AshSgDe29071999/gh-pr-digest/issues
Project-URL: Changelog, https://github.com/AshSgDe29071999/gh-pr-digest/releases
Author: AshSgDe29071999
License-Expression: MIT
License-File: LICENSE
Keywords: cli,developer-tools,digest,github,pull-request
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
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: Topic :: Software Development :: Version Control :: Git
Classifier: Typing :: Typed
Requires-Python: >=3.10
Requires-Dist: httpx>=0.27
Requires-Dist: rich>=13.0
Requires-Dist: typer>=0.12
Provides-Extra: dev
Requires-Dist: pytest>=7.0; extra == 'dev'
Description-Content-Type: text/markdown

# gh-pr-digest

[![PyPI version](https://img.shields.io/pypi/v/gh-pr-digest.svg)](https://pypi.org/project/gh-pr-digest/)
[![Python versions](https://img.shields.io/pypi/pyversions/gh-pr-digest.svg)](https://pypi.org/project/gh-pr-digest/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

Developer-friendly digest of GitHub PRs that need your attention.

## Install

```bash
pip install gh-pr-digest
```

## Auth (GITHUB_TOKEN)

Set a personal access token (classic or fine-grained with Issues/PR read):

```bash
export GITHUB_TOKEN=ghp_your_token_here
# or
export GH_TOKEN=ghp_your_token_here
```

If neither is set, the CLI falls back to `gh auth token` when the GitHub CLI is available.

## 60-second demo

```bash
pip install gh-pr-digest
export GITHUB_TOKEN=ghp_...   # or: gh auth login

# Human-readable digest for the authenticated user
gh-pr-digest

# Limit to one repo + machine output
gh-pr-digest --repo owner/name --json

# Also surface your open PRs with failing combined commit status
gh-pr-digest --with-ci
```

## What you get

1. **PRs awaiting your review** — Search: `is:pr is:open review-requested:<you>`
2. **Your open PRs** — Search: `is:pr is:open author:<you>`
3. **Failing checks** (optional `--with-ci`) — Combined commit status for your open PRs

## Exit codes

| Code | Meaning |
|------|---------|
| `0` | Success |
| `1` | Usage / HTTP / rate-limit errors |
| `2` | Authentication error |

## Development

```bash
python -m venv .venv
source .venv/bin/activate
pip install -e ".[dev]"
pytest
```

## License

MIT
