Metadata-Version: 2.4
Name: terminal-weather-cli
Version: 0.1.0
Summary: Terminal weather forecast service with 3-day outlook and ASCII art
Requires-Python: >=3.12
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: rich>=14.1.0
Dynamic: license-file

# Terminal Weather Service

A small terminal weather forecast service that shows the next 3 days with ASCII weather art.

## Features

- 3-day forecast
- Real temperature range and apparent temperature range
- Wind speed and wind direction
- Visibility
- Precipitation amount and precipitation probability
- Metric and imperial unit support
- English and Chinese output
- HTTPS requests for geocoding and weather data

## Usage

```bash
python main.py
python main.py --location "Shanghai" --lang zh --unit metric
python main.py --location "New York" --lang en --unit imperial
python main.py --show-icons
```

## Development

Install dependencies with `uv`:

```bash
uv sync --group dev
```

Run lint checks:

```bash
uv run ruff check .
```

Format code:

```bash
uv run ruff format .
```

Apply safe auto-fixes:

```bash
uv run ruff check . --fix
```

## Arguments

- `--location`: city or place name; if omitted, the current location is used
- `--lang`: `en` or `zh`, default `zh`
- `--unit`: `metric` or `imperial`, default `metric`
- `--show-icons`: show all built-in weather icons and labels

## Notes

- Forecast and geocoding data are fetched from Open-Meteo over HTTPS.
- Current location is resolved over HTTPS using IP geolocation when `--location` is omitted.
- Uses `rich` for terminal table rendering.
