MEP8: PEP8 #

Estado #

Concluído

No momento, estamos aplicando um subconjunto de pep8 em novas contribuições de código.

A base de código matplotlib é anterior ao PEP8 e, portanto, é menos consistente em termos de estilo em algumas áreas. Colocar a base de código em conformidade com o PEP8 ajudaria muito a melhorar sua legibilidade.

Descrição detalhada #

Alguns arquivos usam indentação de quatro espaços, alguns usam três. Alguns usam níveis diferentes no mesmo arquivo.

Na maioria das vezes, a nomenclatura de classe/função/variável segue PEP8, mas não faria mal algum corrigir quando necessário.

Implementação #

A implementação deve ser bastante mecânica: executar a ferramenta pep8 sobre o código e corrigir quando apropriado.

Isso deve ser mesclado após a versão 2.0, já que as alterações provavelmente tornarão mais difícil a mesclagem de qualquer pull request pendente.

Além disso, e opcionalmente, a conformidade com o PEP8 pode ser rastreada por um sistema de compilação automatizado.

Compatibilidade com versões anteriores #

Nomes públicos de classes e funções que requerem alteração (não deve haver muitos deles) devem primeiro ser obsoletos e, em seguida, removidos no próximo ciclo de lançamento.

Alternativas #

PEP8 é um padrão popular para o estilo de código Python, abençoado pelos principais desenvolvedores do Python, tornando qualquer alternativa menos desejável.