Update MI-PYT materials with various new stuff, mostly Python 3.7

Author: hroncok

lessons/fast-track/install/index.md

@@ -28,8 +28,8 @@ Modul `venv` je součást [standardní knihovny](https://docs.python.org/3/libra
 Zkontroluj, že máš modul `ensurepip`:
 
 ```console
-$ python3.6 -m ensurepip --version
-pip 9.0.1 (nebo i jiná verze)
+$ python3.7 -m ensurepip --version
+pip 18.0 (nebo i jiná verze)
 ```
 
 Jestli ne, postupuj podle [lekce pro začátečníky]({{ lesson_url('beginners/install') }}) –
@@ -39,15 +39,15 @@ Jinak použij:
 ```console
 $ mkdir project
 $ cd project
-$ python3.6 -m venv __venv__  # vytvoření virtualenvu -- použij Python dle systému
+$ python3.7 -m venv __venv__  # vytvoření virtualenvu -- použij Python 3 dle systému
 $ . __venv__/bin/activate  # aktivace
 (__venv__)$ python -m pip install requests  # příkaz na instalaci balíčků puštěný ve virtualenvu
 (__venv__)$ ...  # práce "uvnitř"
 (__venv__)$ deactivate  # vypnutí virtualenvu
 ```
 
 {% if var('mi-pyt') %}
-V tomto kurzu lze případně využít i Python 3.5. Pokud máš 3.4 nebo ještě nižší,
+V tomto kurzu lze případně využít i Python 3.6. Pokud máš 3.5 nebo ještě nižší,
 doporučujeme aktualizovat.
 {% endif %}
 
@@ -63,20 +63,25 @@ doporučujeme aktualizovat.
 (__venv__)> deactivate  # vypnutí virtualenvu
 ```
 
-<!-- XXX: Windows cmd prompt with active venv is not highlighted properly... -->
-
 ## Poznámky
 
-Příkaz `__venv__/bin/activate` budeš muset zadat vždy, než začneš na projektu
+Příkaz `. __venv__/bin/activate` budeš muset zadat vždy, než začneš na projektu
 pracovat.
 
 Ono `__venv__` je jen jméno adresáře. Můžeš si ho pojmenovat jak chceš; dokonce
 nemusí být v rámci adresáře s projektem.
 Někteří lidé mají všechny virtuální prostředí na jednom místě; dokonce existuje
-nástroj [virtualenvwrapper] na správu takového řešení.
-Autoři tohoto textu však doporučují `__venv__` v adresáři s projektem.
+nástroj [virtualenvwrapper] na správu takového řešení, případně [pipenv],
+který _Python Packaging Authority_ [doporučuje] pro vývoj aplikací (my ale
+budeme vyvíjet i knihovny).
+
+Autoři tohoto textu tedy doporučují `__venv__` v adresáři s projektem.
+Při použití v kombinaci s Gitem nezapomeň tento adresář přidat do souboru
+`.gitignore`.
 
 [virtualenvwrapper]: https://virtualenvwrapper.readthedocs.io/en/latest/
+[pipenv]: https://pipenv.readthedocs.io/en/latest/
+[doporučuje]: https://packaging.python.org/tutorials/managing-dependencies/
 
 Příkaz `python -m pip install` nainstaluje danou knihovnu – může to být i jiná
 než `requests` jako výše.

lessons/intro/async/index.md

@@ -203,7 +203,9 @@ Každé vlákno může mít vlastní smyčku událostí, kterou získáme pomoc
   úlohy „vyčerpaly“), nebo
 * `loop.run_until_complete(task)` – tahle funkce skončí hned, jakmile je hotová
   daná úloha, a vrátí její výsledek.
-
+* Od Pythonu 3.7 můžete použít jednoduché `asyncio.run(task)`, aniž byste museli
+  explicitně pracovat s určitou smyčkou událostí. Jedná se ale o API, které se
+  v budoucnu může změnit.
 
 
 Futures

lessons/intro/deployment/pythonanywhere.md

@@ -1,14 +1,14 @@
 Deployment webových aplikací na PythonAnywhere
 ==============================================
 
-[Python Anywhere] je pro limitované použití zdarma.
+[PythonAnywhere] je pro limitované použití zdarma.
 
 K posílání kódu na produkční prostředí budeme používat Git.
 Nejprve proto uložte celý projekt do Gitu a nahrajte na GitHub.
 
 Potom se zaregistrujte na
 [www.pythonanywhere.com](https://www.pythonanywhere.com/) a vyberte
-Beginner Account.
+*Beginner Account*.
 Po přihlášení se ukáže záložka *Consoles*, kde vytvořte "Bash" konzoli.
 V té vytvořte a aktivujte virtuální prostředí a nainstalujte Flask (plus
 případně další závislosti nebo jiný webový framework).
@@ -19,12 +19,20 @@ na vytvoření virtuální prostředí, než jste z toho kurzu zvyklí.
 Napište příkazy takto (bez úvodního `$`):
 
 ```console
-$ virtualenv --python=python3.6 __venv__
+$ virtualenv --python=python3.7 __venv__
 $ . __venv__/bin/activate
 $ python -m pip install flask
 ```
 
-Následně naklonujte na PythonAnywhere náš kód.
+> [note]
+> Pokud máte na PythonAnywhere starší účet, možná tam Python 3.7 nenajdete.
+> Můžete použít Python 3.6, nemělo by to vadit, protože tento návod je
+> koncipován tak, aby s touto verzí také fungoval.
+> Případně můžete [zažádat o aktualizaci systémové
+> image](https://www.pythonanywhere.com/forums/topic/12878/#id_post_52160).
+
+
+Následně naklonujte na PythonAnywhere váš kód.
 S veřejným repozitářem je to jednodušší – stačí ho naklonovat „anonymně”
 (`git clone https://github.com/<github-username>/<github-repo>`).
 Pokud ale používáme privátní repozitář, bude potřeba si vygenerovat SSH klíč:
@@ -77,7 +85,7 @@ Nakonec restartujte aplikaci velkým zeleným tlačítkem na záložce *Web*
 a na adrese <code><var>&lt;uživatelské-jméno&gt;</var>.pythonanywhere.com</code>
 si ji můžete prohlédnout.
 
-[Python Anywhere]: https://www.pythonanywhere.com/
+[PythonAnywhere]: https://www.pythonanywhere.com/
 
 ### Deployment soukromých údajů
 

lessons/intro/distribution/index.md

@@ -56,7 +56,7 @@ Je to dobrá konvence, ale není to technicky nutné.
 Balíček můžeme zkusit nainstalovat do virtualenvu:
 
 ```console
-$ python3.6 -m venv __venv__     # (nebo jinak -- podle vašeho OS)
+$ python3.7 -m venv __venv__     # (nebo jinak -- podle vašeho OS)
 $ . __venv__/bin/activate        # (nebo jinak -- podle vašeho OS)
 (__venv__)$ python setup.py install
 ...
@@ -176,7 +176,8 @@ setup(
         'Programming Language :: Python',
         'Programming Language :: Python :: Implementation :: CPython',
         'Programming Language :: Python :: 3',
-        'Programming Language :: Python :: 3.5',
+        'Programming Language :: Python :: 3.6',
+        'Programming Language :: Python :: 3.7',
         'Topic :: Software Development :: Libraries',
         ],
     zip_safe=False,

lessons/intro/docs/index.md

@@ -25,28 +25,30 @@ K modulům `autodoc` a `doctest` se dostaneme později.
 ```ansi
 ␛[36m$␛[0m . __venv__/bin/activate
 ␛[36m(__venv__) $␛[0m python -m pip install sphinx
+␛[36m(__venv__) $␛[0m mkdir docs
+␛[36m(__venv__) $␛[0m cd docs
 ␛[36m(__venv__) $␛[0m python -m sphinx.quickstart
-␛[01mWelcome to the Sphinx 1.5.5 quickstart utility.␛[39;49;00m
+␛[01mWelcome to the Sphinx 1.8.1 quickstart utility.␛[39;49;00m
 
 Please enter values for the following settings (just press Enter to
 accept a default value, if one is given in brackets).
 
-Enter the root path for documentation.
-␛[35m> Root path for the documentation [.]: ␛[39;49;00mdocs
+␛[01mSelected root path: .␛[39;49;00m
 
-...
+You have two options for placing the build directory for Sphinx output.
+Either, you use a directory "_build" within the root path, or you separate
+"source" and "build" directories within the root path.
+␛[35m> Separate source and build directories (y/n) [n]: ␛[39;49;00m
+
+Inside the root directory, two more directories will be created; "_templates"
+for custom HTML templates and "_static" for custom stylesheets and other static
+files. You can enter another prefix (such as ".") to replace the underscore.
+␛[35m> Name prefix for templates and static dir [_]: ␛[39;49;00m
 
 The project name will occur in several places in the built documentation.
 ␛[35m> Project name: ␛[39;49;00mcoolthing
 ␛[35m> Author name(s): ␛[39;49;00mPythonista Dokumentarista
-
-Sphinx has the notion of a "version" and a "release" for the
-software. Each version can have multiple releases. For example, for
-Python the version is something like 2.5 or 3.0, while the release is
-something like 2.5.1 or 3.0a1.  If you don't need this dual structure,
-just set both to the same value.
-␛[35m> Project version []: ␛[39;49;00m0.1
-␛[35m> Project release [0.1]: ␛[39;49;00m
+␛[35m> Project release []: ␛[39;49;00m 0.1
 
 ...
 
@@ -60,7 +62,7 @@ Please indicate if you want to use one of the following Sphinx extensions:
 ␛[01mFinished: An initial directory structure has been created.␛[39;49;00m
 ```
 
-Průvodce vytvoří složku `docs` a v ní několik souborů:
+Průvodce vytvoří ve složce `docs` několik souborů:
 
 * `conf.py` – konfigurační soubor,
 * `index.rst` – vlastní text dokumantace,
@@ -80,10 +82,9 @@ dokumentace sestavit do HTML.
 > manuálové stránky atd.), pro nás bude podstatné především HTML.
 
 ```console
-(__venv__) $ cd docs
 (__venv__) $ make html
 ...
-Build finished. The HTML pages are in _build/html.
+The HTML pages are in _build/html.
 ```
 
 Ve zmíněné složce byste měli najít `index.html`, ten si můžete prohlédnout
@@ -149,7 +150,7 @@ It refers to the section itself, see :ref:`my-reference-label`.
 It could refer to a different section as well :)
 ```
 
-[konstrukce ref]: http://www.sphinx-doc.org/en/1.4.8/markup/inline.html#role-ref
+[konstrukce ref]: http://www.sphinx-doc.org/en/master/markup/inline.html#role-ref
 
 
 Co do dokumentace psát
@@ -321,7 +322,7 @@ You can use other values:
 ```
 
 Testy se také dají zařazovat do skupin, více
-v [dokumentaci](http://www.sphinx-doc.org/en/1.4.8/ext/doctest.html).
+v [dokumentaci](http://www.sphinx-doc.org/en/master/ext/doctest.html).
 
 ```console
 (__venv__) $ make doctest
@@ -358,6 +359,8 @@ Pokud jste postupovali podle návodu výše, máte dokumentaci v adresáři `doc
 je tedy potřeba přidat nadřazený adresář (`..`):
 
 ```python
+# -- Path setup --------------------------------------------------------------
+
 # If extensions (or modules to document with autodoc) are in another directory,
 # add these directories to sys.path here. If the directory is relative to the
 # documentation root, use os.path.abspath to make it absolute, like shown here.
@@ -382,7 +385,7 @@ Poté na Travisu můžete udělat něco jako:
 ```yaml
 language: python
 python:
-- '3.6'
+- '3.7'
 install:
 - python setup.py install
 - pip install -r docs/requirements.txt
@@ -420,7 +423,7 @@ Tento příklad na dané místo vygeneruje dokumentaci složenou z dokumentačn
 
 Pokud chcete selektivně vybrat, dokumentaci čeho chcete generovat,
 můžete použít i
-[jiné direktivy](http://www.sphinx-doc.org/en/1.4.8/ext/autodoc.html#directive-automodule).
+[jiné direktivy](http://www.sphinx-doc.org/en/master/ext/autodoc.html#directive-automodule).
 
 Pro vygenerování hezké struktury si můžete pomoci příkazem `apidoc`:
 
@@ -476,7 +479,7 @@ class Betamax:
 Existují různé způsoby, jak dokumentovat argumenty, návratové hodnoty apod.
 Zvídavým studentům doporučujeme podívat se na rozšíření [Napoleon].
 
-[Napoleon]: http://www.sphinx-doc.org/en/1.4.8/ext/napoleon.html
+[Napoleon]: http://www.sphinx-doc.org/en/master/ext/napoleon.html
 
 
 Odkazy na třídy a moduly
@@ -496,8 +499,8 @@ bez použití `autodoc`.
 Všechny zdokumentované objekty se automaticky přidávají do rejstříku.
 Chcete-li do rejstříku přidat něco navíc, použijte direktivu [index].
 
-[domény Python]: http://www.sphinx-doc.org/en/1.4.8/domains.html#cross-referencing-python-objects
-[index]: http://www.sphinx-doc.org/en/1.4.8/markup/misc.html#index-generating-markup
+[domény Python]: http://www.sphinx-doc.org/en/master/domains.html#cross-referencing-python-objects
+[index]: http://www.sphinx-doc.org/en/master/markup/misc.html#index-generating-markup
 
 
 README.rst

lessons/intro/flask/index.md

@@ -49,16 +49,18 @@ Pak aplikaci spusťte pomocí následujících příkazů.
 (__venv__) $ export FLASK_APP=hello.py
 (__venv__) $ export FLASK_DEBUG=1
 (__venv__) $ flask run
+ * Serving Flask app "hello"
+ * Forcing debug mode on
  * Running on http://127.0.0.1:5000/ (Press CTRL+C to quit)
  * Restarting with stat
  * Debugger is active!
- * Debugger pin code: 189-972-345
+ * Debugger PIN: 189-972-345
 ```
 Na zmíněné adrese byste měli v prohlížeči vidět použitý text.
 
 Proměnná prostředí `FLASK_APP` říká Flasku, kde aplikaci najít.
 V daném souboru Flask hledá automaticky proměnnou jménem `app`.
-([Jde nastavit](http://flask.pocoo.org/docs/0.12/cli/) i jiná.)
+([Jde nastavit](http://flask.pocoo.org/docs/1.0/cli/) i jiná.)
 Proměnná `FLASK_DEBUG` nastavuje ladícím režim, který si popíšeme za chvíli.
 
 V programu jsme jako `app` vytvořili flaskovou aplikaci.
@@ -87,7 +89,7 @@ def hello():
 
 Na adrese [`http://127.0.0.1:5000/hello/`][local-hello] pak uvidíte druhou stránku.
 
-[`@app.route`]: http://flask.pocoo.org/docs/0.12/api/#flask.Flask.route
+[`@app.route`]: http://flask.pocoo.org/docs/1.0/api/#flask.Flask.route
 [local-hello]: http://127.0.0.1:5000/hello/
 
 ### Ladící režim
@@ -115,7 +117,7 @@ jako `/user/hroncok/`, ale nemůžete při každé registraci nového uživatele
 přidávat novou funkci do kódu.
 Musíte použít [dynamické routy]:
 
-[dynamické routy]: http://flask.pocoo.org/docs/0.12/quickstart/#variable-rules
+[dynamické routy]: http://flask.pocoo.org/docs/1.0/quickstart/#variable-rules
 
 ```python
 @app.route('/user/<username>/')
@@ -157,7 +159,7 @@ K tomu se používá funkce [`url_for()`], která jako první parametr bere jmé
 routy (neboli jméno funkce, která routu obsluhuje), a pak pojmenované argumenty
 pro pravidla v dynamické routě:
 
-[`url_for()`]: http://flask.pocoo.org/docs/0.12/api/#flask.url_for
+[`url_for()`]: http://flask.pocoo.org/docs/1.0/api/#flask.url_for
 
 ```python
 from flask import url_for
@@ -418,4 +420,4 @@ Flask umí i další věci – například zpracování formulářů, chybové s
 přesměrování.
 
 Všechno to najdete
-[v dokumentaci](http://flask.pocoo.org/docs/0.11/quickstart/).
+[v dokumentaci](http://flask.pocoo.org/docs/1.0/quickstart/).

lessons/intro/pyqt/index.md

@@ -16,7 +16,7 @@ Pokud budete používat svůj počítač, prosíme vás o instalaci již předem
 
 ### PyQt5
 
-Pokud máte Python 3.5 a jednu z platforem, pro které je připraven [wheel na PyPI](https://pypi.org/project/PyQt5/), stačí udělat:
+Pokud máte Python alespoň 3.5 a jednu z platforem, pro které je připraven [wheel na PyPI](https://pypi.org/project/PyQt5/), stačí udělat:
 
 ```console
 (__venv__) $ python -m pip install --upgrade pip
@@ -36,7 +36,8 @@ Pokud nic z toho nepomůže, můžete zkusit přeložit PyQt5 ze [zdrojových so
 
 *První aplikace* níže by vám měla fungovat.
 
-Pokud narazíte na chybu `Could not find or load the Qt platform plugin "xcb"`, podívejte se do [naší issue](https://github.com/cvut/MI-PYT/issues/57).
+> [note]
+> Pokud narazíte na chybu `Could not find or load the Qt platform plugin "xcb"`, podívejte se do [naší issue](https://github.com/cvut/MI-PYT/issues/57).
 
 ### Qt5 Designer
 

lessons/intro/requests/index.md

@@ -70,7 +70,7 @@ k testování HTTP dotazů:
 >>> session.headers.update({'x-test': 'true'})
 >>> r = session.get('http://httpbin.org/headers', headers={'x-test2': 'true'})
 >>> r.json()
-{'headers': {'Accept': '*/*', 'User-Agent': 'python-requests/2.10.0', 'X-Test2': 'true', 'Host': 'httpbin.org', 'Accept-Encoding': 'gzip, deflate', 'X-Test': 'true', 'Cookie': 'mipyt=best'}}
+{'headers': {'Accept': '*/*', 'Accept-Encoding': 'gzip, deflate', 'Connection': 'close', 'Cookie': 'mipyt=best', 'Host': 'httpbin.org', 'User-Agent': 'python-requests/2.19.1', 'X-Test': 'true', 'X-Test2': 'true'}}
 ```
 
 ## Twitter API