Štábní kultura

Při psaní kódu se snažíme zachovat konzistentní styl psaní a formátování, stejně jako bychom psali slohovou práci nebo článek do školního časopisu. Během tohoto kurzu se tedy budeme držet následujících pravidel.

Jména proměnných

Proměnné budeme pojmenovávat buď anglicky nebo česky s tím, že píšeme vždy bez diakritiky a malými písmeny. Pokud chceme pojmenovat proměnnou více slovy, použijeme jako oddělovač podtržítka (_). Proměnné také pojmenováváme tak, aby bylo na první pohled jasné, co proměnná obsahuje.

pocet_lidi = 34
obvod = 3.5

Komentáře

Do kódu můžeme vpisovat komentáře, neboli poznámky pro nás a ostatní programátory. Při běhu programu je Python ignoruje. Pokud nejsme schopni podstatu programu vyjádřit jmény proměnných nebo jinak, použijeme komentáře. Co není žádoucí je popisovat komentáři věci, které jsou na první pohled jasné (tedy např. cykly skrz pole, apod.).

Odsazování bloků

V Pythonu se používá odsazování (indentace) pro označení bloků kódu, tedy řádky, na které se vztahuje nějaká podmínka, cyklus, a podobně. Indentace tedy není jen věc stylu kódu, ale také logické struktury programu.