Co podle vás znamená psaní kvalitního kódu?

Kvalitní kód:

• Čitelný a srozumitelný: Snadno pochopitelný ostatními vývojáři (a vámi v budoucnu).
• Udržovatelný: Snadno měnitelný, opravovat chyby a přidávat nové funkce.
• Spolehlivý: Funguje správně a předvídatelně za různých podmínek.
• Efektivní: Má přijatelný výkon a využívá zdroje optimálně.
• Testovatelný: Snadno psát automatizované testy k ověření jeho funkčnosti.
• V souladu se standardy: Dodržuje přijaté konvence stylu kódu a architektonické principy.
• Dokumentovaný (je-li třeba): Klíčová rozhodnutí a složité části kódu jsou vysvětleny.

Příklady aspektů kvalitního kódu:

• Názvosloví: Použití smysluplných názvů pro proměnné, funkce a třídy.
• Struktura: Logické rozdělení kódu do modulů, funkcí a tříd.
• Vyvarování se duplicity: Vyhýbání se opakování stejného kódu.
• Ošetření chyb: Odpovídající reakce na výjimečné situace.

# Příklad čitelného a čistého kódu
def calculate_order_total(items):
    """
    Vypočítá celkové náklady položek v objednávce.
    """
    total_price = 0
    for item in items:
        total_price += item.price * item.quantity
    return total_price

# Příklad méně kvalitního kódu (nejasná jména, bez komentářů)
def calc(a):
    t = 0
    for b in a:
        t += b[0] * b[1]
    return t

Porovnávací tabulka:

Aspekt	Kvalitní kód	Méně kvalitní kód
Čitelnost	Snadno čitelný a srozumitelný	Těžko pochopitelný
Udržovatelnost	Snadno měnitelný a vylepšitelný	Těžko měnitelný
Testovatelnost	Snadno psát automatizované testy	Těžko automatizovat testy