pypi-package-info

# PyPI Package Information

Retrieve comprehensive metadata for Python packages from the Python Package Index (PyPI).

## Usage

```bash
npx tsx scripts/info.ts <package-name> [options]
```

### Arguments

| Argument | Required | Description |
|----------|----------|-------------|
| `package-name` | Yes | The exact package name (case-insensitive) |

### Options

| Option | Description |
|--------|-------------|
| `--no-cache` | Bypass cache and fetch fresh data from PyPI |
| `--releases` | Show detailed release history and file information |
| `--files` | Show distribution files for the latest release |

### Output

```
django
==================================================
Latest Version: 5.0.1
License: BSD
Author: Django Software Foundation

Summary:
A high-level Python web framework that encourages rapid development and clean,
pragmatic design.

Project URLs:
  Documentation: https://docs.djangoproject.com/
  Repository: https://github.com/django/django
  Bug Tracker: https://code.djangoproject.com/

Python Requirement: >=3.10

Dependencies (latest):
  - asgiref >=3.6.0,<4
  - sqlparse >=0.2.2
```

Run from the pypi-json plugin directory: `~/.claude/plugins/cache/pypi-json/`

## API Query

### Request Format

```
GET https://pypi.org/pypi/{package}/json
```

### Parameters

| Parameter | Required | Description |
|-----------|----------|-------------|
| `package` | Yes | The exact package name (case-insensitive on PyPI) |
| `format` | No | Always use `json` for structured data |

### Response Codes

| Status | Meaning |
|--------|---------|
| `200 OK` | Package found and metadata returned |
| `404 Not Found` | Package does not exist on PyPI |

## Package Metadata

The API returns comprehensive package information structured in these main sections:

### Core Package Information
- **`info`** - Package metadata object
  - `name` - Package name
  - `version` - Latest version number
  - `summary` - Short description
  - `description` - Full description
  - `license`