Metadata-Version: 2.4
Name: mpvnet_cz_api
Version: 1.2
Summary: API for mpvnet.cz.
Author-email: Matěj Adamec <kralyk@kralyk.dev>
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: beautifulsoup4==4.15.0
Requires-Dist: bs4==0.0.2
Requires-Dist: certifi==2026.7.22
Requires-Dist: charset-normalizer==3.4.9
Requires-Dist: idna==3.18
Requires-Dist: requests==2.34.2
Requires-Dist: soupsieve==2.9.2
Requires-Dist: typing_extensions==4.16.0
Requires-Dist: urllib3==2.7.0
Dynamic: license-file

# MPVNET.CZ API
API pro get dat z odjezdové tabule z mpvnet.cz

## Instalace
```bash
pip install mpvnet_cz_api
```

## Example
```py
from mpvnet_cz_api import Api

api = Api(53289, "idol")
print(api.sync())
```
- První číslo je číslo zastávky.
- Druhé pole je dopravce (pid, idol, odis, zlin, jikord)

```py
from mpvnet_cz_api import Stop

print(Stop.search("Janův Důl", "idol"))
```
- `Stop.search()` vrací naparsovaný seznam objektů s `label` a `value`, kde
  `value.stopNum` je číslo zastávky. `Stop.get_num()` zůstává jako kompatibilní
  metoda vracející raw JSON text.

## Vlastní payload a timeout

Číslo zastávky je povinné. Výchozí hodnoty ostatních polí lze přepsat přes
`payload` a `stop_key`; `stopNum` je vždy vynucen z argumentu `stop_number`.

```py
api = Api(
    53289,
    "idol",
    payload={"isDepartures": True},
    stop_key={"cat": 2, "subCat": 0, "departures": None},
    timeout=5,
)
```

HTTP chyby, neplatný vstup a neplatný JSON jsou hlášeny výjimkou.

## Verze
| Verze | Stav | Poznámka |
| --- | --- | --- |
| **1.0-1.1** | ✅ | Omezená funkcionalita programu |
| **1.2** | ⭐ ||
