Configurar Pre-Commit Hooks
Pré-requisitos
Antes de prosseguir, verifique:
- Repositório Git existe — verifique se o diretório
.git/está presente. Caso não encontre, informe o usuário e pare. - Gerenciador de pacotes disponível — após a detecção (abaixo), confirme se a ferramenta relevante está instalada:
- Python: execute
uv --versionpara confirmar queuvestá disponível - JS/TS: execute
npx --versionpara confirmar quenpxestá disponível
- Python: execute
Se os pré-requisitos falharem, informe o usuário sobre o que está faltando e como instalar.
Passo 1: Detectar Tipo de Projeto
Verifique a raiz do projeto em busca de:
| Sinal | Resultado |
|---|---|
pyproject.toml presente, sem package.json | Python → leia python-setup.md |
package.json presente, sem pyproject.toml | JS/TS → leia js-setup.md |
| Ambos presentes | Pergunte ao usuário (veja abaixo) |
| Nenhum presente | Informe o usuário: nenhum projeto suportado encontrado, pare |
Ambos detectados
Use AskUserQuestion para oferecer três opções:
- A) Apenas Python — siga
python-setup.md - B) Apenas JS/TS — siga
js-setup.md - C) Ambos — siga
python-setup.mdincluindo a seção "Modo Ambos os Idiomas"
Passo 2: Perguntar ao Usuário Quais Verificações Ativar
Delegue ao arquivo de configuração específico do idioma. Cada arquivo apresenta as verificações disponíveis via AskUserQuestion.
Se o usuário não selecionar nenhuma verificação: informe que nenhum hook será instalado e encerre graciosamente.
Passo 3: Instalar Framework
Siga o arquivo de configuração específico do idioma.
Passo 4: Gerar Configuração
Siga o arquivo de configuração específico do idioma para criar o(s) arquivo(s) de configuração com base nas seleções do usuário.
Passo 5: Instalar Hooks
Siga o arquivo de configuração específico do idioma para ativar os hooks no git.
Passo 6: Verificar
Execute os hooks em todo o código-fonte para confirmar que funcionam.
Passo 7: Tratar Falhas de Verificação
- Se forem encontradas violações de lint/formatação, corrija automaticamente quando possível (
ruff --fix,ruff format,prettier --write) e reexecute. - Se ocorrerem falhas de tipo ou teste, informe o usuário e prossiga com o commit apenas dos arquivos de configuração dos hooks.
Passo 8: Commit
Prepare e faça commit de todos os arquivos de configuração criados/modificados.