Comprendere gli hook di Git

Benvenuto negli hook di Git! Gli hook di Git sono script potenti e personalizzabili che Git esegue automaticamente prima o dopo eventi come il commit, il push o la ricezione di commit inviati.

Li si può considerare checkpoint o azioni automatizzati nel flusso di lavoro Git. Aiutano a imporre gli standard del progetto, automatizzare le attività e integrarsi con altri sistemi.

Ogni repository Git include una directory .git/hooks. Al suo interno si trovano script di esempio per gli hook (di solito con estensione .sample).

Per attivare un hook, basta rimuovere l'estensione .sample e rendere eseguibile il file. Git lo eseguirà al momento opportuno.

• Posizione: .git/hooks/
• File: script shell (Bash, Python, Ruby ecc.)
• Attivazione: rinominare il file e renderlo eseguibile

Gli hook di Git sono suddivisi in due categorie principali in base al luogo in cui vengono eseguiti:

• Hook lato client: vengono eseguiti sul computer locale (ad esempio prima di un commit o di un rebase). Servono per automatizzare il flusso di lavoro personale e applicare le regole in locale.
• Hook lato server: vengono eseguiti sul server Git remoto (ad esempio quando si esegue il push del codice in un repository condiviso). Applicano le regole dell'intero progetto per tutti.

L'hook pre-commit è uno degli hook lato client più comuni. Viene eseguito *prima* che Git crei ufficialmente un commit.

Se lo script pre-commit termina con uno stato diverso da zero, Git annulla il commit. È ideale per attività come:

• analisi statica del codice (controllo degli errori di stile)
• esecuzione di test unitari
• controllo della presenza di file di grandi dimensioni o dati sensibili

L'hook commit-msg viene eseguito *dopo* l'inserimento del messaggio di commit, ma *prima* che il commit venga finalizzato.

È utile per verificare che i messaggi dei commit rispettino convenzioni o formati specifici. Ad esempio, può controllare se:

• il messaggio inizia con l'ID di un ticket (ad esempio [JIRA-123])
• la lunghezza del messaggio rientra nei limiti
• sono presenti o assenti determinate parole chiave

L'hook post-commit viene eseguito *immediatamente dopo* la creazione corretta di un commit.

A differenza di pre-commit o commit-msg, questo hook non può modificare l'esito del commit. Viene spesso usato per notifiche o integrazioni, ad esempio per:

• notificare i membri del team
• aggiornare uno strumento di gestione dei progetti
• avviare una build di integrazione continua (CI), anche se per questo scopo sono più comuni gli hook lato server

Passando agli hook lato server, pre-receive viene eseguito *prima* che qualsiasi riferimento, come branch o tag, venga aggiornato nel repository remoto.

Questo hook è potente per applicare policy fondamentali del repository, ad esempio:

• Impedire i push diretti al branch main
• Assicurarsi che tutti i commit siano firmati
• Convalidare l'identità dell'autore del commit

Se questo hook termina con un codice diverso da zero, l'intero push viene rifiutato.

L'hook post-receive viene eseguito *dopo* che un push ha aggiornato correttamente i riferimenti nel repository remoto.

Come post-commit, questo hook non può rifiutare il push. Viene comunemente utilizzato per:

• Avviare pipeline CI/CD
• Aggiornare strumenti esterni per il monitoraggio dei problemi
• Inviare notifiche email al team
• Eseguire il deploy del codice in un ambiente di staging

Per creare un hook, è sufficiente creare un file con il nome dell'hook, ad esempio pre-commit, nella directory .git/hooks/. Creiamone uno molto semplice:

Dopo aver creato lo script dell'hook, è necessario renderlo eseguibile. In caso contrario, Git non lo eseguirà. Utilizzi il comando chmod nel terminale:

chmod +x .git/hooks/pre-commit

Ora, ogni volta che proverà a eseguire un commit, Git eseguirà questo script!

Gli hook di Git vengono eseguiti in momenti specifici del flusso di lavoro. Comprenderne la tempistica è fondamentale per utilizzarli in modo efficace.

Ha mosso il primo passo nel potente mondo degli hook di Git!

• Gli hook di Git sono script che automatizzano le azioni durante gli eventi di Git.
• Si trovano nella directory .git/hooks/ del repository.
• Gli hook possono essere lato client (sulla macchina locale) o lato server (nel repository remoto).
• Hook fondamentali come pre-commit e pre-receive possono applicare policy bloccando le operazioni.
• Hook come post-commit e post-receive servono per notifiche o integrazioni successive all'azione.

Ora passeremo all'implementazione di esempi pratici di hook specifici!