Codzy

Calidad del código

El código se lee muchas más veces de las que se escribe. La PEP 8 es la guía de estilo oficial de Python: sangría de 4 espacios, nombres de variables y funciones en snake_case, clases en PascalCase, constantes en UPPER_CASE y líneas no demasiado largas. Elige nombres que digan lo que hace cada cosa: average(scores) mejor que f(l).

Una docstring (texto entre comillas triples justo debajo del def) explica para qué sirve una función. Hay herramientas gratuitas que te ayudan: Ruff o Flake8 detectan problemas y Black reformatea el código automáticamente. Mantén también tus funciones cortas, con una sola responsabilidad cada una.

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

Empezar la lección