Credentials

Samotné tokeny i s username i user_id lze spravovat přes proměnou Bakalari.credentials

Heslo se do kešovacího souboru neukládá, není dostupné ani v proměnné credentials

Pojďme se kouknout na třídu Credentials, která se nachází v async_bakalari_api.datastructure

class Credentials

    @dataclass
    class Credentials:
        """Credentials holder."""

        username: str = None
        access_token: str = None
        refresh_token: str = None
        user_id: str = None

        @classmethod
        def create(cls, data: dict[str, Any]) -> Credentials:
            ...

        @classmethod
        def create_from_json(cls, data: dict[str, Any]) -> Credentials:
            """Return class object from JSON dictionary."""
            ...

Přistupovat k aktuálním datům lze z instance Bakalari

    username = Bakalari.credentials.name
    access_token = Bakalari.credentials.access_token
    refresh_toke = Bakalari.credentials.refres_token
    user_id = Bakalari.credentials.user_id

Zapsání nových údajů lze přímo, je ale vhodnější využít metodu create nebo create_from_json(). Přičemž create_from_json() je preferovanější.

U metody create() se předpokládá datové pole takové, které zasílá přímo server:

create()create_from_json()

    from async_bakalari_api.datastructure import Credentials
    from async_bakalari_api import Bakalari

    bakalari = Bakalari()

    nove_udaje = {
        "bak:UserID": "user_id",
        "access_token": "nový access_token"
        "refresh_token": "nový refresh_token",
        "username": "nové username"
    }

    bakalari.credentials = Credentials.create(nove_udaje)

    from async_bakalari_api.datastructure import Credentials
    from async_bakalari_api import Bakalari

    bakalari = Bakalari()

    nove_udaje = {
        "user_id": "nové user_id
        "access_token": "nový access_token"
        "refresh_token": "nový refresh_token",
        "username": "nové username"
    }

    bakalari.credentials = Credentials.create_from_json(nove_udaje)

Nahrání uložených údajů

Jak již bylo řečeno, Bakalari umožňují automatické ukládání Credentials do souboru ve formátu json

Jejich získání zpět je možné pomocí metody load_credentials

load_credentials(self, filename: str) -> Credentials | bool

Jako argument se zadává jméno souboru. Vrací Credentials, které také hned ukládá do Bakalari.credentials

Při neúspěchu vrací False

Po zvolání metody load_credentials máme tedy v instanci bakalari aktuální údaje a lze je využít rovnou při přihlášení.

    from async_bakalari_api.datastructure import Schools
    from async_bakalari_api import Bakalari

    school: Schools = await Schools().load_from_file("schools_data.json")
    bakalari = Bakalari(
        server=school.get_url("část jména školy"), 
        auto_cache_credentials=True,
        cache_file="credetials.json"
    )
    bakalari.load_credentials("credentials.json")

    ... nyní již můžeme provádět autorizované dotazy na server školy