Metadata-Version: 2.4
Name: cc-api-call
Version: 0.1.3
Summary: CLI tool for REST API testing with JWT, API key, and basic auth support
Project-URL: Homepage, https://github.com/CGYLab/api-call
Project-URL: Repository, https://github.com/CGYLab/api-call
Project-URL: Issues, https://github.com/CGYLab/api-call/issues
Author: CGYLab
License: BSD-3-Clause
License-File: LICENSE
Keywords: api,authentication,cli,jwt,rest,testing
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD 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 :: Internet :: WWW/HTTP
Classifier: Topic :: Software Development :: Testing
Requires-Python: >=3.10
Requires-Dist: httpx>=0.27.0
Requires-Dist: python-dotenv>=1.0.0
Requires-Dist: rich>=13.7.0
Requires-Dist: typer>=0.12.0
Description-Content-Type: text/markdown

# cc-api-call

CLI tool for REST API testing with JWT, API key, and basic auth support.

## Features

- Multiple authentication modes (JWT, API key, basic auth, none)
- Auto token refresh for JWT authentication
- Per-project configuration (`.claude/api-testing/.env`)
- Clean JSON output with `-r` flag
- Works seamlessly with AI coding assistants

## Installation

```bash
# Using uvx (recommended, no install needed)
uvx cc-api-call status

# Using pip
pip install cc-api-call

# Using uv
uv tool install cc-api-call
```

## Quick Start

1. Run any command to auto-create config:

```bash
uvx cc-api-call status
```

2. Edit `.claude/api-testing/.env` with your settings:

```env
PORT=3000
AUTH_MODE=jwt

# For JWT mode
API_TEST_EMAIL=user@example.com
API_TEST_PASSWORD=yourpassword
```

3. Login (JWT mode):

```bash
uvx cc-api-call login
```

4. Make requests:

```bash
uvx cc-api-call get /users -r
uvx cc-api-call post /users -d '{"name":"John","email":"john@example.com"}' -r
uvx cc-api-call put /users/1 -d '{"name":"Jane"}' -r
uvx cc-api-call delete /users/1 -y
```

## Commands

```bash
uvx cc-api-call --help
```

| Command | Description |
|---------|-------------|
| `get` | Make GET requests |
| `post` | Make POST requests |
| `put` | Make PUT requests |
| `delete` | Make DELETE requests |
| `login` | Login and save JWT tokens |
| `refresh` | Manually refresh JWT token |
| `status` | Show config and token status |

## Options

All request commands support:

| Option | Description |
|--------|-------------|
| `-r, --raw` | Output raw JSON (for piping/parsing) |
| `-H, --headers` | Show response headers |
| `-v, --verbose` | Verbose output |
| `--no-auth` | Skip authentication |

POST/PUT specific:

| Option | Description |
|--------|-------------|
| `-d, --data` | JSON data string |
| `-f, --file` | JSON file path |

DELETE specific:

| Option | Description |
|--------|-------------|
| `-y, --yes` | Skip confirmation prompt |

GET specific:

| Option | Description |
|--------|-------------|
| `-q, --query` | Query params (e.g., "page=1&limit=10") |

## Authentication Modes

### JWT Mode (default)

```env
AUTH_MODE=jwt
API_TEST_EMAIL=user@example.com
API_TEST_PASSWORD=yourpassword
AUTH_LOGIN_ENDPOINT=/auth/login
AUTH_REFRESH_ENDPOINT=/auth/refresh
```

### API Key Mode

```env
AUTH_MODE=api-key
API_KEY=your-api-key-here
API_KEY_HEADER=X-API-Key
```

### Basic Auth Mode

```env
AUTH_MODE=basic
BASIC_AUTH_USERNAME=admin
BASIC_AUTH_PASSWORD=password
```

### No Auth

```env
AUTH_MODE=none
```

## Configuration

Config is stored in `.claude/api-testing/` in your current working directory:

```
.claude/api-testing/
├── .env          # Your configuration
├── .gitignore    # Prevents committing secrets
└── tokens.jsonl  # JWT tokens (auto-generated)
```

## License

BSD-3-Clause
