Codzy

Qualité du code

Un code se lit beaucoup plus souvent qu'il ne s'écrit. La PEP 8 est le guide de style officiel de Python : indentation de 4 espaces, noms de variables et de fonctions en snake_case, classes en PascalCase, constantes en UPPER_CASE, lignes pas trop longues. Choisis des noms qui disent ce que fait la chose : average(scores) plutôt que f(l).

Une docstring (texte entre triples guillemets juste sous le def) explique à quoi sert une fonction. Des outils gratuits t'aident : Ruff ou Flake8 repèrent les problèmes, et Black reformate le code automatiquement. Garde aussi tes fonctions courtes, avec une seule responsabilité chacune.

# 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__)

Commencer la leçon