Update lessons on testing, modules, circular imports

pyvec#636

Author: encukou

lessons/beginners/circular-imports/index.md

@@ -75,9 +75,9 @@ nepředvídatelně a tudíž nebezpečně.
 Jinými slovy: když se dva moduly importují navzájem,
 nemusí to fungovat podle očekávání.
 
-Téhle situaci se budeme chtít vyvarovat.
+Téhle situaci se budeš chtít vyvarovat.
 
-Jak na to? Máme dvě možnosti.
+Jak na to? Máš dvě možnosti.
 
 
 ## Organizace modulů podle závislostí

lessons/beginners/modules/index.md

@@ -47,7 +47,7 @@ print(math.cos(math.pi))
 A teď to hlavní!
 Můžeš vytvořit vlastní importovatelný modul
 a to jen tak, že uděláš pythonní soubor.
-Funkce, které v něm nadefinuješ, a proměnné,
+Funkce, které v něm nadefinuješ, a globální proměnné,
 které v něm nastavíš, pak budou k dispozici tam, kde modul naimportuješ.
 
 Zkus si to!
@@ -101,7 +101,8 @@ Zkus si to – na konci `louka.py` dopiš:
 print('Louka je zelená!')
 ```
 
-A pak spusť `python` (máš-li ho už spuštěný, ukonči a spusť znovu), a zadej:
+Spusť `python` (máš-li ho už spuštěný, ukonči a spusť znovu)
+a zadej v něm:
 
 ```pycon
 >>> print('První import:')
@@ -112,12 +113,14 @@ A pak spusť `python` (máš-li ho už spuštěný, ukonči a spusť znovu), a z
 
 Výpis se objeví jen poprvé.
 
-Když takhle modul při importu „něco dělá“ (něco vypíše na obrazovku,
-zapíše do souboru, na něco se zeptá uživatele atp.), říká se,
-že má *vedlejší efekt* (angl. *side effect*).
+Když takhle modul při importu „dělá“ něco víc, než jen nastavuje proměnné
+a funkce, říká se, že má *vedlejší efekt* (angl. *side effect*).
+Vedlejší efekt může být vypsání něčeho na obrazovku nebo do souboru,
+vykreslení okýnka na obrazovku, otázka na uživatele pomocí `input`, atp.
+
 V modulech připravených na importování se vedlejším efektům vyhýbáme:
 úloha takového modulu je dát k dispozici *funkce*, které něco dělají,
-ne to udělat za nás.
+ne to udělat přímo.
 Všimni si například, že `import turtle` neukáže okýnko – to se objeví až po
 zavolání `turtle.forward()`.
 
@@ -126,9 +129,7 @@ Příkaz `print` proto radši z modulu zase smaž.
 
 ## Adresář pro každý projekt
 
-Od teď budeme občas psát větší projekty,
+Od teď budeš občas psát větší projekty,
 které budou obsahovat více souvisejících souborů.
-Je dobré pro každý takový projekt udělat
-zvláštní adresář.
-
-(A to samozřejmě znamená i zvláštní gitový repozitář.)
+Pro každý takový projekt si udělej zvláštní adresář.
+Lépe se pak vyznáš v tom, ke kterému projektu který soubor patří.

lessons/beginners/testing/index.md

@@ -1,8 +1,8 @@
 # Testování
 
 Programátorská práce nespočívá jen v tom, program napsat.
-Důležité je si i ověřit, že opravdu funguje (a případně ho pak opravit).
-Ověřování, že program funguje, se říká *testování*.
+Důležité je si i ověřit, že opravdu funguje, a případně ho pak opravit.
+Ověřování, že program funguje, se říká *testování* (angl. *testing*).
 
 Zatím jsi asi svoje programy testoval{{a}} tak, že jsi
 je zkusil{{a}} spustit, něco zadal{{a}} a podíval{{a}} se,
@@ -11,16 +11,14 @@ U větších programů, které budou mít více a více
 možností, ale bude těžší a těžší takhle zkontrolovat,
 jestli všechny ty možnosti fungují, jak mají.
 
-Proto si programátoři, místo aby program zkoušeli ručně, píšou jiné programy,
-které testují jejich výtvory za ně.
+Proto si programátoři často nezkouší programy „ručně“.
+Píšou jiné programy, které jejich výtvory testují za ně.
 
 *Automatické testy* jsou funkce, které
-zkontrolují, že náš program funguje správně.
+zkontrolují, že program funguje správně.
 Spuštěním testů můžeš kdykoli ověřit, že kód funguje.
-Hlavní výhoda je, že když v otestovaném kódu
-v budoucnu uděláš nějakou změnu,
-testy ověří, že jsi nerozbil{{a}} nic, co dříve
-fungovalo.
+Když v otestovaném kódu v budoucnu uděláš nějakou změnu,
+testy ověří, že jsi nerozbil{{a}} nic, co dříve fungovalo.
 
 
 ## Instalace knihovny pytest
@@ -46,11 +44,17 @@ Potom zadej následující příkaz.
 (Je to příkaz příkazové řádky, podobně jako
 `cd` nebo `mkdir`; nezadávej ho do Pythonu.)
 
+> [warning] Opisuj opatrně!
+> Příkaz níže instaluje software z Internetu.
+> Za knihovnu `pytest` autoři tohoto kurzu ručí.
+> Jiné knihovny ale můžou dělat neplechu nebo být dokonce „zavirované“.
+> Dej si proto pozor a ve jménu `pytest` neudělej překlep!
+
 ```console
 (venv)$ python -m pip install pytest
 ```
 
-> [note] Co to znamená?
+> [note] Co ten příkaz znamená?
 > `python -m pip` zavolá Python s tím, že má pustit modul
 > `pip`. Tento modul umí instalovat nebo
 > odinstalovávat knihovny.
@@ -96,9 +100,8 @@ def test_secti():
 
 Co se v té testovací funkci děje?
 
-Příkaz `assert` vyhodnotí výraz za ním
-a pokud výsledek není pravdivý, vyvolá výjimku,
-která způsobí, že test selže.
+Příkaz `assert` vyhodnotí výraz za ním a pokud výsledek není pravdivý,
+vyvolá výjimku, která způsobí, že test selže.
 Můžeš si představit, že `assert a == b` dělá následující:
 
 ```python
@@ -108,8 +111,8 @@ if not (a == b):
 
 > [note]
 > Zatím `assert` nepoužívej jinde než v testovacích funkcích.
-> V „normálním” kódu má `assert` vlastnosti,
-> do kterých teď nebudeme zabředávat.
+> V „normálním” kódu se `assert` může chovat trochu jinak než výše,
+> ale do toho teď nebudeme zabředávat.
 
 
 ## Spouštění testů
@@ -118,7 +121,7 @@ Testy se spouští zadáním příkazu
 `python -m pytest -v` následovaným názvem souboru s testy.
 Tedy v překladu: <strong>Python</strong>e, pusť
 <strong>m</strong>odul <strong>pytest</strong>,
-v „ukecaném” režimu (angl. <strong>v</strong>erbose) nad zadaným souborem.
+v „ukecaném” režimu (angl. <strong>v</strong>erbose) a se zadaným souborem.
 
 ```console
 $ python -m pytest -v test_secteni.py
@@ -144,10 +147,10 @@ najevo a přidá několik informací, které můžou
 usnadnit nalezení a opravu chyby.
 
 > [note]
-> Argument s názvem souboru můžeme vynechat: `python -m pytest -v`
+> Argument s názvem souboru můžeš vynechat: `python -m pytest -v`.
 > V takovém případě `pytest` projde aktuální adresář a spustí testy
 > ze všech souborů, jejichž jméno začíná na `test_`. Místo souboru
-> lze též uvést adresář a `pytest` vyhledá testy v něm.
+> lze též uvést adresář: `pytest` vyhledá testy v něm.
 
 Zkus si změnit funkci `secti` (nebo její test) a podívat se,
 jak to vypadá když test „neprojde“.
@@ -158,7 +161,7 @@ jak to vypadá když test „neprojde“.
 Testy se většinou nepíšou přímo ke kódu,
 ale do souboru vedle.
 Je to tak přehlednější a taky to pak zjednodušuje
-distribuci – předávání kódu někomu, kdo ho chce
+*distribuci* – předání kódu někomu, kdo ho chce
 jen spustit a testy nepotřebuje.
 
 Rozděl soubor s testem sečítání: funkci `secti` přesuň do modulu `secteni.py`,
@@ -173,7 +176,7 @@ Test by měl opět projít.
 
 Automatické testy musí projít „bez dozoru“.
 V praxi se často automaticky spouští, případné chyby se automaticky
-oznamují (např. e-mailem) a fungující kód se automaticky
+oznamují (např. e-mailem) a fungující otestovaný kód se automaticky
 začne používat dál (nebo se rovnou vydá zákazníkům).
 
 Co to znamená pro nás?
@@ -308,4 +311,3 @@ def test_tah_chyba():
     with pytest.raises(ValueError):
         piskvorky.tah_pocitace('oxoxoxoxoxoxoxoxoxox')
 ```
-