Codzy

Qualità del codice

Il codice si legge molto più spesso di quanto si scriva. La PEP 8 è la guida di stile ufficiale di Python: indentazione di 4 spazi, nomi di variabili e funzioni in snake_case, classi in PascalCase, costanti in UPPER_CASE, righe non troppo lunghe. Scegli nomi che dicano che cosa fa ogni cosa: average(scores) invece di f(l).

Una docstring (testo tra triple virgolette subito sotto il def) spiega a che cosa serve una funzione. Alcuni strumenti gratuiti ti aiutano: Ruff o Flake8 individuano i problemi e Black riformatta il codice automaticamente. Mantieni anche le funzioni brevi, ognuna con una sola responsabilità.

# Hard to read:
def f(l):
    t=0
    for x in l: t+=x
    return t/len(l)

# Clean (PEP 8, clear names, docstring):
def average(scores):
    """Return the average of a non-empty list of numbers."""
    total = sum(scores)
    return total / len(scores)

print(f([10, 20]), average([10, 20]))
print(average.__doc__)

Inizia la lezione