Misturar tabs e espaços pode produzir blocos visualmente alinhados que o interpretador entende de outra forma. tabnanny percorre arquivos Python e relata indentação ambígua antes que ela chegue à execução.

Verifique um diretório

python -m tabnanny src tests

Use a API em automações pequenas

A função tabnanny.check(path) aceita arquivo ou diretório. A exceção NannyNag traz linha e contexto, mas a saída do módulo foi pensada principalmente para diagnóstico. Em CI, execute o comando e preserve o código de saída e o log.

Corrija com controle

Configure o editor para inserir espaços e exibir caracteres invisíveis. Não substitua tabs mecanicamente em strings, dados ou arquivos que não sejam Python. Depois da correção, rode compilação e testes para confirmar que os blocos mantêm a intenção.

Continue estudando

Leia também validação de sintaxe com compileall. A documentação oficial do Python, consultada em 22 de julho de 2026, explica a busca recursiva e os casos de ambiguidade.