Moduly
Vestavěné moduly, instalace knihoven přes pip a vlastní moduly.
Výklad a cvičení
Výklad si můžeš přečíst přímo na webu. Příklady procházej po pořadí a kód si zkoušej ve VS Code.
Vestavěné moduly, instalace knihoven přes pip a vlastní moduly.
Výklad si můžeš přečíst přímo na webu. Příklady procházej po pořadí a kód si zkoušej ve VS Code.
Procházej příklady postupně, pak si vyzkoušej cvičení. Kód z bloků si můžeš zkopírovat do Python souboru ve VS Code a spustit. Příklady na jedné stránce na sebe mohou navazovat.
Spusť soubor víckrát – pokaždé padne něco jiného.
Tenhle řádek znáš od lekce o cyklu while:
from random import randrange
Čte se zprava doleva: „z modulu random si vezmi funkci randrange“.
Modul je obyčejný soubor s Pythonem, ve kterém jsou připravené funkce. Modul random napsal někdo jiný a Python ho má s sebou. Ty si z něj jen řekneš o to, co potřebuješ.
hod = randrange(1, 7)
print("Na kostce padlo:", hod)
Bez řádku s importem by Python randrange neznal a spadl by:
NameError: name 'randrange' is not defined
Import proto patří na začátek souboru, ještě před první použití.
Z jednoho modulu si můžeš vzít víc funkcí najednou, oddělíš je čárkou. Funkce choice vybere náhodnou položku ze seznamu:
from random import choice, shuffle
dezerty = ["dort", "palačinky", "zmrzlina", "jablko"]
print("Dnes bude:", choice(dezerty))
shuffle seznam zamíchá – jako balíček karet:
shuffle(dezerty)
print("Pořadí ochutnávky:", dezerty)
Všechny importy se podle zvyklostí píšou nahoru, každý na svůj řádek. Tady jsou rozházené jen proto, aby byly vedle ukázky.
Zpět na téma: Vestavěné moduly · Další: Import celého modulu
Spusť soubor a porovnej oba zápisy.
Import jde napsat i druhým způsobem. Místo jedné funkce si přineseš celý modul a funkce z něj voláš přes tečku:
import random
hod = random.randrange(1, 7)
print("Na kostce padlo:", hod)
print("Dnes bude:", random.choice(["dort", "palačinky", "zmrzlina"]))
random.randrange čti jako „funkce randrange z modulu random“. Je to stejná funkce jako minule, jen napsaná i s adresou.
from random import randrange → randrange(1, 7)
import random → random.randrange(1, 7)
Oba zápisy dělají totéž. Kterým zápisem začít: from ... import když z modulu potřebuješ jednu nebo dvě funkce import ... když jich potřebuješ víc, nebo chceš, aby bylo na první pohled vidět, odkud funkce je
Modul nemusí mít jen funkce. Modul math má i hotové hodnoty:
import math
print("Odmocnina z 196 je", math.sqrt(196))
print("Pí je", math.pi)
polomer = 3
print("Pizza o poloměru 3 má plochu", round(math.pi * polomer ** 2, 1))
Pozor, jméno funkce samo nestačí. Takhle to nefunguje:
import math
print(sqrt(16)) NameError: name 'sqrt' is not defined
Při „import math“ zná Python jen jméno math. K funkci se dostaneš přes math.sqrt.
Zpět na téma: Vestavěné moduly · Další: Co všechno Python umí sám
Spusť soubor. Na konci chvilku počká – to je schválně.
Modulům, které má Python s sebou, se říká standardní knihovna. Nic se neinstaluje, stačí je importovat. Pár užitečných na ukázku:
statistics – průměr, medián a další výpočty nad seznamem čísel
from statistics import mean, median
body = [7, 9, 4, 10, 8]
print("Průměr:", mean(body))
print("Medián:", median(body))
datetime – datum a čas
from datetime import date
dnes = date.today()
print("Dnes je", dnes)
print("Rok:", dnes.year)
time – například sleep, které program na chvilku uspí
from time import sleep
for cislo in range(3, 0, -1):
print(cislo)
sleep(1) # počkej jednu sekundu
print("Start!")
Seznam všech modulů standardní knihovny je v dokumentaci: https://docs.python.org/3/library/
Nemusíš je znát nazpaměť. Když něco potřebuješ, vyplatí se nejdřív zkusit vyhledat „python jak …“ – často už to v nějakém modulu je.
Zpět na téma: Vestavěné moduly · Další: Cvičení: Vestavěné moduly
Každé cvičení má vlastní soubor ve složce lekce-moduly/01_vestavene_moduly/cviceni/. Otevři ho ve VS Code, doplň kód pod zadání a soubor spusť (Run). Řešení si rozklikni až po vlastním pokusu – tvoje řešení může vypadat jinak, a to je v pořádku.
Soubor: cviceni/01_dve_kostky.py
Hoď dvěma kostkami (každá má čísla 1 až 6) a vypiš obě čísla i jejich součet. Použij randrange z modulu random. Ukázka výstupu:
Padlo 3 a 5, dohromady 8.
from random import randrange
prvni = randrange(1, 7)
druha = randrange(1, 7)
print(f"Padlo {prvni} a {druha}, dohromady {prvni + druha}.")
Soubor: cviceni/02_kdo_myje_nadobi.py
Máš seznam lidí z bytu. Vylosuj, kdo dnes myje nádobí, a vypiš to. Pomůže ti funkce choice z modulu random.
lide = ["Anna", "Petra", "Jana", "Eva"]
from random import choice
lide = ["Anna", "Petra", "Jana", "Eva"]
print(f"Nádobí dnes myje {choice(lide)}.")
Soubor: cviceni/03_kruh.py
Zeptej se na poloměr kruhu a vypiš jeho obvod (2 · pí · r) a obsah (pí · r · r), oba zaokrouhlené na dvě desetinná místa. Tentokrát použij zápis import math a pí z modulu math.
import math
polomer = float(input("Poloměr kruhu: "))
obvod = 2 * math.pi * polomer
obsah = math.pi * polomer ** 2
print("Obvod:", round(obvod, 2))
print("Obsah:", round(obsah, 2))
Soubor: cviceni/04_odpocet.py
Zeptej se, od kolika se má odpočítávat. Pak vypisuj čísla dolů až k jedničce, mezi každými dvěma počkej sekundu, a nakonec vypiš „Šťastný nový rok!“. Na čekání použij sleep z modulu time.
from time import sleep
od = int(input("Od kolika odpočítávat? "))
for cislo in range(od, 0, -1):
print(cislo)
sleep(1)
print("Šťastný nový rok!")
Zpět na téma: Vestavěné moduly · Další: Bonusová cvičení: Vestavěné moduly
Bonusy jsou pro rychlíky – když máš hotová cvičení a zbývá čas. Každý bonus má vlastní soubor ve složce lekce-moduly/01_vestavene_moduly/cviceni_bonusy/. Řešení si rozklikni až po vlastním pokusu – tvoje řešení může vypadat jinak, a to je v pořádku.
Soubor: cviceni_bonusy/01_do_vanoc.py
Vypiš, kolik dní zbývá do Štědrého dne. Pomůže ti date z modulu datetime: date(2026, 12, 24) vytvoří datum 24. 12. 2026 date.today() je dnešní datum Dvě data jde od sebe odečíst. Výsledek má hodnotu .days, ve které je počet dní.
from datetime import date
vanoce = date(2026, 12, 24)
zbyva = vanoce - date.today()
print(f"Do Štědrého dne zbývá {zbyva.days} dní.")
Soubor: cviceni_bonusy/02_nahodne_heslo.py
Vyrob náhodné heslo o 12 znacích z písmen a číslic v řetězci znaky. V cyklu přidávej po jednom znaku, který vybereš funkcí choice – ta umí vybírat i z řetězce.
znaky = "abcdefghijkmnopqrstuvwxyzABCDEFGHJKLMNPQRSTUVWXYZ23456789"
from random import choice
znaky = "abcdefghijkmnopqrstuvwxyzABCDEFGHJKLMNPQRSTUVWXYZ23456789"
heslo = ""
for poradi in range(12):
heslo = heslo + choice(znaky)
print("Tvoje nové heslo:", heslo)
Procházej příklady postupně, pak si vyzkoušej cvičení. Kód z bloků si můžeš zkopírovat do Python souboru ve VS Code a spustit. Příklady na jedné stránce na sebe mohou navazovat.
Pomocné soubory, které ukázky a cvičení potřebují:
Spusť soubor. Když sis doma podle návodu Před workshopem nainstalovala knihovny, promluví kráva. Když ne, program spadne – návod je níž.
Standardní knihovna je jen začátek. Další tisíce modulů napsali lidé z celého světa a dali je zdarma k dispozici na webu PyPI: https://pypi.org
Takovým modulům se říká knihovny nebo balíčky. Python je s sebou nemá, musíš si je nejdřív nainstalovat. K tomu slouží program pip.
Na ukázku si vezmeme knihovnu cowsay. Kráva v ní umí mluvit.
import cowsay
cowsay.cow("Bú! Knihovna funguje.")
Pokud soubor spadl s hláškou
ModuleNotFoundError: No module named 'cowsay'
Python modul cowsay nenašel. Ve standardní knihovně není, takže ho nainstaluj:
Ve VS Code otevři terminál: v horním menu Terminal → New Terminal. Dole se otevře okno, kam se píšou příkazy.
Napiš do něj příkaz a potvrď Enterem:
pip install cowsay
Na Windows případně: py -m pip install cowsay Na macOS případně: python3 -m pip install cowsay
Na konci výpisu by mělo být: Successfully installed cowsay-…
Spusť tenhle soubor znovu. Kráva by měla promluvit.
Pokud to nejde ani tak, zavolej kouče. Na každém počítači to může zlobit trochu jinak.
Instaluje se jednou na počítač, ne do každého souboru. Import pak píšeš do každého souboru, kde knihovnu používáš – stejně jako u random.
Zpět na téma: Instalace knihoven · Další: Jak zjistit, co knihovna umí
Spusť soubor. Potřebuje nainstalovaný cowsay z minulého souboru.
Každá knihovna má na PyPI stránku s popisem a ukázkami: https://pypi.org/project/cowsay/
Tam se dočteš, že kromě krávy umí mluvit i další postavičky. Jejich jména jsou v seznamu cowsay.char_names:
import cowsay
print(cowsay.char_names)
Každá postavička má svoji funkci, která se jmenuje stejně:
cowsay.tux("Ahoj, já jsem tučňák Tux.")
cowsay.trex("A já dinosaurus.")
Knihovna je tedy pořád jen modul s funkcemi. Od random se liší jen tím, že ji napsal někdo jiný než autoři Pythonu a musíš si ji nainstalovat.
Postup s jakoukoli novou knihovnou:
najdi ji (vyhledávač, PyPI, doporučení kouče),
nainstaluj: pip install jmeno_knihovny,
přečti si ukázky na její stránce,
importuj a použij.
Zpět na téma: Instalace knihoven · Další: Pytest: knihovna na testování
Tenhle soubor se nespouští. Čti ho a dělej, co se v něm píše.
V projektech dnes budeš psát testy – kousky kódu, které samy zkontrolují, že tvoje funkce počítají správně. Spouští je knihovna pytest. Je to knihovna z PyPI, stejně jako cowsay, a nainstalovala sis ji doma podle návodu Před workshopem. Kdyby chyběla, nainstaluj ji stejně jako cowsay:
pip install pytest
Pytest je jiný než random nebo cowsay. Funkce z něj do svých programů skoro nikdy nevoláš. Pytest sám projde soubory, jejichž jméno začíná na test_, najde v nich funkce začínající na test_ a spustí je.
Vedle tohohle souboru je jeden takový: test_pytest_funguje.py. Podívej se do něj a pak ho spusť:
Vlevo v liště klikni na ikonu baňky (Testing). Pokud tam nic není, klikni na Configure Python Tests a vyber pytest.
Najdi test_pytest_funguje a klikni na šipku vedle něj. Když svítí zeleně, pytest funguje a můžeš se pustit do testů.
Bez VS Code jde totéž spustit v terminálu:
python -m pytest
Na konci výpisu uvidíš, kolik testů prošlo (passed).
Jak testy psát, se naučíš v lekci o testování, která následuje po modulech. Teď stačí, že pytest běží.
Zpět na téma: Instalace knihoven · Další: Cvičení: Instalace knihoven
Každé cvičení má vlastní soubor ve složce lekce-moduly/02_instalace_knihoven/cviceni/. Otevři ho ve VS Code, doplň kód pod zadání a soubor spusť (Run). Řešení si rozklikni až po vlastním pokusu – tvoje řešení může vypadat jinak, a to je v pořádku.
Soubor: cviceni/01_mluvici_postavicka.py
Zeptej se uživatelky, co má postavička říct a která to má být (třeba cow, tux nebo dragon). Pak ji nech promluvit.
cowsay.draw(text, cowsay.CHARS[jmeno]) nechá mluvit postavičku podle jména. Seznam jmen je v cowsay.char_names. Když jméno v seznamu není, vypiš, ze kterých jde vybírat.
import cowsay
text = input("Co má postavička říct? ")
jmeno = input("Která postavička? ").strip().lower()
if jmeno in cowsay.char_names:
cowsay.draw(text, cowsay.CHARS[jmeno])
else:
print("Takovou neznám. Vyber si z:", ", ".join(cowsay.char_names))
Zpět na téma: Instalace knihoven · Další: Bonusová cvičení: Instalace knihoven
Bonusy jsou pro rychlíky – když máš hotová cvičení a zbývá čas. Každý bonus má vlastní soubor ve složce lekce-moduly/02_instalace_knihoven/cviceni_bonusy/. Řešení si rozklikni až po vlastním pokusu – tvoje řešení může vypadat jinak, a to je v pořádku.
Soubor: cviceni_bonusy/01_velky_napis.py
Knihovnu pyfiglet sis nainstalovala doma, když ne, nainstaluj ji stejně jako cowsay. Na stránce https://pypi.org/project/pyfiglet/ najdi, jak se vyrábí velký nápis, a vypiš jím svoje jméno.
Nápis piš bez háčků a čárek, písma v pyfiglet je neznají.
V terminálu nejdřív: pip install pyfiglet
import pyfiglet
print(pyfiglet.figlet_format("Anna"))
Soubor: cviceni_bonusy/02_jine_pismo.py
pyfiglet.figlet_format umí i jiná písma, jejich jména vrátí pyfiglet.FigletFont.getFonts(). Zeptej se na text a vypiš ho třemi náhodně vybranými písmy. Nad každý nápis napiš jméno písma, ať víš, které se ti líbí.
Písmo se vybírá takhle: pyfiglet.figlet_format(text, font="slant")
from random import choice
import pyfiglet
text = input("Text: ")
pisma = pyfiglet.FigletFont.getFonts()
for poradi in range(3):
pismo = choice(pisma)
print(f"--- {pismo} ---")
print(pyfiglet.figlet_format(text, font=pismo))
Procházej příklady postupně, pak si vyzkoušej cvičení. Kód z bloků si můžeš zkopírovat do Python souboru ve VS Code a spustit. Příklady na jedné stránce na sebe mohou navazovat.
Pomocné soubory, které ukázky a cvičení potřebují:
Spusť soubor a pak otevři prevody.py, který leží vedle něj.
Funkce sis začala psát, aby se kód neopakoval a dal se pojmenovat. Dlouhý program se tak rozpadl na menší kousky, z nichž každý dělá jednu věc.
Moduly jsou o patro výš. Když je funkcí hodně, soubor se prodlužuje a hledá se v něm čím dál hůř. Funkce, které k sobě patří, proto přesuneš do vlastního souboru – modulu – a pojmenuješ ho:
funkce = pojmenovaný kus kódu (def na_celsia ...)
modul = pojmenovaný soubor funkcí (prevody.py)
Žádné nové kouzlo to není. Modul random, který používáš od začátku, je taky jen soubor random.py s funkcemi. Leží někde v instalaci Pythonu, zatímco ten tvůj leží ve stejné složce jako tvůj program.
import prevody
print("Venku je 30 °C, to je", prevody.na_fahrenheity(30), "°F.")
print("Maraton má 26,2 mil, to je", prevody.mile_na_km(26.2), "km.")
Řádek import prevody udělá to samé co import random: najde soubor prevody.py a zpřístupní jeho funkce přes tečku.
K čemu je to dobré:
Program je kratší a čte se líp. Kdo chce vědět, jak se převádí, podívá se do prevody.py. Kdo chce vědět, co program dělá, čte tenhle.
Stejné funkce můžeš použít ve víc programech, nemusíš je kopírovat.
Funkce v modulu jde otestovat. Test si ji naimportuje stejně jako tenhle soubor. Ukázku uvidíš na konci téhle části, psát testy se naučíš v lekci o testování.
Zpět na téma: Vlastní moduly · Další: Jak importovat vlastní soubor
Spusť soubor.
U vlastního modulu fungují oba zápisy, které znáš z random:
from prevody import na_celsia
print("100 °F je", round(na_celsia(100), 1), "°C.")
import prevody
print("0 °C je", prevody.na_fahrenheity(0), "°F.")
Kdy import vlastního souboru funguje:
Soubor leží ve stejné složce jako program, který ho importuje.
V importu píšeš jméno bez .py: import prevody (ne prevody.py)
Jméno souboru je platné jméno v Pythonu: malá písmena, číslice a podtržítka, nezačíná číslicí, žádné mezery, pomlčky ani háčky. prevody.py, moje_funkce.py ✓ 01_prevody.py ✗ začíná číslicí moje-funkce.py ✗ pomlčka
Proto se soubory s výkladem jmenují 01_…, 02_… (ty jen spouštíš) a modul se jmenuje prevody.py (ten se importuje).
Pozor na jméno, které už má jiný modul! Kdybys svůj soubor pojmenovala random.py, Python by při import random našel ten tvůj a skutečný random by se schoval. Program pak spadne s hláškou jako:
AttributeError: module 'random' has no attribute 'randrange'
Stejně tak nikdy nepojmenuj soubor pytest.py nebo cowsay.py.
Zpět na téma: Vlastní moduly · Další: Import spustí celý soubor
Spusť soubor a sleduj, co se vypíše jako první.
print("Začátek programu")
from upovidany import pozdrav
print(pozdrav("Petro"))
Vypsalo se i něco, co v tomhle souboru vůbec není. Otevři upovidany.py.
Při importu Python soubor modulu celý spustí, řádek po řádku: def ... funkci si jen zapamatuje, nic se nevypíše
print(...) mimo funkci se opravdu provede
Kdyby v modulu byl input(), program by se při importu nečekaně zeptal na odpověď. Testy, které budeš psát v lekci o testování, by se na něm zasekly a čekaly by navždy.
Proto pravidlo, které platí i v projektech:
V modulu jsou jen funkce. Všechno, co se má opravdu provést (input, print, volání funkcí), patří do programu, který spouštíš.
Zpět na téma: Vlastní moduly · Další: Program, logika a testy
Spusť soubor a zkus převést pár teplot.
Tohle je ten soubor, který spouštíš. Je v něm všechno, co mluví s uživatelkou: input a print. Počítání si půjčuje z prevody.py.
from prevody import na_celsia, na_fahrenheity
print("Převodník teplot")
smer = input("Převést na C, nebo na F? ").strip().upper()
hodnota = float(input("Teplota: "))
if smer == "F":
print(f"{hodnota} °C je {round(na_fahrenheity(hodnota), 1)} °F.")
elif smer == "C":
print(f"{hodnota} °F je {round(na_celsia(hodnota), 1)} °C.")
else:
print("Napiš C, nebo F.")
Ve složce teď leží tři druhy souborů:
prevody.py logika funkce, které počítají a vrací výsledek 04_program_a_logika.py program input, print, spouští se tlačítkem Run test_prevody.py testy kontrolují funkce z prevody.py
Otevři test_prevody.py. Jak se testy píšou, se naučíš v další lekci. Teď si všimni jen toho, že si testy modul importují úplně stejně jako tenhle program – import prevody. Program s input() otestovat nejde, test by čekal na odpověď. Funkci, která jen vrátí číslo, ano.
Stejně jsou rozdělené i projekty, na kterých dnes budeš pracovat. Ve financích je to finance.py (logika), app.py (program) a test_finance.py (testy).
Zpět na téma: Vlastní moduly · Další: Cvičení: Vlastní moduly
Každé cvičení má vlastní soubor ve složce lekce-moduly/03_vlastni_moduly/cviceni/. Otevři ho ve VS Code, doplň kód pod zadání a soubor spusť (Run). Řešení si rozklikni až po vlastním pokusu – tvoje řešení může vypadat jinak, a to je v pořádku.
Soubor: cviceni/01_rozdel_program.py
Uprav kód podle zadání a soubor spusť (Run).
Program níž počítá spropitné. Funguje, ale logika a program jsou v jednom souboru. Rozděl je:
Ve složce cviceni vytvoř nový soubor spropitne.py (pravým tlačítkem na složku → New File).
Přesuň do něj obě funkce.
Tady nahoře je naimportuj a zkontroluj, že program dělá totéž co předtím.
def spropitne(castka, procenta):
return round(castka * procenta / 100)
def celkem(castka, procenta):
return castka + spropitne(castka, procenta)
castka = int(input("Kolik stál oběd? "))
procenta = int(input("Kolik procent spropitného? "))
print(f"Spropitné: {spropitne(castka, procenta)} Kč")
print(f"Celkem zaplatíš: {celkem(castka, procenta)} Kč")
Funkce jsou teď v souboru spropitne.py vedle tohohle.
from spropitne import celkem, spropitne
castka = int(input("Kolik stál oběd? "))
procenta = int(input("Kolik procent spropitného? "))
print(f"Spropitné: {spropitne(castka, procenta)} Kč")
print(f"Celkem zaplatíš: {celkem(castka, procenta)} Kč")
Soubor: cviceni/02_vlastni_modul.py
ramecek(text) vrátí text v rámečku z hvězdiček, tři řádky:
***************
* Ahoj, světe *
***************
(řádky spoj znakem nového řádku "\n")
kricet(text) vrátí text velkými písmeny a s vykřičníkem na konci: kricet("ahoj") vrátí "AHOJ!"
Funkce text vrací (return), nevypisují ho.
Funkce jsou v souboru texty.py vedle tohohle.
import texty
vzkaz = input("Co chceš vzkázat? ")
print(texty.ramecek(vzkaz))
print(texty.kricet(vzkaz))
Zpět na téma: Vlastní moduly · Další: Bonusová cvičení: Vlastní moduly
Bonusy jsou pro rychlíky – když máš hotová cvičení a zbývá čas. Každý bonus má vlastní soubor ve složce lekce-moduly/03_vlastni_moduly/cviceni_bonusy/. Řešení si rozklikni až po vlastním pokusu – tvoje řešení může vypadat jinak, a to je v pořádku.
Soubor: cviceni_bonusy/01_kostky.py
hod() vrátí náhodné číslo od 1 do 6 hod_vice(pocet) vrátí seznam s tolika hody, kolik je pocet
Modul kostky.py si sám importuje randrange z modulu random. Moduly můžou importovat další moduly, stejně jako programy.
Funkce jsou v souboru kostky.py vedle tohohle.
from kostky import hod_vice
pocet = int(input("Kolika kostkami hodit? "))
hody = hod_vice(pocet)
print("Padlo:", hody)
print("Součet:", sum(hody))