PEP 8 (Python Enhancement Proposal 8) je průvodce psaním kódu v programovacím jazyce Python, který vyvinul Guido van Rossum, tvůrce Pythonu. Norma Pep 8 definuje pravidla a doporučení týkající se organizace kódu, stylu a dohod o pojmenování proměnných, tříd, funkcí a dalších prvků programu. Dodržování standardu Pep 8 umožňuje zlepšit čitelnost a udržitelnost kódu a také zvýšit jeho kvalitu.
Jedním z nejdůležitějších aspektů standardu Pep 8 je použití mezer v kódu. Mezery mezi prvky kódu se používají k vytváření odsazení a oddělení výrazů, což výrazně zlepšuje čitelnost programu. Je důležité si všimnout, že v Pythonu hrají mezery při určování bloků kódu, takže jejich správné použití má zvláštní význam.
Mezery v Pythonu jsou velmi důležité a váš kód nemusí správně fungovat nebo vydávat syntaktické chyby, pokud se mezery nepoužívají správně. Pravidla mezer mají za cíl zlepšit čitelnost kódu a učinit jej srozumitelnějším pro vývojáře.
Výsledkem dodržování pravidel mezer v kódu Python je zlepšení strukturovanosti kódu, snížení chyb, standardizace programovacího stylu a usnadnění sdílení kódu různými vývojáři. Proto je třeba věnovat dostatečnou pozornost výběru a používání řádků kódu odpovídajících standardu Pep 8.
Výběr řádků kódu Pep 8
Jedním z klíčových aspektů standardu Pep 8 je použití mezer. Mezery kolem operátorů a klíčových slov umožňují, aby kód vypadal strukturovaněji a snadněji čitelný.
Zde je několik příkladů řádků kódu, které odpovídají standardu Pep 8:
def sum_numbers(a, b): return a + b if x == 0: print("x is zero") for i in range(10): print(i)
Zde jsou sekvence mezer před a za operátory, jako jsou def, if a for. To pomáhá oddělit tato klíčová slova od zbytku kódu a činí je čitelnějšími.
Norma Pep 8 také doporučuje použít mezery kolem aritmetických operátorů k jejich zvýraznění v kódu:
a = 10 b = 5 sum = a + b diff = a - b
Přidáním mezer kolem operátorů je Kód čitelnější a usnadňuje pochopení toho, které operace se provádějí v každém řádku.
Dodržování standardu Pep 8 při výběru řádků kódu pomáhá vytvořit jednodušší a strukturovanější kód, který je snadno čitelný a srozumitelný pro ostatní programátory. To zvyšuje kvalitu vašeho kódu a z dlouhodobého hlediska je udržitelnější.
Význam standardu Pep 8
Základní myšlenkou PEP 8 je jednoduchost a čitelnost. Zde jsou pokyny pro odsazení, pojmenování proměnných, délku řádku kódu, použití mezer a dalších prvků návrhu kódu. Díky těmto doporučením vypadá kód Pythonu strukturovaněji a jednotněji.
PEP 8 také doporučuje používat prázdné řádky k seskupování různých částí kódu ve funkcích a třídách a k oddělení importů, reklam tříd a funkcí.
Použití standardu Pep 8 pomáhá nejen zlepšit čitelnost kódu, ale také učinit kód podporovanějším a méně náchylným k chybám. Dodržování těchto doporučení nějakou dobu trvá, ale nakonec usnadňuje doprovod a vývoj softwaru v Pythonu.
| Příklad | Kód odpovídající PEP 8 | Kód, který neodpovídá PEP 8 |
|---|---|---|
| Zarážka | def func(): |
print("X is equal to 5")
print("X is equal to 5")
Poznámky k mezerám
1. Vyhněte se zbytečným mezerám kolem operátorů a interpunkcím:
2. Použijte mezery kolem operátorů ke zvýšení čitelnosti:
3. Vyhněte se mezerám před čárkou:
4. Pomocí odsazení oddělte vnořené bloky kódu:
if x > 0: print("x is positive")
5. Omezte délku řádku kódu na 79 znaků:
result = some_really_long_function_name(argument1, argument2, argument3)
Poznámka: Pokud se řádek kódu nevejde na jeden řádek, můžete k označení pokračování řádku použít vnitřní mezery:
result = some_really_long_function_name(argument1, argument2, argument3)
Podle těchto poznámek budete moci svůj kód učinit čitelnějším a odpovídajícím standardu Pep 8.
Velikost odsazení v Pythonu
Odsazení hrají v Pythonu důležitou roli, protože určují přílohu bloků kódu. V PEP 8 se doporučuje místo tabulace použít čtyři mezery pro odsazení.
Uvnitř bloku kódu se odsazení používají k označení vnořených úrovní. Velikost odsazení se může lišit, ale PEP 8 doporučuje pro každou úroveň odsazení použít čtyři mezery.
- def my_function():
- print ("to je funkce")
- print ("je to blok kódu uvnitř funkce")
Zde se každá úroveň odsazení skládá ze čtyř mezer. Díky tomu je Kód čitelnější a usnadňuje určování, kde blok kódu začíná a končí.