Repolode
Enviar
asottile

asottile/add-trailing-comma

Ferramenta Python e hook do pre-commit que adiciona automaticamente vírgulas finais a chamadas, literais e definições multilinha.

Ver no GitHub
Estrelas
373
Forks
28
Issues abertas
0
Último commit
anteontem

O que é?

add-trailing-comma reescreve arquivos de código Python para que chamadas de função, tuplas, listas, dicionários e conjuntos, definições de funções e classes, imports com from, instruções with e casos match em várias linhas terminem com uma vírgula final. Pode ser executada como um comando independente após a instalação pelo PyPI ou como hook do pre-commit na configuração de um projeto.

A ferramenta também reformata os colchetes ao redor para seguir um estilo consistente: o parêntese de abertura fica no fim da linha, cada argumento ocupa um nível de indentação a mais e o colchete de fechamento volta ao início da linha. Ela também remove vírgulas desnecessárias de literais em uma única linha. Assim, adicionar ou remover um argumento altera apenas uma linha, mantendo os diffs do controle de versão enxutos.

O projeto oferece suporte à sintaxe de parâmetros de tipo do PEP 695 e a instruções match. A documentação do projeto apresenta as regras com diffs de antes e depois.

Recursos principais

  • 01Adiciona vírgulas finais a chamadas, literais, definições de funções e classes e imports.
  • 02Oferece suporte a instruções with, casos match e parâmetros de tipo do PEP 695.
  • 03Reformata os colchetes de abertura e fechamento para deixar um argumento por linha.
  • 04Remove vírgulas finais desnecessárias de literais em uma única linha.
  • 05Pode ser executada como hook do pre-commit ou como comando independente instalado via pip.

Casos de uso

  • Impor um estilo consistente de formatação multilinha em uma base de código Python.
  • Manter os diffs enxutos ao adicionar ou remover argumentos em chamadas longas.
  • Automatizar verificações de formatação em um fluxo de trabalho com pre-commit.

Início rápido

  1. 1

    Instale a ferramenta com pip

    pip install add-trailing-comma
  2. 2

    Opcionalmente, adicione-a como hook de pre-commit em .pre-commit-config.yaml

Em coleções

Linters e formatadores de código

Tópicos

#python#linter#pre-commit#code-formatting#code-style

Perguntas frequentes

O que é add-trailing-comma?
Ferramenta Python e hook do pre-commit que adiciona automaticamente vírgulas finais a chamadas, literais e definições multilinha. add-trailing-comma reescreve arquivos de código Python para que chamadas de função, tuplas, listas, dicionários e conjuntos, definições de funções e classes, imports com from, instruções with e casos match em várias linhas terminem com uma vírgula final. Pode ser executada como um comando independente após a instalação pelo PyPI ou como hook do pre-commit na configuração de um projeto.
add-trailing-comma é gratuito? Qual é a licença?
add-trailing-comma é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
add-trailing-comma ainda é mantido?
Manutenção ativa. O último commit de add-trailing-comma foi em 4 de nov. de 2026.
Para que posso usar add-trailing-comma?
Impor um estilo consistente de formatação multilinha em uma base de código Python. Manter os diffs enxutos ao adicionar ou remover argumentos em chamadas longas. Automatizar verificações de formatação em um fluxo de trabalho com pre-commit.
Como instalar add-trailing-comma?
Instale a ferramenta com pip: pip install add-trailing-comma Opcionalmente, adicione-a como hook de pre-commit em .pre-commit-config.yaml
Onde consigo add-trailing-comma?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/asottile/add-trailing-comma

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

Projetos relacionados