← Zpět na projekt

Správce osobních financí

Napíšeš si program, do kterého budeš zapisovat příjmy a výdaje. Ten ti řekne, kolik ti zbývá, za co utrácíš nejvíc a jestli držíš rozpočet. Všechno běží v terminálu a vystačíš si s tím, co umíš z lekcí 1 až 9.

Správce osobních financí

1 – výpis transakcí
2 – zůstatek
3 – přidat transakci
4 – odebrat transakci
5 – přehled měsíce
6 – rozpočty
7 – nastavit rozpočet
8 – graf výdajů
0 – konec
Co chceš udělat? 8
bydleni    ██████████████████████████████   28000 Kč
jidlo      ████████                          8260 Kč
doprava    █                                 1100 Kč
zabava     █                                 1310 Kč
ostatni    █                                 1290 Kč

Jak to bude probíhat

Projekt je rozdělený na kroky. Začneš malým programem, který umí dvě věci, a v každém kroku mu něco přidáš. Nemusíš stihnout všechno. Do kroku 3 by měla dojít každá, zbytek je navíc.

Krok Co přibude Co si zopakuješ
1 – Základ výpis transakcí, zůstatek, menu cykly, podmínky, funkce, čtení ze slovníku
2 – Přidání a odebrání nové transakce, kontrola vstupu seznamy, řetězce, while
3 – Přehledy výdaje podle kategorií, přehled měsíce slovníky, stavění seznamu
4 – Rozpočty limity a upozornění na překročení slovníky, skládání funkcí
5 – Grafy sloupcový graf ze znaků řetězce, max
6 – Uložení do souboru data přežijí ukončení programu nové: soubory a JSON
Bonusy barvy v terminálu, hledání, řazení, HTML report, čistá obrazovka podle chuti
Nápady na rozšíření další nápady bez řešení, třeba na doma podle chuti

Máš hotové kroky a zbývá čas? Vyber si, co tě láká. Bonusy na sebe nenavazují a pořadí je na tobě.

U každého platí totéž co u kroků: logiku piš jako funkci do finance.py, napiš k ní aspoň jeden test a teprve potom ji přidej do menu.

Každý krok má stejnou stavbu:

  1. Funkce. Co mají nové funkce v finance.py dělat.
  2. Testy. V krocích 1 až 3 a v kroku 6 je dostaneš hotové a zkopíruješ si je do test_finance.py. V krocích 4 a 5 je píšeš sama podle seznamu, co vyzkoušet. Testy budou červené, protože popisují funkce, které ještě nemáš. Funkce píšeš, dokud nezezelenají.
  3. Program. Hotové funkce nabídneš uživatelce v menu v app.py.
  4. Hotovo, když. Podle seznamu na konci poznáš, že je krok hotový.

Zadání říká, co má funkce dělat. Jak to udělá, je na tobě. Hotový kód v zadání nenajdeš, najdeš tam odkazy do taháků z lekcí.

Soubory

Soubor K čemu je
finance.py logika: funkce, které dostanou data a vrátí výsledek. Píšeš sem většinu kódu a tyhle funkce se testují.
app.py menu: while True, input() a print(). Volá funkce z finance.py. Tenhle soubor spouštíš.
test_finance.py testy. Hotové sem zkopíruješ, vlastní sem napíšeš.
ukazkova_data.py ukázkové transakce, kategorie a rozpočty, ať je od začátku s čím pracovat
finance.json stejné transakce uložené v souboru, budeš ho potřebovat až v kroku 6
TAHAK.md tahák k tomu, co je v projektu nové: import z finance.py, data pro testy, soubory a JSON
cviceni/ zadání kroků, jeden soubor na krok
napovedy/ nápověda ke kroku, soubor se jmenuje stejně jako krok
bonusy/ bonusy, jeden soubor na bonus
napady.md nápady na rozšíření bez řešení

Proč dva soubory s kódem? Funkce, která se ptá přes input() a odpovídá přes print(), se testovat nedá: test za tebe nic nenapíše na klávesnici a nepřečte si obrazovku. Funkci, která dostane data a výsledek vrátí, otestuješ na jednom řádku. Proto počítání bydlí ve finance.py a povídání s uživatelkou v app.py.

Jak vypadá test

def test_zustatek_bez_transakci():
    assert finance.zustatek([]) == 0

Test je funkce, jejíž jméno začíná test_. Slovo assert znamená „tvrdím, že“: nalevo je to, co funkce vrátila, napravo to, co vrátit měla. Když tvrzení platí, test je zelený. Když ne, je červený a v hlášce uvidíš, co funkce vrátila doopravdy.

Víc o testech je v lekci o testování, tahák najdeš v lekce-testovani/TAHAK.md.

Jak vypadají data

Jedna transakce je slovník. Všechny transakce jsou seznam slovníků.

transakce = [
    {"datum": "2026-11-01", "typ": "prijem", "castka": 32000, "kategorie": "vyplata", "popis": "výplata"},
    {"datum": "2026-11-02", "typ": "vydaj", "castka": 14000, "kategorie": "bydleni", "popis": "nájem"},
    {"datum": "2026-11-04", "typ": "vydaj", "castka": 1630, "kategorie": "jidlo", "popis": "velký nákup"},
]

Než začneš

  1. Měj připravený počítač podle návodu Před workshopem: fork, clone a nainstalovaný pytest. Když pytest chybí, napiš v terminálu ve VS Code pip install pytest, na Windows případně py -m pip install pytest.
  2. Ve VS Code měj otevřenou složku celého workshopu (File → Open Folder), ne jen složku projektu.
  3. Otevři panel Testing (ikona baňky vlevo). Rozbal projekt-finance a spusť jeho testy šipkou vedle názvu. V test_finance.py je jeden test a má být zelený. Když je, všechno funguje.
  4. Spusť app.py. Má vypsat, kolik transakcí načetl.
  5. Otevři krok 1.

Když se zasekneš

  1. Přečti si chybovou hlášku odspodu. Tahák L7, Jak číst chybovou hlášku.
  2. Otevři nápovědu ke kroku. Odkaz na ni je v zadání nad „Hotovo, když“, soubory jsou ve složce napovedy/. Nápověda tě pošle i do taháku.
  3. Zeptej se kolegyně ve dvojici nebo u stolu.
  4. Zavolej kouče.

Na konci dne

Ukážeš ostatním, co jsi postavila. Stačí ukázat přehled nebo graf ze svých dat a říct, co ti dalo nejvíc práce.

Zpět na workshop

Krok 1 – Základ: výpis a zůstatek

Na konci tohohle kroku bude tvůj program umět tohle:

Správce osobních financí

1 – výpis transakcí
2 – zůstatek
0 – konec
Co chceš udělat? 1
  1. 2026-10-01  + 32000 Kč  vyplata  výplata
  2. 2026-10-02  - 14000 Kč  bydleni  nájem
  3. 2026-10-05  -  1850 Kč  jidlo    velký nákup
  ...

1 – výpis transakcí
2 – zůstatek
0 – konec
Co chceš udělat? 2
Zůstatek: 25540 Kč

Nejdřív si otevři ukazkova_data.py a prohlédni si, jak data vypadají.

Funkce

Funkce píšeš do finance.py.

Funkce Co vrátí
soucet_prijmu(transakce) součet částek všech transakcí, které mají typ "prijem"
soucet_vydaju(transakce) součet částek všech transakcí, které mají typ "vydaj"
zustatek(transakce) příjmy mínus výdaje

Funkce nic nevypisují a na nic se neptají. Dostanou seznam transakcí a vrátí číslo. Ve funkci zustatek použij ty dvě předchozí.

Testy

Otevři test_finance.py a tyhle testy zkopíruj na jeho konec:

def test_soucet_prijmu():
    assert finance.soucet_prijmu(ukazka()) == 1000

def test_soucet_vydaju():
    assert finance.soucet_vydaju(ukazka()) == 900

def test_zustatek():
    assert finance.zustatek(ukazka()) == 100

def test_zustatek_bez_transakci():
    assert finance.zustatek([]) == 0

Spusť je v panelu Testing. Budou červené a v hlášce uvidíš AttributeError: module 'finance' has no attribute 'soucet_prijmu'. To je v pořádku: testy popisují funkce, které ještě neexistují. Tvůj úkol je napsat je tak, aby testy zezelenaly.

Spočítej si na papíře, proč má z dat ve funkci ukazka() vyjít zrovna 1000, 900 a 100. Uvidíš tak, co přesně testy kontrolují.

Po každé funkci pusť testy. Zelených bude přibývat.

Vlastní test: zůstatek může vyjít i záporný. Napiš test se seznamem, ve kterém je jediná transakce, a to výdaj. Seznam si napiš přímo v testu.

Program

Menu je v app.py.

Funkce máš, teď je potřeba je někomu nabídnout.

  1. Napiš funkci vypis(transakce), která vypíše každou transakci na jeden řádek: pořadové číslo od jedničky, datum, plus nebo mínus podle typu, částku, kategorii a popis. Sloupce zarovnej, ať je to čitelné. Když je seznam prázdný, vypiš o tom zprávu.
  2. Pod ni napiš nekonečný cyklus, který vypíše menu, zeptá se na volbu a podle ní zavolá vypis, vypíše zůstatek, nebo skončí.
  3. Když uživatelka napíše něco jiného než 1, 2 nebo 0, řekni jí to a menu ukaž znovu.

Funkce z finance.py si do app.py naimportuj stejně, jako importuješ z random:

from finance import zustatek
Zobrazit nápověduSkrýt nápovědu
  • Hodnotu ze slovníku čteš přes klíč: t["castka"]. Tahák L9, Záznamy a tabulky.
  • Sčítání v cyklu: začni nulou a v cyklu přičítej. Podmínka rozhodne, co se započítá.
  • V f-stringu se klíč píše do apostrofů: f"{t['datum']}". Tahák L9, Slovník.
  • Zarovnání na šířku: f"{cislo:3}", f"{text:10}". Tahák L6, Za dvojtečkou se říká, jak to má vypadat.
  • Pořadové číslo k položce: enumerate(seznam, start=1). Lekce 8.
  • Menu: while True, input, if/elif/else, break. Tahák L4, break – druhý východ z cyklu.

Hotovo, když


Zpět na projekt: Správce osobních financí · Další: Krok 2 – Přidání a odebrání transakce

Zadání na GitHubu

Krok 2 – Přidání a odebrání transakce

Program zatím jen čte. Teď ho naučíš transakce přidávat a odebírat. A hlavně: nesmí spadnout, ať uživatelka napíše cokoliv.

Co chceš udělat? 3
Datum (RRRR-MM-DD): 21.11.2026
Datum napiš jako RRRR-MM-DD, třeba 2026-11-21.
Datum (RRRR-MM-DD): 2026-11-21
Typ (prijem/vydaj): vydaj
Částka v Kč: stovka
Částka musí být celé kladné číslo.
Částka v Kč: 100
Kategorie (vyplata, bydleni, jidlo, doprava, zabava, ostatni): jidlo
Popis: káva a dort
Přidáno.

Funkce

Funkce píšeš do finance.py.

Funkce Co dělá
pridej_transakci(transakce, datum, typ, castka, kategorie, popis) poskládá z údajů slovník, přidá ho na konec seznamu a vrátí ho
odeber_transakci(transakce, cislo) odebere transakci s daným pořadovým číslem a vrátí ji; když taková není, vrátí None a seznam nechá být
je_platna_castka(text) vrátí True, když je text celé kladné číslo
je_platne_datum(text) vrátí True, když má text tvar RRRR-MM-DD, měsíc je 1 až 12 a den 1 až 31

Pořadové číslo je to z výpisu, takže první transakce má číslo 1, ne 0.

Poslední dvě funkce dostanou text z input() a jen řeknou, jestli je v pořádku. Na nic se neptají a nic nevypisují, takže se dají otestovat.

Testy

Zkopíruj na konec test_finance.py:

def test_pridej_transakci():
    transakce = ukazka()
    finance.pridej_transakci(transakce, "2026-11-10", "vydaj", 80, "jidlo", "káva")
    assert len(transakce) == 6
    assert transakce[5]["popis"] == "káva"
    assert transakce[5]["castka"] == 80

def test_pridany_prijem_zvedne_zustatek():
    transakce = ukazka()
    finance.pridej_transakci(transakce, "2026-11-10", "prijem", 500, "ostatni", "dárek")
    assert finance.zustatek(transakce) == 600

def test_odeber_transakci():
    transakce = ukazka()
    odebrana = finance.odeber_transakci(transakce, 1)
    assert odebrana["popis"] == "pizza"
    assert len(transakce) == 4

def test_odeber_transakci_ktera_neexistuje():
    transakce = ukazka()
    assert finance.odeber_transakci(transakce, 99) is None
    assert finance.odeber_transakci(transakce, 0) is None
    assert len(transakce) == 5

def test_je_platna_castka():
    assert finance.je_platna_castka("250")
    assert not finance.je_platna_castka("0")
    assert not finance.je_platna_castka("-50")
    assert not finance.je_platna_castka("12.5")
    assert not finance.je_platna_castka("stovka")
    assert not finance.je_platna_castka("")

def test_je_platne_datum():
    assert finance.je_platne_datum("2026-11-21")
    assert not finance.je_platne_datum("21.11.2026")
    assert not finance.je_platne_datum("2026-11-2")
    assert not finance.je_platne_datum("2026-13-01")
    assert not finance.je_platne_datum("2026-11-32")
    assert not finance.je_platne_datum("rok-11-21")
    assert not finance.je_platne_datum("")

assert bez == říká „tohle má být pravda“, assert not říká „tohle má být nepravda“.

Všimni si testu s číslem 0. Zkus si v hlavě, co by udělalo transakce.pop(0 - 1). Přesně na takové chyby testy jsou.

Vlastní test: přidej a hned odeber stejnou transakci. Co má platit o délce seznamu a o zůstatku?

Program

Menu je v app.py.

Přidej do menu volby 3 – přidat transakci a 4 – odebrat transakci.

Při přidávání se ptej tak dlouho, dokud nedostaneš platnou odpověď:

Každou odpověď nejdřív očisti: mezery na začátku a na konci pryč, typ a kategorii převeď na malá písmena. Uživatelka často napíše Jidlo nebo VYDAJ a myslí to dobře.

Ptaní se v cyklu budeš potřebovat několikrát. Udělej si na něj funkce, třeba zeptej_se_na_castku(), která vrátí až platné číslo.

Při odebírání nejdřív vypiš transakce, ať je vidět jejich čísla, a pak se zeptej na číslo. Když transakce s tím číslem není, nebo to vůbec není číslo, řekni to a nic neodebírej.

Zobrazit nápověduSkrýt nápovědu
  • Přidání na konec: append. Odebrání podle indexu: pop, vrací odebranou položku. Tahák L8, Metody, které seznam mění.
  • Funkce dostane ten samý seznam, ne kopii. Co do něj přidá, je vidět i venku. Tahák L8, Dvě jména, jeden seznam.
  • Jsou to samé číslice? text.isdigit(). Tahák L6, Metody řetězců.
  • Úklid odpovědi: input(...).strip() uřízne mezery na krajích, .lower() převede na malá písmena. Jde to i za sebou: .strip().lower(). Tahák L6, Metody řetězců.
  • Kousky textu: text[:4], text[5:7], jeden znak text[4]. Tahák L6, Výřez.
  • Ptaní se, dokud není odpověď dobrá: while True a return uvnitř funkce cyklus i funkci ukončí. Taháky L4 a L5.
  • Je hodnota mezi povolenými? in. Tahák L8, Procházení a hledání.
  • Seznam do jednoho textu: ", ".join(KATEGORIE). Tahák L8, Text a seznam.

Hotovo, když


Zpět na projekt: Správce osobních financí · Další: Krok 3 – Přehledy

Zadání na GitHubu

Krok 3 – Přehledy

Data už umíš zapisovat. Teď z nich program začne něco říkat: kolik jsi utratila za jídlo, jak dopadl listopad, co tě stálo nejvíc.

Co chceš udělat? 5
Měsíc (RRRR-MM): 2026-11
Příjmy:   33500 Kč
Výdaje:   20840 Kč
Rozdíl:   12660 Kč

Výdaje podle kategorií:
  bydleni     14000 Kč
  jidlo        4110 Kč
  doprava       550 Kč
  zabava        890 Kč
  ostatni      1290 Kč

Největší výdaj: nájem (14000 Kč)

Funkce

Funkce píšeš do finance.py.

Funkce Co vrátí
vydaje_podle_kategorie(transakce) slovník, kde klíč je kategorie a hodnota součet výdajů v ní; příjmy se nepočítají
transakce_za_mesic(transakce, mesic) nový seznam jen s transakcemi z daného měsíce; měsíc je text jako "2026-11"
nejvetsi_vydaj(transakce) transakci s nejvyšší částkou mezi výdaji; když žádný výdaj není, vrátí None

Funkce se dají skládat. Výdaje za listopad nepotřebují novou funkci:

listopad = transakce_za_mesic(transakce, "2026-11")
print(soucet_vydaju(listopad))

Testy

Zkopíruj na konec test_finance.py:

def test_vydaje_podle_kategorie():
    assert finance.vydaje_podle_kategorie(ukazka()) == {"jidlo": 750, "doprava": 150}

def test_vydaje_podle_kategorie_bez_transakci():
    assert finance.vydaje_podle_kategorie([]) == {}

def test_transakce_za_mesic():
    listopad = finance.transakce_za_mesic(ukazka(), "2026-11")
    assert len(listopad) == 4
    assert finance.soucet_vydaju(listopad) == 600

def test_transakce_za_mesic_nemeni_puvodni_seznam():
    transakce = ukazka()
    finance.transakce_za_mesic(transakce, "2026-11")
    assert len(transakce) == 5

def test_transakce_za_mesic_bez_transakci():
    assert finance.transakce_za_mesic(ukazka(), "2025-01") == []

def test_nejvetsi_vydaj():
    assert finance.nejvetsi_vydaj(ukazka())["popis"] == "pizza"

def test_nejvetsi_vydaj_bez_vydaju():
    assert finance.nejvetsi_vydaj([]) is None

Podívej se na test test_nejvetsi_vydaj. Největší částku v ukázce má brigáda za 1000, a přesto má vyjít pizza. Proč?

Vlastní test: zkontroluj, že vydaje_podle_kategorie z listopadových transakcí ukázky vrátí správný slovník. Nejdřív si ho spočítej ručně.

Program

Menu je v app.py.

Přidej volbu 5 – přehled měsíce. Zeptá se na měsíc a vypíše:

Když v měsíci žádné transakce nejsou, vypiš jen zprávu o tom.

Měsíc od uživatelky zkontroluj. Šikovný trik: měsíc 2026-11 je platný právě tehdy, když je platné datum 2026-11-01, a na to už funkci máš.

Zobrazit nápověduSkrýt nápovědu
  • Sčítání podle klíče je počítadlo, jen místo jedničky přičítáš částku. Tahák L9, Počítadlo.
  • Nový seznam z těch položek, které projdou podmínkou. Tahák L8, Stavění seznamu v cyklu.
  • Začíná text něčím? startswith. Tahák L6, Metody řetězců.
  • Hledání největšího: pamatuj si zatím nejlepšího a začni s None. Tahák L9, Kdo vyhrál.
  • Procházení slovníku po dvojicích: for klic, hodnota in slovnik.items(). Tahák L9, Procházení.

Hotovo, když


Zpět na projekt: Správce osobních financí · Další: Krok 4 – Rozpočty

Zadání na GitHubu

Krok 4 – Rozpočty

Rozpočet je částka, kterou chceš za měsíc v jedné kategorii nejvýš utratit. Program ti řekne, kolik ti z něj zbývá, a ozve se, když ho překročíš.

Co chceš udělat? 6
Měsíc (RRRR-MM): 2026-11
  jidlo        4110 /   4000 Kč   překročeno o 110 Kč
  doprava       550 /   1000 Kč   zbývá 450 Kč
  zabava        890 /   1500 Kč   zbývá 610 Kč
Překročené rozpočty: jidlo

Rozpočty jsou slovník rozpocty v souboru ukazkova_data.py: klíč je kategorie, hodnota je měsíční limit v korunách. Ne každá kategorie rozpočet má.

Funkce

Funkce píšeš do finance.py.

Funkce Co vrátí
zbyva_v_rozpoctu(transakce, rozpocty, kategorie) limit kategorie mínus výdaje v ní; po překročení vyjde záporné číslo; když kategorie rozpočet nemá, vrátí None
prekrocene_rozpocty(transakce, rozpocty) seznam kategorií, ve kterých se utratilo víc, než je limit

Funkce počítají se všemi transakcemi, které dostanou. Rozpočet je ale měsíční, takže jim budeš posílat jen transakce jednoho měsíce. Funkci, která je vybere, už máš z kroku 3.

Součet výdajů v kategorii taky nemusíš psát znovu.

Testy

Od tohohle kroku píšeš testy sama. Stavba je stejná jako u testů, které už máš: data z ukazka(), zavolání funkce a assert. Rozpočty si v každém testu připrav jako malý slovník, třeba:

rozpocty = {"jidlo": 1000, "doprava": 100}

V ukazka() se za jídlo utratilo 750 Kč a za dopravu 150 Kč. Na každý řádek tabulky napiš jeden test:

Co vyzkoušet Rozpočty Volání Má vrátit
kolik zbývá {"jidlo": 1000, "doprava": 100} zbyva_v_rozpoctu(ukazka(), rozpocty, "jidlo") 250
překročený rozpočet {"jidlo": 1000, "doprava": 100} zbyva_v_rozpoctu(ukazka(), rozpocty, "doprava") -50
kategorie bez výdajů {"zabava": 500} zbyva_v_rozpoctu(ukazka(), rozpocty, "zabava") 500
kategorie bez rozpočtu {"jidlo": 1000} zbyva_v_rozpoctu(ukazka(), rozpocty, "doprava") None
překročené rozpočty {"jidlo": 1000, "doprava": 100} prekrocene_rozpocty(ukazka(), rozpocty) ["doprava"]
utraceno přesně na korunu {"jidlo": 750} prekrocene_rozpocty(ukazka(), rozpocty) []
žádné rozpočty {} prekrocene_rozpocty(ukazka(), rozpocty) rozmysli sama

Na None se v testu ptej přes is None, viz tahák k testování, Tvary, se kterými si vystačíš.

Program

Menu je v app.py.

Přidej dvě volby:

A ještě jedna věc: když po přidání výdaje bude rozpočet jeho kategorie v tom měsíci překročený, program na to hned upozorní.

Přidáno.
Pozor, rozpočet na jidlo za 2026-11 je překročený o 210 Kč.

Měsíc transakce tvoří prvních sedm znaků jejího data.

Slovník rozpocty si do app.py naimportuj z ukazkova_data a funkcím, které ho potřebují, ho pošli jako argument.

Zobrazit nápověduSkrýt nápovědu
  • Je klíč ve slovníku? in. Čtení, které nespadne, když klíč chybí: get s výchozí hodnotou. Tahák L9, Když klíč chybí.
  • Přidání i přepsání hodnoty je stejný zápis: slovnik[klic] = hodnota. Tahák L9, Měnění.
  • Limit i kategorie najednou: for kategorie, limit in rozpocty.items(). Tahák L9, Procházení.
  • Prvních sedm znaků textu: text[:7]. Tahák L6, Výřez.

Hotovo, když


Zpět na projekt: Správce osobních financí · Další: Krok 5 – Grafy v terminálu

Zadání na GitHubu

Krok 5 – Grafy v terminálu

Čísla jsou přesná, ale obrázek je rychlejší. Graf nakreslíš ze znaků, žádnou knihovnu nepotřebuješ.

Co chceš udělat? 8
bydleni    ██████████████████████████████   28000 Kč
jidlo      ████████                          8260 Kč
doprava    █                                 1100 Kč
zabava     █                                 1310 Kč
ostatni    █                                 1290 Kč

Nejdelší sloupec patří nejvyšší částce a má pevnou šířku, tady 30 znaků. Ostatní jsou kratší ve stejném poměru.

Znak █ si zkopíruj odsud. Kdyby se ti v terminálu nezobrazil správně, použij #.

Funkce

Funkce píšeš do finance.py.

Funkce Co vrátí
sloupec(hodnota, nejvyssi, sirka) text ze znaků █, dlouhý podle toho, jak velká je hodnota proti nejvyssi; nejvyšší hodnota dostane sirka znaků

Dvě věci, na které musíš myslet ve funkci i v testech:

Testy

Testy zase píšeš sama, stejně jako v kroku 4. Výsledek si vždycky spočítej z hlavy, třeba "█" * 5. Co vyzkoušet:

Program

Menu je v app.py.

Přidej volbu 8 – graf výdajů. Pro každou kategorii vypíše její název, sloupec a částku. Nejvyšší částku, podle které se sloupce měří, zjisti z hodnot slovníku, který ti vrátí vydaje_podle_kategorie.

Když žádné výdaje nejsou, vypiš o tom zprávu.

Aby částky za sloupci stály pod sebou, zarovnej i sloupec na pevnou šířku.

Zobrazit nápověduSkrýt nápovědu
  • Opakování textu: "█" * 5. Lekce 1.
  • Dělení beze zbytku: //. Poměr spočítej tak, že nejdřív násobíš a až potom dělíš.
  • Největší z hodnot slovníku: max(slovnik.values()). Tahák L9, Procházení.
  • Zarovnání textu na šířku: f"{text:30}". Tahák L6, Za dvojtečkou se říká, jak to má vypadat.

Hotovo, když


Zpět na projekt: Správce osobních financí · Další: Krok 6 – Uložení do souboru

Zadání na GitHubu

Krok 6 – Uložení do souboru

Zatím program všechno zapomene, jakmile ho ukončíš. Přidaná transakce je při dalším spuštění pryč, protože data žijí jen v paměti. Teď je uložíš do souboru.

Tenhle krok používá dvě věci, které jsme na lekcích neprobírali: práci se soubory a formát JSON. Obojí najdeš vysvětlené v TAHAK.md v části Soubory a JSON. Přečti si ji, než začneš.

Ve složce projektu je připravený soubor finance.json. Otevři si ho. Jsou v něm stejné transakce jako v ukazkova_data.py a vypadají skoro stejně jako v Pythonu. JSON je způsob, jak seznamy a slovníky zapsat jako text.

Funkce

Funkce píšeš do finance.py.

Funkce Co dělá
uloz(transakce, cesta) zapíše seznam transakcí do souboru jako JSON
nacti(cesta) přečte soubor a vrátí seznam transakcí

Na začátek finance.py patří import json.

Testy

Tady testy zase dostaneš hotové. Pracují s dočasným souborem, a takový test se napřed těžko vymýšlí. Zkopíruj je na konec test_finance.py:

def test_uloz_a_nacti(tmp_path):
    cesta = tmp_path / "pokus.json"
    finance.uloz(ukazka(), cesta)
    assert finance.nacti(cesta) == ukazka()

def test_nacti_hacky_a_carky(tmp_path):
    cesta = tmp_path / "pokus.json"
    cesta.write_text('[{"popis": "žluťoučký koláč"}]', encoding="utf-8")
    assert finance.nacti(cesta) == [{"popis": "žluťoučký koláč"}]

def test_ulozeny_soubor_je_citelny(tmp_path):
    cesta = tmp_path / "pokus.json"
    finance.uloz([{"popis": "žluťoučký koláč"}], cesta)
    assert "žluťoučký koláč" in cesta.read_text(encoding="utf-8")

Parametr tmp_path je dočasná složka, kterou testu půjčí pytest a potom ji sám uklidí. Testy tak nesahají na tvůj opravdový finance.json. Lomítkem se k cestě složky připojí jméno souboru. write_text zapíše do souboru celý text najednou a read_text ho celý přečte. Ber to jako hotový recept.

Druhý a třetí test hlídají háčky a čárky. Soubor finance.json je uložený v kódování UTF-8, stejně jako ho zapíše uloz. Když open kódování nedostane, použije výchozí kódování počítače. Na Macu je to UTF-8, na Windows ne, a háčky a čárky se pak načtou rozbité.

Vlastní test: ulož prázdný seznam a zkontroluj, že se načte zase prázdný seznam.

Program

Uprav app.py.

Samotné jméno "finance.json" Python hledá ve složce, ze které program spouštíš, a to nemusí být složka projektu. Pak program hlásí FileNotFoundError, nebo si uloží nový soubor jinam. Proto cestu slož od složky, ve které leží app.py. Patří na začátek app.py:

from pathlib import Path

SOUBOR = Path(__file__).parent / "finance.json"

__file__ je cesta k souboru app.py, .parent je složka, ve které leží, a lomítko k ní připojí jméno souboru, stejně jako u tmp_path v testech. Ber to jako hotový recept. Wordle a Titanic to dělají stejně.

Vyzkoušej to: přidej transakci, ukonči program, spusť ho znovu a nech si vypsat transakce. Ta nová tam musí být.

Když si data pokazíš, původní finance.json si znovu stáhni z GitHubu, nebo si ho nech vyrobit: v Pythonu zavolej uloz se seznamem z ukazkova_data.py.

Zobrazit nápověduSkrýt nápovědu
  • Zápis a čtení souboru, json.dump a json.load. TAHAK.md, Soubory a JSON.
  • Nezapomeň na encoding="utf-8" při otevírání a ensure_ascii=False při zápisu. Bez encoding se na Windows háčky a čárky pokazí, to hlídají test_nacti_hacky_a_carky a test_ulozeny_soubor_je_citelny. Bez ensure_ascii=False se uloží jako nečitelné žluťoučký, to hlídá test_ulozeny_soubor_je_citelny.
  • FileNotFoundError, nebo se data ukládají jinam? Cestu skládej od složky programu: Path(__file__).parent / "finance.json". TAHAK.md, Soubory a JSON.

Hotovo, když


Zpět na projekt: Správce osobních financí · Další: Bonusy

Zadání na GitHubu

Bonusy

Bonusy jsou na později, když máš hotové kroky. Na sebe nenavazují.

Bonus 1 – Barvy v terminálu

Příjmy zeleně, výdaje červeně, upozornění žlutě. Program se hned líp čte.

Terminál text obarví, když před něj vypíšeš zvláštní kód. Kód je obyčejný řetězec. Začíná \033[. \033 je jeden neviditelný znak (Escape) zapsaný zpětným lomítkem, podobně jako \n, a za ním je obyčejná hranatá závorka.

print("\033[32m" + "Tohle je zeleně." + "\033[0m")
Kód Co dělá
"\033[31m" červená
"\033[32m" zelená
"\033[33m" žlutá
"\033[36m" tyrkysová
"\033[1m" tučné písmo
"\033[0m" konec: vrátí obyčejné písmo

Bez kódu pro konec by zůstalo obarvené i všechno, co vypíšeš potom.

Kódy si nikdo nepamatuje. Ulož je do slovníku BARVY, kde klíč je jméno barvy, a napiš do finance.py funkci obarvi(text, barva). Ta vrátí text, před kterým je kód barvy a za kterým je kód pro konec:

print(obarvi("Zůstatek: 25540 Kč", "zelena"))

Kde se barvy hodí:

Dvě věci, na které si dej pozor:

Testy: obarvený text začíná kódem barvy, končí kódem pro konec a obsahuje původní text. O kolik znaků je delší než původní?

Kdyby se ti místo barev vypisovaly znaky jako ←[32m, tvůj terminál barvy neumí. V terminálu ve VS Code fungují.

Bonus 2 – Hledání

Funkce najdi(transakce, text) vrátí seznam transakcí, které mají hledaný text v popisu. Na velikosti písmen nezáleží: "NÁKUP" najde "velký nákup".

Testy: hledání najde víc transakcí, nenajde nic, nezáleží na velikosti písmen.

Bonus 3 – Řazení podle částky

Funkce serazene_podle_castky(transakce) vrátí nový seznam transakcí seřazený od nejvyšší částky. Původní seznam nechá být.

Seznam slovníků metodou sort přímo neseřadíš. Seznam n-tic ano: n-tice se porovnávají podle první položky, a když se shodují, podle druhé. Postav tedy seznam dvojic (castka, index), seřaď ho a podle indexů poskládej výsledek.

Vyzkoušej, co se stane, když místo indexu dáš do dvojice rovnou slovník a dvě transakce mají stejnou částku.

Bonus 4 – HTML report

Hezčí přehled bez instalace knihoven: program vyrobí webovou stránku s přehledem a ty si ji otevřeš v prohlížeči.

Napiš funkci html_report(transakce), která vrátí text stránky v jazyce HTML. Stránka ukáže zůstatek, tabulku transakcí a sloupcový graf výdajů podle kategorií. V menu pak text zapiš do souboru report.html vedle app.py a otevři ho.

Kostra stránky, od které se můžeš odrazit:

<!DOCTYPE html>
<html lang="cs">
<head>
  <meta charset="utf-8">
  <title>Moje finance</title>
</head>
<body>
  <h1>Moje finance</h1>
  <p>Zůstatek: 25540 Kč</p>
  <table>
    <tr><th>Datum</th><th>Popis</th><th>Částka</th></tr>
    <tr><td>2026-11-02</td><td>nájem</td><td>-14000 Kč</td></tr>
  </table>
  <div style="background: teal; height: 20px; width: 300px"></div>
</body>
</html>

Test: text, který funkce vrátí, obsahuje <table> a popis některé transakce.

Bonus 5 – Čistá obrazovka

Menu v app.py se po každé volbě vypíše znovu pod předchozí výstup a starší výpisy ujíždějí nahoru. Na konci tohohle bonusu program před každým menu obrazovku smaže, takže je vidět jen menu a výsledek poslední volby.

Terminál smažeš takhle. Windows má na to příkaz cls, macOS a Linux příkaz clear:

import os


def vycisti_obrazovku():
    if os.name == "nt":
        os.system("cls")
    else:
        os.system("clear")

Funkci dej do app.py. Vypisuje, takže do finance.py nepatří.

  1. Na začátku každého průchodu hlavním cyklem obrazovku smaž.
  2. Narazíš na problém: výpis transakcí nebo graf se ukáže a hned zmizí, protože cyklus obrazovku smaže a vypíše menu. Vymysli, jak to vyřešit.
  3. Nad menu vypiš zůstatek, ať ho máš pořád na očích.

Zpět na projekt: Správce osobních financí · Další: Nápady na rozšíření

Bonusy na GitHubu

Nápady na rozšíření

Tady jsou nápady, co dalšího můžeš programu přidat, když máš hotové kroky i bonusy, nebo až budeš chtít pokračovat doma. Řešení k nim nejsou. Platí totéž co u kroků: logiku piš jako funkci do finance.py, napiš k ní aspoň jeden test a teprve potom ji přidej do menu.

Ke kroku 1 – Základ: výpis a zůstatek

Ke kroku 2 – Přidání a odebrání transakce

Ke kroku 3 – Přehledy

Ke kroku 4 – Rozpočty

Ke kroku 5 – Grafy v terminálu

Ke kroku 6 – Uložení do souboru

Větší nápady

Cíl spoření

Funkce mesicu_do_cile(usetreno, cil, mesicni_uspora) vrátí, za kolik měsíců naspoříš cílovou částku. Když je měsíční úspora nula nebo záporná, vrátí None, protože cíle nikdy nedosáhneš.

V menu se zeptej na cíl. Jako už naspořenou částku vezmi zůstatek. Měsíční úsporu spočítej jako průměrný rozdíl příjmů a výdajů za měsíce, které jsou v datech.

Opakující se platby

Nájem a lítačku platíš každý měsíc. Udělej si seznam pravidelných plateb a volbu „založit nový měsíc“, která je pro zadaný měsíc přidá všechny najednou. Hlídej, ať stejný měsíc nejde založit dvakrát.

Export do CSV

Funkce radek_csv(t) vrátí transakci jako jeden řádek textu s údaji oddělenými středníkem: 2026-11-02;vydaj;14000;bydleni;nájem. Všechny řádky zapiš do souboru finance.csv a otevři ho v Excelu.

Se soubory CSV budeme pracovat ve 13. lekci. Tohle je ochutnávka.

Krok zpět

Volba „vrátit poslední změnu“ vrátí seznam transakcí do stavu před posledním přidáním nebo odebráním. Před každou změnou si schovej kopii seznamu. Tahák L8, Dvě jména, jeden seznam.

Náhodná data

Funkce nahodne_transakce(pocet) vyrobí seznam náhodných transakcí: náhodný den, kategorii a částku. Hodí se na zkoušení přehledů a grafů s větším množstvím dat. randrange a choice znáš z random.

Jak otestuješ funkci, která pokaždé vrátí něco jiného? Zkontroluj to, co platit musí vždycky: počet, povolené kategorie, kladné částky.

Kategorie podle popisu

Slovník klíčových slov, třeba {"lidl": "jidlo", "lítačka": "doprava"}, a funkce odhadni_kategorii(popis, klicova_slova), která podle popisu navrhne kategorii. Když žádné slovo nenajde, vrátí "ostatni". Při přidávání transakce pak kategorii nabídni a nech ji potvrdit Enterem.

Porovnání měsíců

Funkce zmena_v_procentech(minule, ted) vrátí, o kolik procent se výdaje změnily proti minulému měsíci. Co má vrátit, když se minulý měsíc neutratilo nic? Rozhodni se a napiš na to test.


Zpět na projekt: Správce osobních financí