Soubory a JSON — ukládání hry

1.1 Proč to potřebujeme

Doteď se všechno ztratilo, jakmile jsi zavřel prohlížeč nebo restartoval program. session_state je paměť. Paměť se vypnutím vymaže. Když chceš, aby něco zůstalo napořád, musíš to napsat na disk.

Analogie, která funguje: paměť je tabule ve třídě, soubor je sešit. Tabuli po hodině smažete, sešit si odnesete domů.

1.2 Zápis do souboru

import streamlit as st

with open("hra.txt", "w", encoding="utf-8") as soubor:
    soubor.write("Arkon má 100 životů\n")

st.write("Soubor byl uložen.")

1.3 Režimy otevření

1.4 Čtení souboru

import streamlit as st

with open("hra.txt", "w", encoding="utf-8") as soubor:
    soubor.write("Arkon má 100 životů\nBela má 80 životů\n")

with open("hra.txt", "r", encoding="utf-8") as soubor:
    obsah = soubor.read()          # celý soubor jako jeden text

with open("hra.txt", "r", encoding="utf-8") as soubor:
    radky = soubor.readlines()     # seznam řádků

with open("hra.txt", "r", encoding="utf-8") as soubor:
    for radek in soubor:           # po řádcích, šetří paměť
        st.write(radek.strip())

1.5 Ošetření chyby, když soubor není

import os
import streamlit as st

if os.path.exists("hra.txt"):
    with open("hra.txt", encoding="utf-8") as f:
        obsah = f.read()
    st.write(obsah)
else:
    st.warning("Soubor zatím neexistuje.")

import streamlit as st

try:
    with open("hra.txt", encoding="utf-8") as f:
        obsah = f.read()
except FileNotFoundError:
    obsah = ""
    st.warning("Soubor neexistuje, začínáme od nuly.")

st.write(obsah)

1.6 Proč nestačí obyčejný text

Podívej se na problém:

import streamlit as st

hrdina = {"jmeno": "Arkon", "zivoty": 100}
with open("hra.txt", "w", encoding="utf-8") as soubor:
    soubor.write(str(hrdina))    # zapíše: {'jmeno': 'Arkon', 'zivoty': 100}

st.write(str(hrdina))

1.7 JSON — formát pro data

1.8 Uložení a načtení celé hry

import json
import streamlit as st

def uloz(hrdina, cesta="ulozeno.json"):
    with open(cesta, "w", encoding="utf-8") as f:
        json.dump(hrdina, f, ensure_ascii=False, indent=2)


def nacti(cesta="ulozeno.json"):
    try:
        with open(cesta, encoding="utf-8") as f:
            return json.load(f)
    except FileNotFoundError:
        return None

uloz({"jmeno": "Arkon", "zivoty": 100})
st.write(nacti())

1.9 Streamlit: stahování a nahrávání

Toto je pro webovou aplikaci důležitější než zápis na disk serveru:

1.10 Co jde a nejde do JSON

Když to nejde uložit, převeď to na něco, co jde. Množinu na seznam, datum na text.

Zadání:

1. Přidej st.text_input na zápis události
2. Tlačítkem zapiš text do souboru denik.txt v režimu "a"
3. Nezapomeň na encoding="utf-8" a odřádkování \n
4. Načti a zobraz celý soubor pod formulářem
5. Přidej tlačítko, které soubor smaže pomocí os.remove

Očekávaný výsledek: deník, který přežije restart aplikace.

Zadání:

1. Vytvoř soubor skore.json, ve kterém bude seznam slovníků {"jmeno": ..., "body": ...}
2. Přidej formulář na zadání jména a bodů
3. Po odeslání načti stávající skóre, přidej nové a ulož zpátky
4. Seřaď tabulku podle bodů sestupně a zobraz nejlepších pět
5. Ošetři případ, kdy soubor ještě neexistuje

Očekávaný výsledek: žebříček, který se hromadí mezi spuštěními.

Zadání:

1. Vytvoř formulář na postavu (jméno, povolání, statistiky, inventář)
2. Poskládej z toho slovník a zobraz ho přes st.json
3. Převeď slovník na text pomocí json.dumps(..., ensure_ascii=False, indent=2)
4. Přidej st.download_button na stažení souboru .json
5. Přidej st.file_uploader na načtení postavy zpět

Očekávaný výsledek: postava se dá stáhnout a v jiné záložce zase načíst.

Zadání:

1. Vytvoř v kódu seznam příšer a ulož ho do bestiar.json
2. Načti ho zpátky a zobraz jako st.dataframe
3. Přidej formulář na přidání nové příšery a ulož po každém přidání
4. Přidej možnost příšeru smazat podle jména
5. Ošetři situace, kdy je soubor prázdný nebo poškozený

Očekávaný výsledek: bestiář, který si pamatuje přidané příšery.

Zadání:

1. Napiš funkci uloz_hru() vracející JSON text celého stavu hry
2. Napiš funkci nacti_hru(data), která stav obnoví do session_state
3. Přidej do postranního panelu st.download_button na uložení
4. Přidej st.file_uploader a tlačítko „Načíst hru"
5. Uložený stav musí obsahovat hrdinu, inventář, deník i počet výprav

Očekávaný výsledek: hra se dá uložit, zavřít prohlížeč a pokračovat později.

Uprav ukládání tak, aby si hra pamatovala datum a čas uložení. Použij from datetime import datetime a datetime.now().isoformat(). Při načtení zobraz, jak stará uložená pozice je.

Oficiální dokumentace se hodí, když si chceš ověřit, jak se správně otevírá soubor, co dělají režimy r / w / a, nebo jak Python převádí slovníky a seznamy do JSONu. Je v angličtině, ale dobře se v ní hledá podle názvu funkce a krátkých příkladů.