Metadata-Version: 2.4
Name: github-trend-cli
Version: 0.1.0
Summary: Fetch trending GitHub repositories from the terminal — no API key needed
Author: Martin Uhlmann
License: MIT
Project-URL: Homepage, https://github.com/martinu/gh-trend
Project-URL: Repository, https://github.com/martinu/gh-trend
Keywords: github,trending,cli,developer-tools,terminal
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Software Development
Requires-Python: >=3.8
Description-Content-Type: text/markdown

# gh-trend

**Fetch trending GitHub repositories from the terminal — no API key needed.**

Scrapes the GitHub trending page and returns clean, formatted output.

```bash
pip install gh-trend

# Trending today
gh-trend

# Filter by language
gh-trend --lang python
gh-trend --lang typescript --weekly

# JSON output for scripting
gh-trend --lang rust --json | jq '.[] | .repo'

# This week, top 20
gh-trend --weekly --limit 20
```

## Features

- **No API key** — scrapes the public trending page
- **Language filter** — Python, Rust, Go, TypeScript, whatever
- **Time range** — today, weekly, or monthly
- **JSON output** — pipe into `jq` for scripting
- **Zero dependencies** — pure Python stdlib (urllib + re + json)

## Usage

```
usage: gh-trend [-h] [--lang LANG] [--weekly] [--monthly] [--json] [--limit LIMIT]

Fetch trending GitHub repositories from the terminal.

options:
  -h, --help            show this help message and exit
  --lang LANG, -l LANG  Filter by language (e.g., python, typescript, rust, go)
  --weekly, -w          Show trending this week (default: today)
  --monthly, -m         Show trending this month
  --json, -j            Output as JSON
  --limit LIMIT         Max repos to show (default: 25)
```

## License

MIT
