Metadata-Version: 2.4
Name: pipdash
Version: 1.0.0
Summary: PyPI package download stats and metadata — right in your terminal.
Author: Abhishek Bevinkatti
License-Expression: MIT
Project-URL: Homepage, https://github.com/bevinkatti/pipdash
Project-URL: Repository, https://github.com/bevinkatti/pipdash
Project-URL: Bug Tracker, https://github.com/bevinkatti/pipdash/issues
Keywords: pypi,pip,stats,downloads,metrics,cli,terminal,packages,developer-tools
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
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: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Utilities
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: httpx>=0.24.0
Requires-Dist: rich>=13.0.0
Dynamic: license-file

<p align="center">
  <h1 align="center">📦 pipdash</h1>
  <p align="center">PyPI package download stats and metadata — right in your terminal.</p>
  <p align="center">
    <a href="https://pypi.org/project/pipdash"><img src="https://img.shields.io/pypi/v/pipdash?color=cyan&label=pipdash" alt="PyPI"></a>
    <a href="https://pypi.org/project/pipdash"><img src="https://img.shields.io/pypi/pyversions/pipdash" alt="Python versions"></a>
    <a href="https://github.com/bevinkatti/pipdash/blob/main/LICENSE"><img src="https://img.shields.io/github/license/bevinkatti/pipdash" alt="License"></a>
  </p>
</p>

---

No browser. No login. No config. One command.

```bash
pipdash stats requests
```
```
📦 requests  v2.34.2
   Python HTTP for Humans.
──────────────────────────────────────────────────
  Last 24 hours      9.80M
  Last 7 days        65.00M
  Last 30 days       271.00M
  Last 90 days       813.00M  (est.)
  Last 180 days      1.63B    (est.)
──────────────────────────────────────────────────
  ⬇  All-time Downloads   54.20k
──────────────────────────────────────────────────

  Python Versions
    3.12     ████████░░░░  41%
    3.11     ████████░░░░  28%
    3.10     ██████░░░░░░  18%
    3.9      ████░░░░░░░░   8%

  Platforms
    Linux    ████████░░░░  62%
    Windows  ██████░░░░░░  22%
    macOS    ████░░░░░░░░  14%

──────────────────────────────────────────────────
  License          Apache-2.0
  Requires Python  >=3.10
  Total Versions   163
  First Released   2011-02-14
  Latest Release   v2.34.2  (2026-05-14)
  Repository       https://github.com/<owner>/<repo>
```

---

## Install

```bash
pip install pipdash
```

## Commands

### `pipdash stats <package>`
Full download statistics + metadata.

```bash
pipdash stats numpy
pipdash stats django --json      # JSON output for scripting
```

### `pipdash info <package>`
Package metadata, dependencies, and links — no download API call needed.

```bash
pipdash info flask
pipdash info fastapi --json
```

### `pipdash compare <pkg1> <pkg2> ...`
Side-by-side stats comparison of multiple packages.

```bash
pipdash compare requests httpx aiohttp
pipdash compare django flask fastapi
```

### Flags
| Flag | Description |
|------|-------------|
| `--json` | Output raw JSON (works with all commands) |
| `--help` | Show help |
| `--version` | Show version |

---

## Data sources

| Source | Data |
|--------|------|
| [pypi.org](https://pypi.org) | Package metadata, versions, release dates |
| [pypistats.org](https://pypistats.org) | Download counts by period, Python version, OS |

No API key required. No sign-up. Completely free.

---

## Why pipdash?

- `pepy.tech` requires a browser
- PyPI's own API gives no useful download stats
- pypistats.org has an API but no nice CLI
- `pipdash` wraps both into one clean command

---

## Contributing

```bash
git clone https://github.com/bevinkatti/pipdash.git
cd pipdash
pip install -e ".[dev]"
```

Issues and PRs welcome.

## License

MIT © [Abhishek Bevinkatti](https://github.com/bevinkatti)
