MEP8: PEP8 #
Estado #
Terminado
Actualmente estamos implementando un subconjunto de pep8 en las contribuciones de código nuevo.
Sucursales y solicitudes de extracción #
Ninguno hasta ahora.
Resumen #
El código base de matplotlib es anterior a PEP8 y, por lo tanto, es menos consistente en cuanto a estilo en algunas áreas. Hacer que el código base cumpla con PEP8 contribuiría en gran medida a mejorar su legibilidad.
Descripción detallada #
Algunos archivos usan sangría de cuatro espacios, otros usan tres. Algunos usan diferentes niveles en el mismo archivo.
En su mayor parte, la denominación de clase/función/variable sigue a PEP8, pero no estaría de más arreglarlo cuando sea necesario.
Implementación #
La implementación debería ser bastante mecánica: ejecutar la herramienta pep8 sobre el código y arreglarlo donde corresponda.
Esto debería fusionarse después de la versión 2.0, ya que los cambios probablemente dificultarán la fusión de cualquier solicitud de incorporación de cambios pendiente.
Además, y opcionalmente, el cumplimiento de PEP8 podría ser rastreado por un sistema de construcción automatizado.
Compatibilidad con versiones anteriores #
Los nombres públicos de clases y funciones que requieren cambios (no debería haber muchos de estos) primero deben quedar obsoletos y luego eliminarse en el próximo ciclo de lanzamiento.
Alternativas #
PEP8 es un estándar popular para el estilo de código de Python, bendecido por los desarrolladores centrales de Python, lo que hace que cualquier alternativa sea menos deseable.