Metadata-Version: 2.4
Name: minitest-cli
Version: 0.2.0
Summary: Minitest CLI – command-line interface for the Minitest testing platform
Keywords: testing,cli,minitest,minitap,automation,qa
Author: Minitap Team
Author-email: Minitap Team <support@minitap.ai>
License-Expression: MIT
Classifier: Development Status :: 3 - Alpha
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.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Testing
Classifier: Typing :: Typed
Requires-Dist: typer>=0.24.1
Requires-Dist: httpx>=0.28.1
Requires-Dist: pydantic>=2.12.5
Requires-Dist: pydantic-settings>=2.13.1
Requires-Dist: rich>=14.3.3
Requires-Dist: ruff>=0.15.6 ; extra == 'dev'
Requires-Dist: pyright>=1.1.408 ; extra == 'dev'
Requires-Dist: pytest>=9.0.2 ; extra == 'dev'
Requires-Python: >=3.12
Project-URL: Homepage, https://minitap.ai/
Project-URL: Source, https://github.com/minitap-ai/minitest-cli
Project-URL: Bug Tracker, https://github.com/minitap-ai/minitest-cli/issues
Project-URL: Changelog, https://github.com/minitap-ai/minitest-cli/releases
Provides-Extra: dev
Description-Content-Type: text/markdown

# minitest-cli

Command-line interface for the Minitest testing platform.

## Installation

### pip (recommended)

```bash
pip install minitest-cli
```

### uvx (zero-install)

Run without installing:

```bash
uvx --from minitest-cli minitest --help
```

### Homebrew

```bash
brew install minitap-ai/tap/minitest-cli
```

### From source

```bash
git clone https://github.com/minitap-ai/minitest-cli.git
cd minitest-cli
uv sync
uv run minitest --help
```

## Quick Start

```bash
# Authenticate
minitest auth login

# List your apps
minitest apps list

# Run tests
minitest run --app <app-id>
```

## Configuration

| Environment Variable | Description | Required |
|---------------------|-------------|----------|
| `MINITEST_TOKEN` | API authentication token | Yes (or use `minitest auth login`) |
| `MINITEST_APP_ID` | Default app ID | No (can use `--app` flag) |
| `MINITEST_API_URL` | API base URL | No (defaults to production) |

## Global Flags

| Flag | Description |
|------|-------------|
| `--json` | Output JSON to stdout (diagnostics go to stderr) |
| `--app <id-or-name>` | Target app for commands that require one |
| `--version` | Show CLI version |
| `--help` | Show help |

## Commands

| Command | Description |
|---------|-------------|
| `minitest auth` | Authentication management |
| `minitest apps` | App management |
| `minitest flow` | Testing flow operations |
| `minitest build` | Build management |
| `minitest run` | Test execution |

## Exit Codes

| Code | Meaning |
|------|---------|
| 0 | Success |
| 1 | General error |
| 2 | Authentication error |
| 3 | Network / API error |
| 4 | Resource not found |

## Development

```bash
# Install dependencies
uv sync --dev

# Run linter
uv run ruff check .

# Run formatter
uv run ruff format .

# Run type checker
uv run pyright

# Run tests
uv run pytest
```
