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.