Updates from Brno's offline courses

encukou · web-flow · commit cac1be40e72d · 2023-08-31T20:15:20.000+02:00
#31
diff --git a/courses/pyladies.yml b/courses/pyladies.yml
@@ -71,6 +71,7 @@ sessions:
   slug: def
   materials:
   - lesson: beginners/def
+  - lesson: beginners/prefer-return
   - lesson: beginners/nested-traceback
   - lesson: beginners/local-variables
 
@@ -116,6 +117,7 @@ sessions:
   - lesson: beginners/range
   - lesson: beginners/zip-enumerate
   - lesson: beginners/files
+  - lesson: beginners/with
 
 - title: Grafika
   slug: pyglet
diff --git a/lessons/beginners/circular-imports/index.md b/lessons/beginners/circular-imports/index.md
@@ -60,7 +60,7 @@ má: nekompletní, bez většiny funkcí co v něm mají
 být nadefinované.
 A až potom, co dokončí import `ai.py`,
 se vrátí k souboru `piskvorky.py`
-a pokračuje v provádění příkazů `def` které v něm jsou.
+a pokračuje v provádění příkazů `def`, které v něm jsou.
 Takový nekompletní modul může být občas užitečný,
 ale ve většině případů se chová skoro
 nepředvídatelně a tudíž nebezpečně.
diff --git a/lessons/beginners/cmdline/index.md b/lessons/beginners/cmdline/index.md
@@ -280,7 +280,7 @@ Na **macOS** vyber text myší a pak stiskni <kbd>⌘ Command</kbd>+<kbd>C</kbd>
 Na **Windows** v menu příkazové řádky (ikonce vlevo nahoře) vyber
 *Edit* → *Mark*, text vyber myší a zkopíruj pomocí <kbd>Enter</kbd>.
 
-### Otevření v prohlížeče souborů
+### Otevření v prohlížeči souborů
 
 Na **Linuxu** záleží na programu, který používáš. Buď:
 * zmáčkni <kbd>Ctrl</kbd>+<kbd>L</kbd> a jméno adresáře vlož pomocí
diff --git a/lessons/beginners/comparisons/index.md b/lessons/beginners/comparisons/index.md
@@ -117,7 +117,7 @@ Tady je vidět, jak počítač dělá přesně, co se mu řekne. Nepřemýšlí
 Bylo by dobré uživateli, který zadá záporné číslo,
 přímo říct, že zadal blbost. Jak na to?
 
-Nejdřív zkus nastavit proměnnou která bude `True`,
+Nejdřív zkus nastavit proměnnou, která bude `True`,
 když uživatel zadal kladné číslo.
 
 
diff --git a/lessons/beginners/def/index.md b/lessons/beginners/def/index.md
@@ -82,7 +82,7 @@ Potom následuje odsazené *tělo funkce* – příkazy, které funkce provádí
 Tělo může začít *dokumentačním řetězcem* (angl. *docstring*), který popisuje
 co funkce dělá.
 To může být jakýkoli řetězec, ale tradičně se uvozuje třemi uvozovkami
-(i v případě že je jen jednořádkový).
+(i v případě, že je jen jednořádkový).
 
 Příkazem `return` pak můžeš z funkce *vrátit* nějakou hodnotu.
 
@@ -193,97 +193,3 @@ else:
 > [note]
 > Stejně jako `if` nebo `break` je `return` *příkaz*, ne funkce.
 > Kolem „své“ hodnoty nepotřebuje závorky.
-
-
-### Vrátit nebo vypsat?
-
-Podívejme se teď na následující program, který vypíše obsah elipsy:
-
-```python
-from math import pi
-
-def obsah_elipsy(a, b):
-    return pi * a * b
-
-print('Obsah elipsy s poloosami 3 a 5 je', obsah_elipsy(3, 5), 'cm2')
-```
-
-Takový program se teoreticky dá napsat i s procedurou, tedy funkcí, která nic
-nevrací.
-Procedura může výsledek třeba vypsat na obrazovku:
-
-```python
-from math import pi
-
-def obsah_elipsy(a, b):
-    print('Obsah je', pi * a * b)  # Pozor, `print` místo `return`!
-
-obsah_elipsy(3, 5)
-```
-
-Program takhle funguje, ale přichází o jednu z hlavních výhod funkcí:
-možnost vrácenou hodnotu použít i jinak jež jen v `print`.
-
-Funkci, která *vrací* výsledek, můžeš použít v dalších výpočtech:
-
-```python
-def objem_eliptickeho_valce(a, b, vyska):
-    return obsah_elipsy(a, b) * vyska
-
-print(objem_eliptickeho_valce(3, 5, 3))
-```
-
-... ale s procedurou, která výsledek přímo vypíše, by to nešlo.
-Proto je dobré psát funkce, které spočítané hodnoty vrací,
-a zpracování výsledku (např. vypsání) nechat na kód mimo funkci.
-
-Další důvod proč hodnoty spíš vracet než vypisovat je ten, že jedna funkce se
-dá použít v různých situacích.
-Proceduru s `print` by nešlo rozumně použít tehdy, když nás příkazová
-řádka vůbec nezajímá – třeba v grafické hře, webové aplikaci, nebo pro ovládání
-robota.
-
-Podobně je to se vstupem: když použiju v rámci své funkce `input`, bude se
-moje funkce dát použít jen v situacích, kdy je u počítače klávesnice a za ní
-člověk.
-Proto je lepší funkcím potřebné informace předávat jako argumenty
-a volání `input` (nebo čtení textového políčka či měření čidlem robota)
-nemít ve funkci, ale vně, v kódu, který funkci volá:
-
-```python
-from math import pi
-
-def obsah_elipsy(a, b):
-    """Vrátí obsah elipsy s poloosami daných délek"""
-    # Jen samotný výpočet:
-    return pi * a * b
-
-# print a input jsou "venku":
-x = float(input('Zadej délku poloosy 1: '))
-y = float(input('Zadej délku poloosy 2: '))
-print('Obsah je', obsah_elipsy(x, y))
-```
-
-Samozřejmě existují výjimky: procedura, která přímo vytváří textový výpis
-(např. tabulku), může používat `print`; funkce, která načítá textové informace
-(jako `ano_nebo_ne` výše), zase `input`.
-Když ale funkce něco *počítá*, nebo když si nejsi jist{{gnd('ý', 'á')}},
-je dobré ve funkci `print` ani `input` nemít.
-
-
-## None
-
-Když funkce neskončí příkazem `return`,
-automaticky se vrátí hodnota `None`.
-
-Je to hodnota zabudovaná přímo do Pythonu, podobně jako `True` nebo `False`,
-a znamená „nic“.
-
-```python
-def nic():
-     """Tahle funkce nic nedělá """
-
-print(nic())
-```
-
-Procedury v Pythonu vracejí právě toto „nic“.
diff --git a/lessons/beginners/exceptions/index.md b/lessons/beginners/exceptions/index.md
@@ -65,7 +65,7 @@ A dokonce nám to dá vědět – výjimkou, kterou můžeš *zachytit*.
 >   s mezerou na začátku, např. s `' 3'`. Funkce `isdecimal` ale takový řetězec
 >   odmítne.
 >
-> Chceš-li zjistit jestli funkce `int` umí daný řetězec převést na číslo,
+> Chceš-li zjistit, jestli funkce `int` umí daný řetězec převést na číslo,
 > nejlepší je použít přímo funkci `int`.
 
 
@@ -190,7 +190,7 @@ finally:
 
 Občas se stane, že výjimku budeš potřebovat vyvolat {{gnd('sám', 'sama')}}.
 
-Často se to stává když píšeš nějakou obecnou funkci.
+Často se to stává, když píšeš nějakou obecnou funkci.
 Třeba funkci na výpočet obsahu čtverce.
 Co se stane, když někdo zavolá `obsah_ctverce(-5)`?
 
diff --git a/lessons/beginners/install/info.yml b/lessons/beginners/install/info.yml
@@ -1,6 +1,6 @@
 title: Instalace Pythonu
 style: md
-attribution: Pro PyLadies Brno napsal Petr Viktorin, 2014-2017.
+attribution: Pro PyLadies Brno napsal Petr Viktorin, 2014-2017, Martin Pavlásek (2023)
 license: cc-by-sa-40
 subpages:
     linux:
diff --git a/lessons/beginners/install/macos.md b/lessons/beginners/install/macos.md
@@ -7,7 +7,7 @@ Jak na to?
 Spusť v [příkazové řádce]({{ lesson_url('beginners/cmdline') }}) příkaz:
 
 ```console
-$ /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
+$ /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
 ```
 
 Pak zadej následující příkaz a Python bude nainstalovaný:
diff --git a/lessons/beginners/install/static/windows_add_python_to_path.png b/lessons/beginners/install/static/windows_add_python_to_path.png
diff --git a/lessons/beginners/install/windows.md b/lessons/beginners/install/windows.md
@@ -1,16 +1,34 @@
 # Instalace Pythonu pro Windows
 
-Běž na [stahovací stránku Pythonu](https://www.python.org/downloads/)
-a stáhni si instalátor nejnovější stabilní verze Pythonu.
-Ověř si že je to verze **3.6.0 nebo novější** –
-verze 3.6.0 má jistá vylepšení, která budeme v tomto kurzu používat.
-
-Jak poznat, který instalátor je ten pravý?
-Pokud má tvůj počítač 64bitovou verzi Windows,
-stáhni si *Windows x86-64 executable installer*.
-Pokud máš starší počítač s 32bitovými Windows,
-stáhni si *Windows x86 executable installer*.
-(Rozdíl je v *x86-64* versus *x86*.)
+## Zjisti, jestli už máš Python nainstalovaný
+
+Otevři si příkazovou řádku (pokud nevíš o co jde, přečti si o ní [tady]({{ lesson_url('beginners/cmdline') }})).
+
+Napiš `python` a zmáčkni na klávesnici <kbd>Enter</kbd>.
+Teď se může stát několik různých věcí:
+1. Otevře se ti Microsoft Store → okno zavři a pokračuj v kroku [Stažení](#download)
+2. Zobrazí se ti text podobný tomuto níže?
+```plain
+> python
+Python 3.8.1 (...)
+Type "help", "copyright", "credits" or "license" for more information.
+>>>
+```
+To je dobrá zpráva! Ještě si zkontroluj, jakou verzi máš nainstalovanou
+(např.`Python 3.11.2` je `3.11`, `Python 3.8.1` je `3.8` atd.).
+Třetí číslo za tečkou není tady podstatné.
+  - Je verze `3.6` nebo novější? Výborně, máš instalaci hotovou!
+  Okénko s příkazovou řádkou můžeš zavřít.
+  Až ho budeš znovu potřebovat, můžeš otevřít nové.
+  Pokračuj dále [Nastavením prostředí]({{ lesson_url('beginners/venv-setup') }}).
+V opačném případě přejdi na [Stažení](#download)
+
+
+{{ anchor('download') }}
+## Stažení
+- Běž na [stahovací stránku](https://www.python.org/downloads/windows/)
+- klikni na *Latest Python 3 Release*
+- v části *Files*, ve sloupci *Version*, vyber vhodný *Windows installer* pro tvou verzi Windows (32 nebo 64bit).
 
 > [note]
 > Kde zjistíš, zda máš 32bitové nebo 64bitové Windows? Otevři nabídku
@@ -22,13 +40,17 @@ stáhni si *Windows x86 executable installer*.
     alt='Screenshot zjišťování verze systému',
 ) }}
 
+## Instalace
+
 Stažený instalátor spusť.
-Na začátku instalace zaškrtni **Install launcher for all users**
-a také **Add Python to PATH**.
+
+Na začátku instalace zaškrtni:
+- **Use admin privileges when installing py.exe**
+- a také **Add python.exe to PATH**.
 Tyto volby ti zjednoduší vytvoření virtuálního prostředí.
 
 (Jestli nemáš administrátorské oprávnění, volbu
-*Install launcher for all users* nezaškrtávej.)
+*Use admin privileges when installing py.exe* nezaškrtávej.)
 
 {{ figure(
     img=static('windows_add_python_to_path.png'),
diff --git a/lessons/beginners/list/index.md b/lessons/beginners/list/index.md
@@ -56,7 +56,7 @@ print(seznam)
 
 Důležitá vlastnost seznamů je, že se dají *měnit*.
 
-Než vysvětlíme o co jde, připomeňme si jak fungují hodnoty, které se měnit
+Než vysvětlíme, o co jde, připomeňme si, jak fungují hodnoty, které se měnit
 nedají – např. čísla, řetězce, `True`, `False`, `None`.
 
 Vyzkoušej si následující kousek kódu. Co je na něm „špatně“?
@@ -98,7 +98,7 @@ print(kamaradka)
 A jak jsou na tom seznamy?
 Ty se měnit dají.
 
-Základní způsob jak změnit seznam je přidání
+Základní způsob, jak změnit seznam, je přidání
 prvku na konec pomocí metody `append`.
 Ta *nic nevrací* (resp. vrací `None`), ale „na místě” (angl. *in place*) změní
 seznam, se kterým pracuje. Vyzkoušej si to:
diff --git a/lessons/beginners/prefer-return/index.md b/lessons/beginners/prefer-return/index.md
@@ -0,0 +1,92 @@
+# Vrátit nebo vypsat?
+
+Podívejme se teď na následující program, který vypíše obsah elipsy:
+
+```python
+from math import pi
+
+def obsah_elipsy(a, b):
+    return pi * a * b
+
+print('Obsah elipsy s poloosami 3 a 5 je', obsah_elipsy(3, 5), 'cm2')
+```
+
+Takový program se teoreticky dá napsat i s procedurou, tedy funkcí, která nic
+nevrací.
+Procedura může výsledek třeba vypsat na obrazovku:
+
+```python
+from math import pi
+
+def obsah_elipsy(a, b):
+    print('Obsah je', pi * a * b)  # Pozor, `print` místo `return`!
+
+obsah_elipsy(3, 5)
+```
+
+Program takhle funguje, ale přichází o jednu z hlavních výhod funkcí:
+možnost vrácenou hodnotu použít i jinak než jen v `print`.
+
+Funkci, která *vrací* výsledek, můžeš použít v dalších výpočtech:
+
+```python
+def objem_eliptickeho_valce(a, b, vyska):
+    return obsah_elipsy(a, b) * vyska
+
+print(objem_eliptickeho_valce(3, 5, 3))
+```
+
+... ale s procedurou, která výsledek přímo vypíše, by to nešlo.
+Proto je dobré psát funkce, které spočítané hodnoty vrací,
+a zpracování výsledku (např. vypsání) nechat na kód mimo funkci.
+
+Další důvod, proč hodnoty spíš vracet než vypisovat je ten, že jedna funkce se
+dá použít v různých situacích.
+Proceduru s `print` by nešlo rozumně použít tehdy, když nás příkazová
+řádka vůbec nezajímá – třeba v grafické hře, webové aplikaci nebo pro ovládání
+robota.
+
+Podobně je to se vstupem: když použiju v rámci své funkce `input`, bude se
+moje funkce dát použít jen v situacích, kdy je u počítače klávesnice a za ní
+člověk.
+Proto je lepší funkcím potřebné informace předávat jako argumenty
+a volání `input` (nebo čtení textového políčka či měření čidlem robota)
+nemít ve funkci, ale vně, v kódu, který funkci volá:
+
+```python
+from math import pi
+
+def obsah_elipsy(a, b):
+    """Vrátí obsah elipsy s poloosami daných délek"""
+    # Jen samotný výpočet:
+    return pi * a * b
+
+# print a input jsou "venku":
+x = float(input('Zadej délku poloosy 1: '))
+y = float(input('Zadej délku poloosy 2: '))
+print('Obsah je', obsah_elipsy(x, y))
+```
+
+Samozřejmě existují výjimky: procedura, která přímo vytváří textový výpis
+(např. tabulku), může používat `print`; funkce, která načítá textové informace
+(jako `ano_nebo_ne` výše), zase `input`.
+Když ale funkce něco *počítá*, nebo když si nejsi jist{{gnd('ý', 'á')}},
+je dobré ve funkci `print` ani `input` nemít.
+
+
+## None
+
+Když funkce neskončí příkazem `return`,
+automaticky se vrátí hodnota `None`.
+
+Je to hodnota zabudovaná přímo do Pythonu, podobně jako `True` nebo `False`,
+a znamená „nic“.
+
+```python
+def nic():
+     """Tahle funkce nic nedělá """
+
+print(nic())
+```
+
+Procedury v Pythonu vracejí právě toto „nic“.
diff --git a/lessons/beginners/prefer-return/info.yml b/lessons/beginners/prefer-return/info.yml
@@ -0,0 +1,4 @@
+title: Vrátit nebo vypsat?
+style: md
+attribution: Pro PyLadies Brno napsal Petr Viktorin, 2014-2017.
+license: cc-by-sa-40
diff --git a/lessons/beginners/variables/index.md b/lessons/beginners/variables/index.md
@@ -170,7 +170,7 @@ Detaily si vysvětlíme později;
 pro teď to budou kouzelná zaříkadla.
 
 > [warning]
-> Pozor, záleží na typu hodnoty který chceš získat: text nebo číslo.
+> Pozor, záleží na typu hodnoty, který chceš získat: text nebo číslo.
 > Vybírej pečlivě!
 
 * Chceš-li načíst **text**, použij:
diff --git a/lessons/beginners/with/index.md b/lessons/beginners/with/index.md
diff --git a/lessons/beginners/with/info.yml b/lessons/beginners/with/info.yml
