Metadata-Version: 2.4
Name: rollinggo-flight
Version: 0.1.5
Summary: RollingGo flight search CLI package for uvx.
Requires-Python: >=3.10
Requires-Dist: httpx>=0.27.0
Requires-Dist: pydantic>=2.8.0
Requires-Dist: rich>=13.7.0
Requires-Dist: typer>=0.12.3
Provides-Extra: dev
Requires-Dist: pytest>=8.3.2; extra == 'dev'
Description-Content-Type: text/markdown

# RollingGo Flight CLI (Python / uvx)

RollingGo flight search CLI for uvx and pip.

## Install

```bash
# Run directly (recommended)
uvx rollinggo-flight --help

# Or install globally
pip install rollinggo-flight
uv tool install rollinggo-flight
```

## Usage

Set your API key via environment variable or `--api-key` flag:

```bash
export ROLLINGGO_API_KEY=your_key
```

## Commands

### search-airports

Search airports by keyword.

```bash
rollinggo-flight search-airports --api-key <key> --keyword "Hangzhou"
```

### search-flights

Search flights with structured filters.

```bash
rollinggo-flight search-flights --api-key <key> \
  --from-city HGH --to-city CTU \
  --from-date 2026-05-01 --trip-type ONE_WAY \
  --adult-number 1 --child-number 0 --cabin-grade ECONOMY
```
