Metadata-Version: 2.4
Name: dwzclient
Version: 0.1.3
Summary: Async client for the DSB DWZ liste REST API (minimal)
Author-email: Uli Baumann <dwz@uli-baumann.de>
License: MIT
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: aiohttp>=3.8
Dynamic: license-file

# dwzclient

Minimal async DWZ client for the DSB DWZListeREST API. Provides `DWZClient.get_person(nuliga_id)` returning a `Person` dataclass.

Example:

```py
import aiohttp
from dwzclient import DWZClient

async def main():
    async with aiohttp.ClientSession() as session:
        client = DWZClient(session)
        person = await client.get_person("123")
        print(person.rating)

```

Installation

Install from PyPI:

```bash
pip install dwzclient
```

Development & Contributing

See `CONTRIBUTING.md` for development, testing and release guidance.

Examples
--------

See the example script `examples/fetch_person.py` for a minimal runnable example that fetches a person's data and prints the `Person` object. The script already includes Vincent Keymer's `nuLiga` id (`NU4168433`).

Run the example
---------------

Recommended (creates isolated env and installs package editable):

```bash
python -m venv .venv
source .venv/bin/activate
pip install -e .
python -m examples.fetch_person
```

Alternative (without installing, sets `PYTHONPATH` so the local package is importable):

```bash
PYTHONPATH=. python examples/fetch_person.py
```

