Formatador Python

O formatador aplica as regras do próprio motor e as opções configuráveis. O verificador básico separado cobre de forma aproximada E501, W291, E101, E111 e E302; não certifica total conformidade com o PEP 8.

Use a verificação básica após uma análise de sintaxe bem-sucedida. Ela reporta as verificações abrangidas de espaços, indentação, comprimento de linha e linhas em branco. Um resultado aprovado nada diz sobre regras não testadas.

Sim, o formatador foi projetado especificamente para a sintaxe sensível a indentação do Python, tratando corretamente blocos aninhados, linhas de continuacao e expressões multilinha preservando a estrutura lógica.

O formatador suporta sintaxe Python 3.x, incluindo f-strings, operador morsa, declarações match/case, type hints, dataclasses e outros recursos modernos do Python.

O parser de sintaxe corre antes de qualquer formatação, pelo que o código que não pode ser analisado nunca é reescrito. A mensagem de erro é mostrada com a linha afetada e a sua entrada fica inalterada. Corrija o erro indicado e volte a executar a formatação.

A verificação básica separada usa 79 caracteres para o seu aviso de comprimento de linha. A formatação tem a sua própria largura de linha configurada; são definições independentes. Esta página não certifica conformidade com o PEP 257.

O Python usa a indentação como sintaxe - o interpretador lança um TabError quando tabulações e espaços se misturam no mesmo bloco, e alterar os níveis de indentação muda a que suite pertence uma instrução. O formatador verifica a consistência (ou todas as tabulações ou todos os espaços por ficheiro) e recusa reindentar código cuja estrutura de blocos não consegue provar que permanece idêntica após a alteração.

Os campos de substituição de f-strings {expr!r:>10} são preservados exatamente como estão - o seu conteúdo são expressões que o formatador não reescreve. As type hints (PEP 484) recebem o espaçamento padrão em torno dos dois pontos (def f(x: int) -> str:) e a sintaxe de união moderna (int | None) é deixada tal como está escrita, uma vez que é válida a partir do Python 3.10.