Configurar ganchos de pre-commit
Requisitos previos
Antes de continuar, verifica:
- El repositorio Git existe — comprueba la presencia del directorio
.git/. Si no se encuentra, informa al usuario y detente. - El gestor de paquetes está disponible — tras la detección (abajo), verifica que la herramienta correspondiente esté instalada:
- Python: ejecuta
uv --versionpara confirmar queuvestá disponible - JS/TS: ejecuta
npx --versionpara confirmar quenpxestá disponible
- Python: ejecuta
Si los requisitos fallan, informa al usuario qué falta y cómo instalarlo.
Paso 1: Detectar el tipo de proyecto
Revisa la raíz del proyecto en busca de:
| Señal | Resultado |
|---|---|
pyproject.toml presente, sin package.json | Python → lee python-setup.md |
package.json presente, sin pyproject.toml | JS/TS → lee js-setup.md |
| Ambos presentes | Preguntar al usuario (ver abajo) |
| Ninguno presente | Informa al usuario: no se detectó proyecto compatible, detente |
Ambos detectados
Usa AskUserQuestion para ofrecer tres opciones:
- A) Solo Python — sigue
python-setup.md - B) Solo JS/TS — sigue
js-setup.md - C) Ambos — sigue
python-setup.mdincluyendo la sección "Modo ambos lenguajes"
Paso 2: Preguntar al usuario qué comprobaciones activar
Delega al archivo de configuración específico del lenguaje. Cada archivo presenta las comprobaciones disponibles mediante AskUserQuestion.
Si el usuario no selecciona ninguna comprobación: infórmale que no se instalarán ganchos y termina correctamente.
Paso 3: Instalar el framework
Sigue el archivo de configuración específico del lenguaje.
Paso 4: Generar la configuración
Sigue el archivo de configuración específico del lenguaje para crear los archivos de configuración basados en las selecciones del usuario.
Paso 5: Instalar los ganchos
Sigue el archivo de configuración específico del lenguaje para activar los ganchos en git.
Paso 6: Verificar
Ejecuta los ganchos sobre todo el código base para confirmar que funcionan.
Paso 7: Manejar fallos de verificación
- Si se encuentran violaciones de lint/formato, corrígelas automáticamente cuando sea posible (
ruff --fix,ruff format,prettier --write) y vuelve a ejecutar. - Si ocurren fallos de tipo o pruebas, informa al usuario y procede a hacer commit solo de los archivos de configuración de los ganchos.
Paso 8: Hacer commit
Prepara y confirma todos los archivos de configuración creados o modificados.