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:
- Funkce. Co mají nové funkce v
finance.py dělat.
- 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í.
- Program. Hotové funkce nabídneš uživatelce v menu v
app.py.
- 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"},
]
castka je v celých korunách a je vždycky kladná. Jestli jde o příjem,
nebo výdaj, říká typ.
datum je text ve tvaru RRRR-MM-DD. Takhle zapsaná data se dají
porovnávat a řadit jako obyčejný text.
- Typy a kategorie jsou bez háčků a čárek, ať se dobře píšou do
input().
Než začneš
- 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.
- Ve VS Code měj otevřenou složku celého workshopu (File → Open Folder),
ne jen složku projektu.
- 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.
- Spusť
app.py. Má vypsat, kolik transakcí načetl.
- Otevři krok 1.
Když se zasekneš
- Přečti si chybovou hlášku odspodu. Tahák L7, Jak číst chybovou hlášku.
- 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.
- Zeptej se kolegyně ve dvojici nebo u stolu.
- 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.
- 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.
- 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čí.
- 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ěď:
- datum zkontroluj funkcí
je_platne_datum,
- typ musí být
prijem, nebo vydaj,
- částku zkontroluj funkcí
je_platna_castka a převeď na číslo,
- kategorie musí být jedna z
KATEGORIE z ukazkova_data.py,
- popis nesmí být prázdný.
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:
- příjmy, výdaje a rozdíl za ten měsíc,
- výdaje podle kategorií,
- největší výdaj.
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:
6 – rozpočty se zeptá na měsíc a ke každé kategorii s rozpočtem vypíše,
kolik se utratilo, jaký je limit a kolik zbývá, nebo o kolik je překročený.
7 – nastavit rozpočet se zeptá na kategorii a částku a rozpočet uloží do
slovníku. Když kategorie rozpočet už má, přepíše ho.
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:
- Malá částka by po zaokrouhlení měla nula znaků a z grafu by zmizela.
Každá částka větší než nula má mít aspoň jeden znak.
- Když je
nejvyssi nula, nesmí funkce spadnout na dělení nulou.
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:
- nejvyšší hodnota má plnou šířku:
sloupec(100, 100, 10),
- poloviční hodnota má poloviční sloupec:
sloupec(50, 100, 10),
- nula dá prázdný text,
- malá hodnota je vidět:
sloupec(1, 1000, 10) má jeden znak,
- když je
nejvyssi nula, funkce nespadne a vrátí prázdný text,
- hodnota 75 ze 100 při šířce 20.
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.
- Transakce už neber z
ukazkova_data.py. Na začátku programu je načti
ze souboru finance.json.
- Po každém přidání a odebrání transakce seznam ulož.
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í:
- částky ve výpisu: příjmy zeleně, výdaje červeně,
- zůstatek: záporný červeně,
- hlášky o špatném vstupu žlutě,
- překročený rozpočet červeně, rozpočet v pořádku zeleně,
- sloupce grafu.
Dvě věci, na které si dej pozor:
- Zarovnání. Kódy barev nejsou vidět, ale jsou to znaky a
f"{text:10}"
je počítá do šířky. Text proto nejdřív zarovnej a až potom obarvi.
- Testy. Do funkce
sloupec barvu nedávej. Testy z kroku 5 čekají
přesný text bez barev. Obarvi až to, co funkce vrátí.
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>
- Řádky tabulky postav v cyklu do seznamu a spoj je přes
"\n".join(...).
- Sloupec grafu je
<div>, kterému nastavíš šířku v pixelech. Šířku
spočítej stejně jako délku sloupce v kroku 5.
- Cestu k souboru poskládej stejně jako v kroku 6:
cesta = Path(__file__).parent / "report.html".
- Zápis textu do souboru:
soubor.write(text) uvnitř with open(cesta, ...).
Viz TAHAK.md, Soubory a JSON.
- Otevření v prohlížeči:
import webbrowser a webbrowser.open(cesta.as_uri()).
as_uri() udělá z cesty adresu file:///…/report.html, které rozumí
prohlížeč na každém systému. Holé jméno souboru na Macu nemusí fungovat.
- Pozor na složené závorky. Když do f-stringu vložíš styly CSS, které je
používají, Python je bude brát jako místo pro hodnotu. Styly proto nech
v obyčejném řetězci a s f-stringem je spoj přes
+.
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ří.
- Na začátku každého průchodu hlavním cyklem obrazovku smaž.
- 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.
- 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
- Vypiš pod výpisem i součet příjmů a součet výdajů.
- Odděl v částkách ve výpisu tisíce mezerou:
32 000. Zvládneš to
s tím, co umíš z řetězců?
Ke kroku 2 – Přidání a odebrání transakce
je_platne_datum pustí i 31. únor. Dokážeš ji zpřísnit? Nejdřív na to napiš
test.
- Při zadávání data nabídni zkratku: prázdný Enter použije datum poslední
transakce.
- Před odebráním se zeptej „Opravdu odebrat? (ano/ne)“.
Ke kroku 3 – Přehledy
- Vypiš kategorie v přehledu od nejdražší po nejlevnější.
- Přidej funkci
prijmy_podle_kategorie. Všimni si, kolik kódu se opakuje.
Šla by z obou udělat jedna funkce s parametrem navíc?
- Přidej volbu, která vypíše přehled za všechny měsíce, které v datech jsou.
Ke kroku 4 – Rozpočty
- Upozorni už ve chvíli, kdy je vyčerpáno 80 % rozpočtu.
- Vypiš u každého rozpočtu, kolik procent je vyčerpáno.
- Přidej volbu, která rozpočet kategorie zruší.
Ke kroku 5 – Grafy v terminálu
- Zeptej se na měsíc a nakresli graf jen za něj.
- Nakresli graf výdajů po měsících: jeden sloupec na každý měsíc v datech.
- Seřaď sloupce od nejdelšího.
- Do přehledu rozpočtů z kroku 4 přidej ukazatel čerpání:
[██████░░░░] 60 %.
Ke kroku 6 – Uložení do souboru
- Ukládej i rozpočty. Do souboru může jít slovník se dvěma klíči:
{"transakce": [...], "rozpocty": {...}}. Tahák L9, Záznamy a tabulky.
- Přidej volbu „uložit zálohu“, která data zapíše do souboru, jehož jméno
si uživatelka zvolí.
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í