# Strava.cz Python API
High level API pro interakci s webovou aplikaci Strava.cz udelane v Pythonu ciste pomoci request knihovny.
Ve slozce [notes](https://github.com/jsem-nerad/strava-cz-python/tree/main/notes) muzete najit veskere moje poznatky, ktere jsem zjistil o internim fungovani aplikace Strava.cz.
## Features
- Prihlaseni/odhlaseni
- Vypsani prefiltrovaneho jidelnicku
- Objednavani jidel podle ID jidla
## Usage
```bash
pip install strava-cz
```
```python
from strava_cz import StravaCZ
# vytvoreni objektu strava a prihlaseni uzivatele
strava = StravaCZ(username="your.username", password="YourPassword123", canteen_number="3753")
# vypsani informaci o uzivateli
print(strava.user)
# ziskani jidelnicku; ulozi list do strava.menu
print(strava.get_menu_list())
# zjisti, jestli je jidlo s meal_id 4 objednano (True/False)
print(strava.is_ordered(4))
# objedna jidlo s meal_id 4
strava.order_meal(4)
# objedna jidla s meal_id 3 a 6
strava.order_meals(3, 6)
# odhlasi uzivatele
strava.logout()
```
> meal_id je unikatni identifikacni cislo jidla v celem jidelnicku. jeste jsem poradne nezjistil, jak a jestli se meni v zavislosti na zmene jidelnicku.
| funkce | parametry | return type | popis |
|---------------------|-----------------------------------------------------------|-------------|--------------------------------------------------------------------------------------------------------------------|
| `__init__()` | username=None, password=None, canteen_number=None | None | Inicializuje objekt StravaCZ a automaticky prihlasi uzivatele, pokud jsou vyplnene parametry username a password |
| `login()` | username (str), password (str), canteen_number=None (str) | User | Prihlasi uzivatele pomoci uzivatelskeho jmena a hesla; pokud neni vyplnene cislo jidelny, automaticky pouzije 3753 |
| `get_menu_list()` | None | list | Vrati jidelnicek jako seznam podle dni; zaroven ho ulozi do promenne menu |
| `is_ordered()` | meal_id (int) | bool | Zjisti, jestli je dane jidlo objednano |
| `order_meal()` | meal_id (int) | None | Objedna jidlo podle meal_id |
| `order_meals()` | *meal_ids (int) | None | Objedna vice jidel podle meal_id |
| `logout()` | None | bool | Odhlasi uzivatele |
## to-do
- [x] Nahrat jako knihovnu na PyPi
- [x] Lepe zorganizovat kod
- [ ] Univerzalni datum
- [ ] Moznost detailni filtrace jidelnicku
- [ ] Lepe zdokumentovat pouziti
## Co bude dal?
Planuji udelat aplikaci, ktera bude uzivateli automaticky objednavat obedy podle jeho preferenci.
Prosim, nepouzivejte tuto aplikaci k nekalym ucelum. Pouzivejte ji pouze s dobrymi zamery.
## Pomoz mi pls
Nasel jsi chybu nebo mas navrh na zlepseni? Skvele! Vytvor prosim [bug report](https://github.com/jsem-nerad/strava-cz-python/issues/new?labels=bug) nebo [feature request](https://github.com/jsem-nerad/strava-cz-python/issues/new?labels=enhancement), hodne mi tim muzes pomoct.
Udelal jsi sam nejake zlepseni? Jeste lepsi! Kazdy pull request je vitan.
Raw data
{
"_id": null,
"home_page": null,
"name": "strava-cz",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": null,
"keywords": "czech, canteen, food, school, strava, jidelna, api, scraper, web-scraping",
"author": null,
"author_email": "Vojt\u011bch Nerad <ja@jsem-nerad.cz>",
"download_url": "https://files.pythonhosted.org/packages/e2/f3/a7f4d03b97d690982671ea785cad53feef27dd2c2bd31ca845bfaa31f63d/strava_cz-0.1.1.tar.gz",
"platform": null,
"description": "# Strava.cz Python API\n\nHigh level API pro interakci s webovou aplikaci Strava.cz udelane v Pythonu ciste pomoci request knihovny.\n\nVe slozce [notes](https://github.com/jsem-nerad/strava-cz-python/tree/main/notes) muzete najit veskere moje poznatky, ktere jsem zjistil o internim fungovani aplikace Strava.cz.\n\n## Features\n- Prihlaseni/odhlaseni\n- Vypsani prefiltrovaneho jidelnicku \n- Objednavani jidel podle ID jidla\n\n\n## Usage\n\n```bash\npip install strava-cz\n```\n\n\n\n```python\nfrom strava_cz import StravaCZ\n\n# vytvoreni objektu strava a prihlaseni uzivatele\nstrava = StravaCZ(username=\"your.username\", password=\"YourPassword123\", canteen_number=\"3753\")\n\n# vypsani informaci o uzivateli\nprint(strava.user)\n\n# ziskani jidelnicku; ulozi list do strava.menu\nprint(strava.get_menu_list())\n\n# zjisti, jestli je jidlo s meal_id 4 objednano (True/False)\nprint(strava.is_ordered(4))\n\n# objedna jidlo s meal_id 4\nstrava.order_meal(4)\n\n# objedna jidla s meal_id 3 a 6\nstrava.order_meals(3, 6)\n\n# odhlasi uzivatele\nstrava.logout()\n```\n\n> meal_id je unikatni identifikacni cislo jidla v celem jidelnicku. jeste jsem poradne nezjistil, jak a jestli se meni v zavislosti na zmene jidelnicku.\n\n\n| funkce | parametry | return type | popis |\n|---------------------|-----------------------------------------------------------|-------------|--------------------------------------------------------------------------------------------------------------------|\n| `__init__()` | username=None, password=None, canteen_number=None | None | Inicializuje objekt StravaCZ a automaticky prihlasi uzivatele, pokud jsou vyplnene parametry username a password |\n| `login()` | username (str), password (str), canteen_number=None (str) | User | Prihlasi uzivatele pomoci uzivatelskeho jmena a hesla; pokud neni vyplnene cislo jidelny, automaticky pouzije 3753 |\n| `get_menu_list()` | None | list | Vrati jidelnicek jako seznam podle dni; zaroven ho ulozi do promenne menu |\n| `is_ordered()` | meal_id (int) | bool | Zjisti, jestli je dane jidlo objednano |\n| `order_meal()` | meal_id (int) | None | Objedna jidlo podle meal_id |\n| `order_meals()` | *meal_ids (int) | None | Objedna vice jidel podle meal_id |\n| `logout()` | None | bool | Odhlasi uzivatele |\n\n\n## to-do\n\n- [x] Nahrat jako knihovnu na PyPi\n- [x] Lepe zorganizovat kod\n- [ ] Univerzalni datum\n- [ ] Moznost detailni filtrace jidelnicku\n- [ ] Lepe zdokumentovat pouziti\n\n## Co bude dal?\n\nPlanuji udelat aplikaci, ktera bude uzivateli automaticky objednavat obedy podle jeho preferenci.\n\nProsim, nepouzivejte tuto aplikaci k nekalym ucelum. Pouzivejte ji pouze s dobrymi zamery.\n\n\n## Pomoz mi pls\n\nNasel jsi chybu nebo mas navrh na zlepseni? Skvele! Vytvor prosim [bug report](https://github.com/jsem-nerad/strava-cz-python/issues/new?labels=bug) nebo [feature request](https://github.com/jsem-nerad/strava-cz-python/issues/new?labels=enhancement), hodne mi tim muzes pomoct.\n\nUdelal jsi sam nejake zlepseni? Jeste lepsi! Kazdy pull request je vitan.\n\n\n\n\n",
"bugtrack_url": null,
"license": null,
"summary": "High level API pro interakci s webovou aplikaci Strava.cz",
"version": "0.1.1",
"project_urls": {
"Documentation": "https://github.com/jsem-nerad/strava-cz#readme",
"Homepage": "https://github.com/jsem-nerad/strava-cz",
"Issues": "https://github.com/jsem-nerad/strava-cz/issues",
"Repository": "https://github.com/jsem-nerad/strava-cz"
},
"split_keywords": [
"czech",
" canteen",
" food",
" school",
" strava",
" jidelna",
" api",
" scraper",
" web-scraping"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "070029868a7b4f3b969dab84e075a1293e653d2416afc91f638ad5b1f28fedfb",
"md5": "74c62cade20037a9ef212ddb5007d983",
"sha256": "35d735dba04b2059963871542674558d5845b362276bfcfa9c770b7c8e94de5d"
},
"downloads": -1,
"filename": "strava_cz-0.1.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "74c62cade20037a9ef212ddb5007d983",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 17754,
"upload_time": "2025-09-14T11:16:18",
"upload_time_iso_8601": "2025-09-14T11:16:18.137785Z",
"url": "https://files.pythonhosted.org/packages/07/00/29868a7b4f3b969dab84e075a1293e653d2416afc91f638ad5b1f28fedfb/strava_cz-0.1.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "e2f3a7f4d03b97d690982671ea785cad53feef27dd2c2bd31ca845bfaa31f63d",
"md5": "1ca6d3bab291632389918c790cf502f8",
"sha256": "f37352d6b5fb727c2f51c8f8abbf37da086bb7543548ead38fe0c7415a434ae3"
},
"downloads": -1,
"filename": "strava_cz-0.1.1.tar.gz",
"has_sig": false,
"md5_digest": "1ca6d3bab291632389918c790cf502f8",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 19569,
"upload_time": "2025-09-14T11:16:19",
"upload_time_iso_8601": "2025-09-14T11:16:19.547397Z",
"url": "https://files.pythonhosted.org/packages/e2/f3/a7f4d03b97d690982671ea785cad53feef27dd2c2bd31ca845bfaa31f63d/strava_cz-0.1.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-09-14 11:16:19",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "jsem-nerad",
"github_project": "strava-cz#readme",
"github_not_found": true,
"lcname": "strava-cz"
}
JSON
