strava-cz-api 2.1.2__tar.gz

strava_cz_api-2.1.2/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Matěj Adamec
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

strava_cz_api-2.1.2/PKG-INFO

@@ -0,0 +1,98 @@
+Metadata-Version: 2.4
+Name: strava_cz_api
+Version: 2.1.2
+Summary: Rest API for strava.cz.
+Author-email: Matěj Adamec <kralyk@kralyk.dev>
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# Strava.cz rest API
+> ⚠️ **UPOZORNĚNÍ:** Strava.cz má vysoce proměnlivé prostředí (každá jídelna má jiný počet obědů, jiné názvy chodů apod.) z toho důvodu toto API **není plně univerzální**. I když jsem se snažil ho napsat univerzálně, nějaké metody nemusí plně fungovat a bude to vyžadovat vaší opravu. 
+
+Toto je **neoficiální** REST api pro stravu.cz. V tomto dokumentu je popsáno vše co potřebuješ vědet o tomto API. Je zde také vysvětleno dopodrobna jak to celé funguje.
+
+## Instalace
+```bash
+pip install strava_cz_api.cz_api
+```
+
+## Autentizace
+K API endpointům potřebuješ **SID** a **s5url**. Můžeš si je získat sám z dev tools v prohlížeči, ale nejlepší cesta je pomocí metod: `Auth.login()` a `Auth.getCredentials()`:
+
+```py
+from strava_cz_api import Auth
+
+cookie, data = Auth.login("demo", "demo", "0000")
+sid, s5url = Auth.getCredentials(data)
+```
+
+**Poznámky:**
+- Podporované jazyky: `CZ`, `EN`, `SK`.
+- `Auth.login()` vrací `cookie` a JSON data; `Auth.getCredentials()` z nich vytáhne `sid` a `s5url`.
+
+## Inicializace API
+```py
+from strava_cz_api import Api
+
+api = Api(
+    sid="00000000000000000000000000000000",
+    s5url="", 
+    cislo_jidelny="0000"
+)
+```
+
+**Poznámky:**
+- `s5url=""` může být hash, url či prázdné. Někdy se stane, že musí být spravný input, někdy může být prázné. 
+
+## Veřejné endpointy (bez přihlášení)
+
+| Metoda | Popis | Poznámka |
+| --- | --- | --- |
+| `getJidelny()` | Seznam jídelen
+| `getJidelna()` | Informace o jídělne
+| `getS5url()` | URL jídelny
+| `getJidelnicek()` | Get veřejného jídelníčku 
+
+## Autentizované endpointy (Api)
+| Metoda | Popis | Poznámka |
+| --- | --- | --- |
+| `getJidelnicekToday()` | Dnešní jídelníček | Vrací list (`table0`) |
+| `getJidelnicekAll()` | Kompletní jídelníček 
+| `getInfo()` | Informace o uživateli
+| `getUsername()` | Uživatelské jméno | Vytahuje z `getInfo()` |
+| `getJidelna()` | Informace o jídelně 
+| `getHistorieKlienta(date)` | Historie objednávek za měsíc | `date` = první den měsíce (např. `2025-01-01`) |
+| `getPlaby()` | Pohyby na účtu
+| `getMessages()` | Zprávy pro uživatele 
+| `getProtokol()` | Vrátí protokol
+| `getVydej()` | Vrátí list vydaných jídel.
+| `postJidlo(veta, stav)` | Přihlásit/odhlásit jídlo | `stav`: 1 přihlásit, 0 odhlásit |
+| `postDen(datum, stav)` | Přihlásit/odhlásit celý den | `datum` ve formátu `YYYY-MM-DD` |
+| `postOrders()` | Uložit změny objednávek | Nutné po `postJidlo`/`postDen` |
+
+## Objednávky – správný postup
+Změny objednávek se ukládají ve dvou krocích:
+1. Provedení změn (`postJidlo` nebo `postDen`)
+2. Uložení (`postOrders`)
+
+```py
+cookie_data = api.postJidlo(5, 1)
+cookie_data = api.postOrders()
+```
+
+## Návratové hodnoty
+Většina metod vrací JSON string. Metody `postJidlo`, `postDen` a `postOrders` vrací dvojici `(cookie, data)` z POST odpovědi. 
+
+## Chyby a omezení
+- Error handling je dostupný přes výjimky, které lze importovat: `from strava_cz_api import StravaError`.
+- Při neúspěšném požadavku se vyhazuje `ConnectionError`.
+- Některé jídelny mohou vyžadovat úpravy payloadů nebo cookie.
+
+## Příklady
+Ukázkové skripty najdeš ve složce `./examples`.
+
+## Demo
+- Demo uživatele si lze vytvořit na https://www.strava.cz/strava/Stravnik/Demo
+- Poté se lze přihlásit na https://app.strava.cz/ na jídelně `0000`

strava_cz_api-2.1.2/README.md

@@ -0,0 +1,88 @@
+# Strava.cz rest API
+> ⚠️ **UPOZORNĚNÍ:** Strava.cz má vysoce proměnlivé prostředí (každá jídelna má jiný počet obědů, jiné názvy chodů apod.) z toho důvodu toto API **není plně univerzální**. I když jsem se snažil ho napsat univerzálně, nějaké metody nemusí plně fungovat a bude to vyžadovat vaší opravu. 
+
+Toto je **neoficiální** REST api pro stravu.cz. V tomto dokumentu je popsáno vše co potřebuješ vědet o tomto API. Je zde také vysvětleno dopodrobna jak to celé funguje.
+
+## Instalace
+```bash
+pip install strava_cz_api.cz_api
+```
+
+## Autentizace
+K API endpointům potřebuješ **SID** a **s5url**. Můžeš si je získat sám z dev tools v prohlížeči, ale nejlepší cesta je pomocí metod: `Auth.login()` a `Auth.getCredentials()`:
+
+```py
+from strava_cz_api import Auth
+
+cookie, data = Auth.login("demo", "demo", "0000")
+sid, s5url = Auth.getCredentials(data)
+```
+
+**Poznámky:**
+- Podporované jazyky: `CZ`, `EN`, `SK`.
+- `Auth.login()` vrací `cookie` a JSON data; `Auth.getCredentials()` z nich vytáhne `sid` a `s5url`.
+
+## Inicializace API
+```py
+from strava_cz_api import Api
+
+api = Api(
+    sid="00000000000000000000000000000000",
+    s5url="", 
+    cislo_jidelny="0000"
+)
+```
+
+**Poznámky:**
+- `s5url=""` může být hash, url či prázdné. Někdy se stane, že musí být spravný input, někdy může být prázné. 
+
+## Veřejné endpointy (bez přihlášení)
+
+| Metoda | Popis | Poznámka |
+| --- | --- | --- |
+| `getJidelny()` | Seznam jídelen
+| `getJidelna()` | Informace o jídělne
+| `getS5url()` | URL jídelny
+| `getJidelnicek()` | Get veřejného jídelníčku 
+
+## Autentizované endpointy (Api)
+| Metoda | Popis | Poznámka |
+| --- | --- | --- |
+| `getJidelnicekToday()` | Dnešní jídelníček | Vrací list (`table0`) |
+| `getJidelnicekAll()` | Kompletní jídelníček 
+| `getInfo()` | Informace o uživateli
+| `getUsername()` | Uživatelské jméno | Vytahuje z `getInfo()` |
+| `getJidelna()` | Informace o jídelně 
+| `getHistorieKlienta(date)` | Historie objednávek za měsíc | `date` = první den měsíce (např. `2025-01-01`) |
+| `getPlaby()` | Pohyby na účtu
+| `getMessages()` | Zprávy pro uživatele 
+| `getProtokol()` | Vrátí protokol
+| `getVydej()` | Vrátí list vydaných jídel.
+| `postJidlo(veta, stav)` | Přihlásit/odhlásit jídlo | `stav`: 1 přihlásit, 0 odhlásit |
+| `postDen(datum, stav)` | Přihlásit/odhlásit celý den | `datum` ve formátu `YYYY-MM-DD` |
+| `postOrders()` | Uložit změny objednávek | Nutné po `postJidlo`/`postDen` |
+
+## Objednávky – správný postup
+Změny objednávek se ukládají ve dvou krocích:
+1. Provedení změn (`postJidlo` nebo `postDen`)
+2. Uložení (`postOrders`)
+
+```py
+cookie_data = api.postJidlo(5, 1)
+cookie_data = api.postOrders()
+```
+
+## Návratové hodnoty
+Většina metod vrací JSON string. Metody `postJidlo`, `postDen` a `postOrders` vrací dvojici `(cookie, data)` z POST odpovědi. 
+
+## Chyby a omezení
+- Error handling je dostupný přes výjimky, které lze importovat: `from strava_cz_api import StravaError`.
+- Při neúspěšném požadavku se vyhazuje `ConnectionError`.
+- Některé jídelny mohou vyžadovat úpravy payloadů nebo cookie.
+
+## Příklady
+Ukázkové skripty najdeš ve složce `./examples`.
+
+## Demo
+- Demo uživatele si lze vytvořit na https://www.strava.cz/strava/Stravnik/Demo
+- Poté se lze přihlásit na https://app.strava.cz/ na jídelně `0000`

strava_cz_api-2.1.2/examples/login.py

@@ -0,0 +1,26 @@
+# made by OpiKula
+
+from strava_cz_api import Api, Auth, StravaError
+import getpass
+
+# Ziskame od uzivatele credentials
+username = input("Zadej zde svoje uživatelské jméno: ")
+password = getpass.getpass("Zadej zde svoje heslo: ")
+jidelna = input("Zadej zde číslo jídelny: ")
+
+# Poslani post requestu a getnuti SID a s5url
+try:
+    cookie, data = Auth.login(username, password, jidelna)
+
+except StravaError:
+    print("Chybné heslo")
+    exit()
+
+# ziskame sid a s5url
+sid, s5url = Auth.getCredentials(data)
+
+# Inicializujeme spojeni a vytiskneme jidelnicek
+example = Api(sid, s5url, jidelna)
+
+
+print(example.getJidelnicekToday())

strava_cz_api-2.1.2/examples/public_jidelnicek.py

@@ -0,0 +1,10 @@
+from strava import Public
+import json
+
+cislo_jidelny = input("Zadej cislo jidelny: ").strip()
+lang = (input("Jazyk (CZ/EN/SK) [CZ]: ").strip() or "CZ").upper()
+
+data = Public.getJidelnicek(cislo_jidelny, lang)
+jidelnicek = json.loads(data)
+
+print(json.dumps(jidelnicek, indent=2, ensure_ascii=False))

strava_cz_api-2.1.2/examples/user_info.py

@@ -0,0 +1,18 @@
+from strava import Api, Auth
+import getpass
+import json
+
+username = input("Zadej uzivatelske jmeno: ").strip()
+password = getpass.getpass("Zadej heslo: ")
+cislo_jidelny = input("Zadej cislo jidelny: ").strip()
+
+_cookie, data = Auth.login(username, password, cislo_jidelny)
+sid, s5url = Auth.getCredentials(data)
+
+api = Api(sid, s5url, cislo_jidelny)
+
+print("Uzivatel:", api.getUsername())
+print("Info:")
+print(json.dumps(json.loads(api.getInfo()), indent=2, ensure_ascii=False))
+print("Jidelna:")
+print(json.dumps(json.loads(api.getJidelna()), indent=2, ensure_ascii=False))

strava_cz_api-2.1.2/pyproject.toml

@@ -0,0 +1,16 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[tool.setuptools.packages.find]
+where = ["."]
+
+[project]
+name = "strava_cz_api"
+version = "2.1.2"
+description = "Rest API for strava.cz."
+readme = "README.md"
+requires-python = ">=3.8"
+authors = [
+  { name="Matěj Adamec", email="kralyk@kralyk.dev" }
+]

strava_cz_api-2.1.2/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

strava_cz_api-2.1.2/strava_cz_api/action.py

@@ -0,0 +1,78 @@
+import requests
+import json
+
+class StravaError(Exception):
+    pass
+
+class JidelnaNenalezenaError(StravaError):
+    pass
+
+class ChybneHesloError(StravaError):
+    pass
+
+class BackendError(StravaError):
+    pass
+
+class ChybneSID(StravaError):
+    pass
+
+def raise_api_error(data):
+    if data.get("state") != "error":
+        return
+
+    number = data.get("number")
+    message = data.get("message", "Neznámá chyba")
+
+    exc = ERROR_MAP.get(number, StravaError)
+    raise exc(message)
+
+
+ERROR_MAP = {
+    6: JidelnaNenalezenaError,
+    15: ChybneSID,
+    13405: ChybneHesloError,
+    3002: BackendError,
+}
+
+class Get:
+    @staticmethod
+    def call(url, payload, headers=
+        {
+            "Content-Type": "text/plain;charset=UTF-8",
+            "Cookie": "NEXT_LOCALE=cs; multiContextSession=%7B%22printOpen%22%3A%7B%22value%22%3Afalse%2C%22expiration%22%3A-1%7D%7D",
+            "Referer": "https://app.strava.cz/"
+        }):
+
+        response = requests.post(url, headers=headers, json=payload)
+            
+        data = response.json()
+
+        raise_api_error(data)
+
+        return json.dumps(data, indent=2, ensure_ascii=False)
+            
+
+
+class Post:
+    @staticmethod
+    def call(url, payload, cookie, headers=None):
+        if headers is None:
+            headers = {
+                "Content-Type": "text/plain;charset=UTF-8",
+                "Cookie": cookie,
+                "Referer": "https://app.strava.cz/"
+            }
+
+
+        response = requests.post(url, headers=headers, json=payload)
+
+        data = response.json()
+
+        raise_api_error(data)
+
+        new_cookie = "; ".join([f"{k}={v}" for k, v in response.cookies.items()])
+
+        return new_cookie, data
+
+
+

strava_cz_api-2.1.2/strava_cz_api/strava.py

@@ -0,0 +1,362 @@
+import requests
+import json
+from action import Get, Post
+
+from action import (
+    StravaError,
+    JidelnaNenalezenaError,
+    ChybneHesloError,
+    BackendError,
+    ChybneSID
+)
+
+__all__ = [
+    "Api",
+    "Auth",
+    "StravaError",
+    "JidelnaNenalezenaError",
+    "ChybneHesloError",
+    "BackendError",
+    "ChybneSID"
+]
+
+
+class Api:
+    def __init__(self, sid, s5url, cislo_jidelny, cookie="NEXT_LOCALE=cs; multiContextSession=%7B%22printOpen%22%3A%7B%22value%22%3Afalse%2C%22expiration%22%3A-1%7D%7D", lang="CZ"):
+        if lang not in ("CZ", "EN", "SK"):
+            raise ValueError("Podporované jazyky: EN, CZ, SK")
+        
+        self.sid = sid
+        self.lang = lang
+        self.cislo_jidelny = cislo_jidelny
+        self.cookie = cookie
+        self.s5url = s5url
+
+        self.base = "https://app.strava.cz/api"
+
+
+    def getJidelnicekToday(self):
+        """
+        Vrátí dnešní jídelníček
+        """
+        return json.loads(self.getJidelnicekAll()).get("table0", [])
+
+
+    def getJidelnicekAll(self):
+        """
+        Vrátí celý jídelníček
+        """
+        url = f"{self.base}/objednavky"
+
+        payload = {
+            "cislo": self.cislo_jidelny,
+            "sid": self.sid,
+            "s5url": self.s5url,
+            "lang": self.lang,
+            "konto": 0,
+            "podminka": "",
+            "ignoreCert": "false"
+        }
+
+        return Get.call(url, payload)
+
+
+    def getInfo(self):
+        """
+        Vrátí info o uživateli
+        """
+        url = f"{self.base}/nactiVlastnostiPA"
+
+        payload = {
+            "sid": self.sid,
+            "url": self.s5url,
+            "cislo": self.cislo_jidelny,
+            "ignoreCert": "false",
+            "lang": self.lang,
+            "getText": True,
+            "checkVersion": True,
+            "resetTables" :True,
+            "frontendFunction": "refreshInformations"
+        }
+
+
+        return Get.call(url, payload)
+    
+
+    def getUsername(self):
+        """
+        Vrátí uživatelské jméno
+        """
+
+        return json.loads(self.getInfo()).get("id")
+
+
+    def getJidelna(self):
+        """
+        Získá informaci o jídělně
+        """
+
+        url = f"{self.base}/jidelnaS5"
+
+        payload = {
+            "cislo": self.cislo_jidelny,
+            "url": self.s5url,
+            "lang": self.lang,
+            "ignoreCert": "false"
+        }
+
+
+        return Get.call(url, payload)
+
+
+    def getHistorieKlienta(self, date):
+        """
+        Získá info o historii objednávek.
+        
+        date = počáteční datum měsíce. 
+        2025-01-01 - leden
+        2025-12-01 - prosinec
+        """
+
+        url = f"{self.base}/historieKlienta"
+
+        payload = {
+            "sid": self.sid,
+            "url": self.s5url,
+            "cislo": self.cislo_jidelny,
+            "datum": date,
+            "lang": self.lang,
+            "ignoreCert": "false"
+        }
+
+
+        return Get.call(url, payload)
+
+
+    def getPlaby(self):
+        """
+        Vrátí platby na účtu.
+        """
+
+        url = f"{self.base}/platby"
+
+        payload = {
+            "sid": self.sid,
+            "url": self.s5url,
+            "cislo": self.cislo_jidelny,
+            "lang": self.lang,
+            "ignoreCert": "false"
+        }
+
+
+        return Get.call(url, payload)
+
+
+    def getMessages(self):
+        """
+        Vratí zprávy poslané uživatelovi.
+        """
+
+        url = f"{self.base}/messagesGetList"
+
+        payload = {
+            "sid": "",
+            "idO":"",
+            "idJ": self.cislo_jidelny,
+            "idU": self.getUsername(),
+            "typZpravy": ""
+        }
+
+        return Get.call(url, payload)
+
+
+    def getProtokol(self):
+        """
+        Vrátí protokol.
+        """
+
+        url = f"{self.base}/getProtokol"
+
+        payload = {
+            "cislo": self.cislo_jidelny,
+            "s5url": self.s5url,
+            "sid": self.sid,
+            "ignoreCert": "false",
+            "lang": self.lang,
+            "uroven": "KP",
+            "evCislo": 0
+        }
+
+
+        return Get.call(url, payload)
+
+    def getVydej(self):
+        """
+        Vrátí list vydaných jídel.
+        """
+
+        url = f"{self.base}/vydej"
+
+        payload = {
+            "cislo": self.cislo_jidelny,
+            "s5url": self.s5url,
+            "sid": self.sid,
+            "ignoreCert": "false",
+            "lang": self.lang,
+        }
+
+
+        return Get.call(url, payload)
+
+
+    def postJidlo(self, veta, stav):
+        """
+        Příhlásí nebo odhlásí jídlo.
+        
+        veta = číslo políčka/jídla - jde získat např. z getJidelnicek()
+        stav =  0 odhlásit - 1 přihlásit
+        """
+        url = f"{self.base}/pridejJidloS5"
+
+        payload = {
+            "cislo": self.cislo_jidelny,
+            "sid": self.sid,
+            "url": self.s5url,
+            "veta": veta, 
+            "pocet": stav, # 0 ohlasit - 1 prihlasit
+            "lang": self.lang,
+            "ignoreCert": "false"
+        }
+
+        self.cookie = Post.call(url, payload, self.cookie)
+
+        return self.cookie
+
+
+    def postOrders(self):
+        """
+        Uloží objednávky
+        """
+        url = f"{self.base}/saveOrders"
+
+
+        payload = {
+            "cislo": self.cislo_jidelny,
+            "sid": self.sid,
+            "url": self.s5url,
+            "xml": None,
+            "lang": self.lang,
+            "ignoreCert": "false"
+        }
+        
+        self.cookie = Post.call(url, payload, self.cookie)
+
+        return self.cookie
+
+
+    def postDen(self, datum, stav):
+        """
+        Přihlásí nebo ohlásí celý den.
+        
+        datum = datum dne jaký chceme odhlásit. 2025-12-30
+        stav =  0 ohlasit - 1 prihlasit
+        """
+
+        url = f"{self.base}/objednejDenS5"
+
+        payload = {
+            "cislo": self.cislo_jidelny,
+            "sid": self.sid,
+            "url": self.s5url,
+            "datum": datum,
+            "pocet": stav,
+            "lang": self.lang,
+            "ignoreCert": "false"
+        }
+
+        self.cookie = Post.call(url, payload, self.cookie)
+
+        return self.cookie
+
+
+class Public:
+    def getJidelnicek(cislo_jidelny, lang):
+        """
+        Získání public jídelníčků.
+        """
+        if lang not in ("CZ", "EN", "SK"):
+            raise ValueError("Podporované jazyky: EN, CZ, SK")
+
+        url = "https://app.strava.cz/api/jidelnicky"
+
+        payload = {
+            "cislo": cislo_jidelny,
+            "s5url": Public.getS5url(cislo_jidelny),
+            "lang": lang,
+            "ignoreCert": False
+        }
+
+        return Get.call(url, payload)
+
+    def getJidelna(cislo_jidelny):
+        """
+        Vrátí informaci o jídelně.
+        """
+        url = "https://app.strava.cz/api/s4Polozky"
+
+        payload = {
+            "cislo": cislo_jidelny,
+            "lang": "CZ",
+            "polozky": "V_NAZEV,V_ULICE,V_MESTO,V_PSC,V_TELEFON,V_UCET,V_EMAIL,V_URL,DATCAS_AKT,VERZE,URLWSDL_S-URL,GPSDELKA,GPSSIRKA,IGN_CERT,TEXT_ANON,LOGO"}
+
+        return Get.call(url, payload)
+
+    def getS5url(cislo_jidelny):
+        """
+        Pomocná metoda co vratí url jídelny.
+        """
+        return json.loads(Public.getJidelna(cislo_jidelny)).get("urlwsdl_s")[0]
+        
+
+    def getJidelny():
+        """
+        Vrátí seznam všech jídelen a jejich čísel.
+        """
+        url = "https://app.strava.cz/api/zarAMesta"
+        
+        payload = {
+            "lang":"CZ"
+        }
+
+        return Get.call(url, payload)
+
+
+class Auth:
+    def login(username, password, cislo_jidelny, lang="CZ", zustat_prihlasen=True, cookie="NEXT_LOCALE=cs"):
+        """
+        Vrátí data nutná pro další komunikaci.
+        """
+        if lang not in ("CZ", "EN", "SK"):
+            raise ValueError("Podporované jazyky: EN, CZ, SK")
+        
+        url = "https://app.strava.cz/api/login"
+
+        payload = {
+            "cislo": cislo_jidelny,
+            "jmeno": username,
+            "heslo": password,
+            "zustatPrihlasen": zustat_prihlasen,
+            "environment": "W",
+            "lang": lang
+        }
+
+        return Post.call(url, payload, cookie)
+
+    def getCredentials(data):
+        """
+        Vyfiltruje SID a s5url z funkce login
+        """
+
+        sid = data.get("sid")
+        s5url = data.get("s5url")
+        return sid, s5url

strava_cz_api-2.1.2/strava_cz_api.egg-info/PKG-INFO

@@ -0,0 +1,98 @@
+Metadata-Version: 2.4
+Name: strava_cz_api
+Version: 2.1.2
+Summary: Rest API for strava.cz.
+Author-email: Matěj Adamec <kralyk@kralyk.dev>
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# Strava.cz rest API
+> ⚠️ **UPOZORNĚNÍ:** Strava.cz má vysoce proměnlivé prostředí (každá jídelna má jiný počet obědů, jiné názvy chodů apod.) z toho důvodu toto API **není plně univerzální**. I když jsem se snažil ho napsat univerzálně, nějaké metody nemusí plně fungovat a bude to vyžadovat vaší opravu. 
+
+Toto je **neoficiální** REST api pro stravu.cz. V tomto dokumentu je popsáno vše co potřebuješ vědet o tomto API. Je zde také vysvětleno dopodrobna jak to celé funguje.
+
+## Instalace
+```bash
+pip install strava_cz_api.cz_api
+```
+
+## Autentizace
+K API endpointům potřebuješ **SID** a **s5url**. Můžeš si je získat sám z dev tools v prohlížeči, ale nejlepší cesta je pomocí metod: `Auth.login()` a `Auth.getCredentials()`:
+
+```py
+from strava_cz_api import Auth
+
+cookie, data = Auth.login("demo", "demo", "0000")
+sid, s5url = Auth.getCredentials(data)
+```
+
+**Poznámky:**
+- Podporované jazyky: `CZ`, `EN`, `SK`.
+- `Auth.login()` vrací `cookie` a JSON data; `Auth.getCredentials()` z nich vytáhne `sid` a `s5url`.
+
+## Inicializace API
+```py
+from strava_cz_api import Api
+
+api = Api(
+    sid="00000000000000000000000000000000",
+    s5url="", 
+    cislo_jidelny="0000"
+)
+```
+
+**Poznámky:**
+- `s5url=""` může být hash, url či prázdné. Někdy se stane, že musí být spravný input, někdy může být prázné. 
+
+## Veřejné endpointy (bez přihlášení)
+
+| Metoda | Popis | Poznámka |
+| --- | --- | --- |
+| `getJidelny()` | Seznam jídelen
+| `getJidelna()` | Informace o jídělne
+| `getS5url()` | URL jídelny
+| `getJidelnicek()` | Get veřejného jídelníčku 
+
+## Autentizované endpointy (Api)
+| Metoda | Popis | Poznámka |
+| --- | --- | --- |
+| `getJidelnicekToday()` | Dnešní jídelníček | Vrací list (`table0`) |
+| `getJidelnicekAll()` | Kompletní jídelníček 
+| `getInfo()` | Informace o uživateli
+| `getUsername()` | Uživatelské jméno | Vytahuje z `getInfo()` |
+| `getJidelna()` | Informace o jídelně 
+| `getHistorieKlienta(date)` | Historie objednávek za měsíc | `date` = první den měsíce (např. `2025-01-01`) |
+| `getPlaby()` | Pohyby na účtu
+| `getMessages()` | Zprávy pro uživatele 
+| `getProtokol()` | Vrátí protokol
+| `getVydej()` | Vrátí list vydaných jídel.
+| `postJidlo(veta, stav)` | Přihlásit/odhlásit jídlo | `stav`: 1 přihlásit, 0 odhlásit |
+| `postDen(datum, stav)` | Přihlásit/odhlásit celý den | `datum` ve formátu `YYYY-MM-DD` |
+| `postOrders()` | Uložit změny objednávek | Nutné po `postJidlo`/`postDen` |
+
+## Objednávky – správný postup
+Změny objednávek se ukládají ve dvou krocích:
+1. Provedení změn (`postJidlo` nebo `postDen`)
+2. Uložení (`postOrders`)
+
+```py
+cookie_data = api.postJidlo(5, 1)
+cookie_data = api.postOrders()
+```
+
+## Návratové hodnoty
+Většina metod vrací JSON string. Metody `postJidlo`, `postDen` a `postOrders` vrací dvojici `(cookie, data)` z POST odpovědi. 
+
+## Chyby a omezení
+- Error handling je dostupný přes výjimky, které lze importovat: `from strava_cz_api import StravaError`.
+- Při neúspěšném požadavku se vyhazuje `ConnectionError`.
+- Některé jídelny mohou vyžadovat úpravy payloadů nebo cookie.
+
+## Příklady
+Ukázkové skripty najdeš ve složce `./examples`.
+
+## Demo
+- Demo uživatele si lze vytvořit na https://www.strava.cz/strava/Stravnik/Demo
+- Poté se lze přihlásit na https://app.strava.cz/ na jídelně `0000`

strava_cz_api-2.1.2/strava_cz_api.egg-info/SOURCES.txt

@@ -0,0 +1,12 @@
+LICENSE
+README.md
+pyproject.toml
+examples/login.py
+examples/public_jidelnicek.py
+examples/user_info.py
+strava_cz_api/action.py
+strava_cz_api/strava.py
+strava_cz_api.egg-info/PKG-INFO
+strava_cz_api.egg-info/SOURCES.txt
+strava_cz_api.egg-info/dependency_links.txt
+strava_cz_api.egg-info/top_level.txt

strava_cz_api-2.1.2/strava_cz_api.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

strava_cz_api-2.1.2/strava_cz_api.egg-info/top_level.txt

@@ -0,0 +1,3 @@
+dist
+examples
+strava_cz_api