Mejores Prácticas para Iteradores y Decoradores

Directrices para la iteración perezosa, la higiene de decoradores y las tuberías componibles: los patrones que mantienen los servicios de Python seguros en memoria y depurables.

Cómo Usar Esta Lista

• Revísala al construir tuberías ETL o procesadores de logs.
• Aplícala en frameworks con muchos decoradores (autenticación, reintentos, métricas).
• Combínala con profiling cuando las cadenas de iteradores se vuelvan profundas.
• Úsala en la revisión de código para lambda en bucles y @wraps faltantes.

A - Iteración

• Usa generadores o expresiones generadoras para flujos más grandes que la memoria. Materializa solo en el consumidor final cuando sea necesario.
• Compón tuberías como pequeñas funciones generadoras. Cada etapa realiza una transformación, lo que facilita las pruebas.
• Prefiere itertools para chain, islice, groupby, product. Probados en batalla y perezosos.
• Ordena antes de groupby cuando agrupes por clave. El requisito de clave consecutiva es fácil de olvidar.
• Documenta iteradores de pasada única. Los llamadores no deben asumir la repetición sin tee o list().

B - Generadores y Recursos

• Usa try/finally o @contextmanager dentro de generadores que manejan archivos/sockets. Los consumidores pueden detenerse prematuramente.
• Cierra generadores con .close() en pruebas cuando la limpieza sea importante. Activa GeneratorExit en el yield.
• Evita efectos secundarios en la definición del generador; los efectos se ejecutan al consumir. La semántica perezosa sorprende a los recién llegados.
• Usa yield from en lugar de bucles for/yield manuales. Delegación y propagación de retorno más claras.
• Limita los iteradores infinitos con islice o condiciones de break. count() y cycle() nunca se detienen solos.

C - Decoradores

• Aplica siempre @functools.wraps en funciones envoltorio. Conserva __name__, la documentación y las anotaciones.
• Mantén las pilas de decoradores poco profundas y ordenadas de forma consistente. Documenta el orden de classmethod/staticmethod.
• Parametriza a través de fábricas de decoradores (def retry(n):). Evita la configuración mutable global en decoradores.
• No suprimas excepciones a menos que el propósito del decorador sea la supresión. Vuelve a lanzar o encadena con from.
• Prefiere el middleware/Depends de FastAPI para el ámbito de la solicitud. Decoradores de función para utilidades puras.

D - functools y Caché

• Caché solo funciones puras con argumentos hasheables (lru_cache). Llama a cache_clear cuando las entradas cambien externamente.
• Establece maxsize en lru_cache para espacios de claves ilimitados. Previene fugas de memoria.
• Usa singledispatch para extensión abierta por tipo. No largas cadenas de isinstance en un solo módulo.
• Usa partial para vincular configuración, no para ocultar parámetros requeridos. Mantén las firmas públicas legibles.

E - Gestores de Contexto

• Usa with para archivos, bloqueos, transacciones de bases de datos y configuración temporal. No abras sin una ruta de cierre.
• Usa ExitStack cuando el número de contextos se determine en tiempo de ejecución. Listas de archivos dinámicas, pilas de plugins.
• Devuelve False de __exit__ a menos que estés suprimiendo deliberadamente. Los fallos ocultos corrompen el estado.
• Prefiere @contextmanager para configuración/desmontaje simples de menos de 15 líneas. Basado en clases para objetos reutilizables.
• Prueba las rutas de reversión inyectando excepciones dentro del bloque with.

Preguntas Frecuentes

Relacionados

• Generadores y yield - tuberías perezosas
• Escribiendo Decoradores - wraps y fábricas
• Gestores de Contexto - protocolo de limpieza
• Comprensiones y Expresiones Generadoras - conceptos básicos de genexp

Versiones de Stack: Esta página fue escrita para Python 3.14.0 (estable 3.14, mantenimiento 3.13), FastAPI 0.115+, Django 5.2, Flask 3.1, Pydantic 2, PyTorch 2.6+, pandas 2.2+, Polars 1.x, ruff 0.9+, y uv 0.6+.