Sobre o projeto
O YAPF é um formatador de código Python que utiliza um algoritmo baseado no clang-format para calcular a melhor formatação de código com base nas configurações de estilo definidas. Seu objetivo é produzir código que pareça ter sido escrito por um programador seguindo um guia de estilo, reduzindo o esforço manual de manutenção do código.
Principais funcionalidades incluem:
- Suporte a múltiplos estilos predefinidos, incluindo PEP8, Google, Facebook e um estilo personalizado do YAPF.
- Alta configurabilidade por meio de uma ampla variedade de "ajustes" (configurações) para sintonizar indentação, posicionamento de colchetes, divisão de linhas e espaçamento.
- Configuração flexível por meio de argumentos de linha de comando, arquivos `.style.yapf`, `setup.cfg` ou `pyproject.toml`.
- Capacidade de executar recursivamente em diretórios, formatar intervalos específicos de linhas e excluir arquivos usando `.yapfignore` ou `pyproject.toml`.
- Capabilities de integração como biblioteca por meio das APIs `FormatCode` e `FormatFile`.
- Uma ferramenta `yapf-diff` para reformatar apenas as linhas alteradas em um diff unificado, o que é útil para fluxos de trabalho de CI e gerenciamento de patches.
O YAPF suporta Python 3.7+ e é compatível com vários editores por meio de plugins da comunidade.
Comments
0 Rating appears after 10 ratings
Sign in to join the discussion.