Repolode
Enviar
asottile

asottile/add-trailing-comma

Herramienta de Python y hook de pre-commit que añade automáticamente comas finales a llamadas, literales y definiciones multilínea.

Ver en GitHub
Estrellas
373
Forks
28
Issues abiertos
0
Último commit
hace 3 días

¿Qué es?

add-trailing-comma reescribe archivos de código fuente de Python para que las llamadas a funciones, los literales de tuplas, listas, diccionarios y conjuntos, las definiciones de funciones y clases, las importaciones from, las instrucciones with y los casos match de varias líneas terminen con una coma final. Puede ejecutarse como comando independiente tras instalarse desde PyPI o como hook de pre-commit en la configuración de un proyecto.

La herramienta también reformatea los paréntesis y corchetes circundantes con un estilo uniforme: el paréntesis de apertura queda al final de la línea, cada argumento ocupa un nivel de sangría más y el paréntesis de cierre vuelve al inicio de su línea. También elimina las comas innecesarias de los literales de una sola línea. Así, al añadir o quitar un argumento solo cambia una línea y los diffs del control de versiones se mantienen mínimos.

El proyecto admite la sintaxis de parámetros de tipo de PEP 695 y las instrucciones match, y la documentación del proyecto muestra sus reglas con diffs de antes y después.

Funciones clave

  • 01Añade comas finales a llamadas, literales, definiciones de funciones y clases, e importaciones.
  • 02Admite instrucciones with, casos match y parámetros de tipo de PEP 695.
  • 03Reformatea los paréntesis y corchetes de apertura y cierre para que haya un argumento por línea.
  • 04Elimina las comas finales innecesarias de los literales de una sola línea.
  • 05Se ejecuta como hook de pre-commit o como comando independiente instalado mediante pip.

Casos de uso

  • Imponer un estilo uniforme para el formato multilínea en una base de código Python.
  • Mantener los diffs al mínimo cuando se añaden o eliminan argumentos en llamadas largas.
  • Automatizar las comprobaciones de formato en un flujo de trabajo de pre-commit.

Inicio rápido

  1. 1

    Instala la herramienta con pip

    pip install add-trailing-comma
  2. 2

    Opcionalmente, añádela como hook de pre-commit en .pre-commit-config.yaml

En colecciones

Linters y formateadores de código

Temas

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

Preguntas frecuentes

¿Qué es add-trailing-comma?
Herramienta de Python y hook de pre-commit que añade automáticamente comas finales a llamadas, literales y definiciones multilínea. add-trailing-comma reescribe archivos de código fuente de Python para que las llamadas a funciones, los literales de tuplas, listas, diccionarios y conjuntos, las definiciones de funciones y clases, las importaciones from, las instrucciones with y los casos match de varias líneas terminen con una coma final. Puede ejecutarse como comando independiente tras instalarse desde PyPI o como hook de pre-commit en la configuración de un proyecto.
¿add-trailing-comma es gratuito? ¿Qué licencia tiene?
add-trailing-comma es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿add-trailing-comma sigue mantenido?
Mantenimiento activo. El último commit de add-trailing-comma fue el 4 nov 2026.
¿Para qué puedo usar add-trailing-comma?
Imponer un estilo uniforme para el formato multilínea en una base de código Python. Mantener los diffs al mínimo cuando se añaden o eliminan argumentos en llamadas largas. Automatizar las comprobaciones de formato en un flujo de trabajo de pre-commit.
¿Cómo se instala add-trailing-comma?
Instala la herramienta con pip: pip install add-trailing-comma Opcionalmente, añádela como hook de pre-commit en .pre-commit-config.yaml
¿Dónde consigo add-trailing-comma?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/asottile/add-trailing-comma

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados