Repolode
Enviar
PyCQA

PyCQA/pycodestyle

Verificador Python de arquivo único que avalia o código conforme as convenções de estilo da PEP 8, usando apenas a biblioteca padrão.

Ver no GitHubSite
Estrelas
5,165
Forks
762
Issues abertas
105
Último commit
anteontem

O que é?

pycodestyle verifica o código-fonte Python com base em algumas das convenções de estilo definidas pela PEP 8, o guia oficial de estilo do Python. Ele aponta violações como várias importações na mesma linha, quantidade incorreta de linhas em branco entre funções, espaços em excesso e linhas longas demais. Cada ocorrência vem identificada por um código, como E401 ou E302, e pela localização no arquivo.

O projeto é distribuído em um único arquivo Python que depende apenas da biblioteca padrão, então pode ser adicionado diretamente a um projeto. A saída pode ser formatada para que editores abram cada erro no local correspondente, e a ferramenta pode exibir a linha de código problemática junto com o trecho relevante da PEP 8. Um modo de estatísticas resume a frequência de cada erro na base de código.

A ferramenta usa uma arquitetura de plugins, que permite adicionar novas verificações. Antes, era conhecida como pep8, mas mudou de nome para evitar confusão com o próprio documento PEP 8.

Recursos principais

  • 01Verifica o código conforme diversas regras de estilo da PEP 8, identificando cada ocorrência com um código de erro estável.
  • 02É distribuído em um único arquivo e depende apenas da biblioteca padrão do Python.
  • 03Mostra o arquivo, a linha e a coluna de cada erro para que editores possam abri-lo diretamente.
  • 04Pode exibir a linha de código e a orientação relacionada da PEP 8 para cada violação.
  • 05Oferece um modo de estatísticas que contabiliza os erros na base de código.
  • 06Oferece suporte a plugins para adicionar verificações personalizadas.

Casos de uso

  • Aplicar formatação consistente conforme a PEP 8 na integração contínua de um projeto Python.
  • Receber feedback de estilo em linha no editor enquanto escreve código Python.
  • Auditar uma base de código legada de grande porte para descobrir quais violações de estilo são mais comuns.
  • Executar uma verificação de estilo leve sem instalar dependências mais pesadas.

Início rápido

  1. 1

    Instale o pycodestyle com pip

    pip install pycodestyle
  2. 2

    Execute-o em um arquivo Python para verificar o estilo

    pycodestyle --first optparse.py

Antes de usar

  • A licença não está claramente indicada nos metadados (NOASSERTION), então confira o repositório antes de reutilizar.

Em coleções

Linters e formatadores de código

Tópicos

#python#linter#pep8#style-guide#code-quality#static-analysis#flake8-plugin#linter-flake8#linter-plugin#styleguide

Perguntas frequentes

O que é pycodestyle?
Verificador Python de arquivo único que avalia o código conforme as convenções de estilo da PEP 8, usando apenas a biblioteca padrão. pycodestyle verifica o código-fonte Python com base em algumas das convenções de estilo definidas pela PEP 8, o guia oficial de estilo do Python. Ele aponta violações como várias importações na mesma linha, quantidade incorreta de linhas em branco entre funções, espaços em excesso e linhas longas demais. Cada ocorrência vem identificada por um código, como E401 ou E302, e pela localização no arquivo.
pycodestyle é gratuito? Qual é a licença?
pycodestyle é open source sob a licença Other. Confira os termos da licença antes de usá-lo em produtos comerciais.
pycodestyle ainda é mantido?
Manutenção ativa. O último commit de pycodestyle foi em 4 de nov. de 2026.
Para que posso usar pycodestyle?
Aplicar formatação consistente conforme a PEP 8 na integração contínua de um projeto Python. Receber feedback de estilo em linha no editor enquanto escreve código Python. Auditar uma base de código legada de grande porte para descobrir quais violações de estilo são mais comuns. Executar uma verificação de estilo leve sem instalar dependências mais pesadas.
Como instalar pycodestyle?
Instale o pycodestyle com pip: pip install pycodestyle Execute-o em um arquivo Python para verificar o estilo: pycodestyle --first optparse.py
Onde consigo pycodestyle?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/PyCQA/pycodestyle

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados