Metadata-Version: 2.4
Name: open-meteo-client
Version: 0.0.1
Summary: Lightweight async Python client for the Open-Meteo weather API
Project-URL: Homepage, https://github.com/jakobheine/open-meteo-client
Project-URL: Repository, https://github.com/jakobheine/open-meteo-client
Project-URL: Issues, https://github.com/jakobheine/open-meteo-client/issues
Project-URL: Author website, https://jakobheine.de/
Author-email: Jakob Heine <me@jakobheine.de>
License-Expression: Apache-2.0
License-File: LICENSE
License-File: NOTICE
Keywords: api,async,client,forecast,meteo,open-meteo,weather
Classifier: Development Status :: 1 - Planning
Classifier: Framework :: AsyncIO
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Scientific/Engineering :: Atmospheric Science
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Typing :: Typed
Requires-Python: >=3.11
Provides-Extra: dev
Requires-Dist: mypy>=1.11; extra == 'dev'
Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
Requires-Dist: pytest-cov>=5; extra == 'dev'
Requires-Dist: pytest>=8; extra == 'dev'
Requires-Dist: ruff>=0.6; extra == 'dev'
Description-Content-Type: text/markdown

# open-meteo-client

A lightweight, async Python client for the [Open-Meteo](https://open-meteo.com) weather API — with high-level helpers that fit on a sticky note.

```python
from openmeteo import weather

await weather.today("Dresden")
```

**Status:** 🚧 Pre-alpha. Design in progress, not yet functional.

## Planned features

- **Lightweight** — two dependencies (`httpx`, `pydantic`), no FlatBuffers, no pandas
- **Async-first** — built on `httpx.AsyncClient`
- **Typed** — full pydantic v2 models, `StrEnum` for weather variables, IDE autocomplete
- **Two layers** — high-level convenience API (`weather.today()`) on top of a full low-level `Client`

## Install

```bash
pip install open-meteo-client
```

> ⚠️ Package reserved — no functionality yet. Check back for v0.1.0.

## License

Apache-2.0. See [LICENSE](LICENSE).
