MEP8: PEP8 #

Stato n.

Completato

Attualmente stiamo applicando un sottoinsieme di pep8 sui nuovi contributi di codice.

La base di codice matplotlib è antecedente a PEP8 e quindi è meno che coerente in termini di stile in alcune aree. Portare la base di codice in conformità con PEP8 farebbe molto per migliorarne la leggibilità.

Descrizione dettagliata #

Alcuni file usano un rientro di quattro spazi, altri ne usano tre. Alcuni usano diversi livelli nello stesso file.

Per la maggior parte, la denominazione di classe/funzione/variabile segue PEP8, ma non sarebbe male correggerla dove necessario.

Implementazione n.

L'implementazione dovrebbe essere abbastanza meccanica: eseguire lo strumento pep8 sul codice e correggere dove appropriato.

Questo dovrebbe essere unito dopo la versione 2.0, poiché le modifiche probabilmente renderanno più difficile l'unione di eventuali richieste pull in sospeso.

Inoltre, e facoltativamente, la conformità PEP8 potrebbe essere monitorata da un sistema di compilazione automatizzato.

Compatibilità con le versioni precedenti #

I nomi pubblici di classi e funzioni che richiedono modifiche (non dovrebbero essercene molte) dovrebbero prima essere deprecati e poi rimossi nel prossimo ciclo di rilascio.

Alternative #

PEP8 è uno standard popolare per lo stile del codice Python, benedetto dagli sviluppatori principali di Python, rendendo qualsiasi alternativa meno desiderabile.