Git Advanced: Monorepo, Submodules & Workflows · Leçon

Hooks Git côté client

Comprenez et implémentez des hooks côté client comme `pre-commit` et `post-merge` pour faire respecter les normes localement.

Hooks Git côté client est une leçon Git Advanced: Monorepo, Submodules & Workflows gratuite sur CoddyKit. Ceci est la leçon 1 sur 4. Tu peux lire la leçon complète ci-dessous gratuitement — puis la pratiquer en direct dans le navigateur avec un éditeur de code intégré et un tuteur IA 24/7. Elle fait partie du parcours d'apprentissage Git Advanced: Monorepo, Submodules & Workflows, et ta progression se synchronise sur le web et l'application CoddyKit. Le cours Git Advanced: Monorepo, Submodules & Workflows comprend 4 leçons au total.

Certaines parties de cette leçon n'ont pas encore été traduites et s'affichent en anglais.

Intro to Git Hooks

Welcome! In this lesson, you'll learn about Git hooks. These are scripts that Git automatically runs before or after events like committing, merging, or pushing.

Think of them as automated assistants for your Git workflow. They help enforce project standards and automate routine tasks.

Client-Side vs. Server-Side

Git hooks come in two flavors:

Client-side hooks: Run on your local machine. They only affect your personal repository. Examples include `pre-commit` and `post-merge`.
Server-side hooks: Run on the Git server. They affect all pushes to the repository. We'll cover these in a later lesson.

This lesson focuses on client-side hooks and how to use them locally.

Where Hooks Live

All Git hooks are stored in the .git/hooks directory within your repository. When you initialize a new Git repository, Git populates this directory with sample hook scripts.

Let's take a look inside a typical .git/hooks folder:

ls -F .git/hooks/

Activating a Hook

By default, the sample hook scripts end with .sample, making them inactive. To activate a hook, you need to:

Remove the .sample extension from its filename.
Make the script executable.

Let's activate the pre-commit hook by renaming and making it executable:

cd .git/hooks
mv pre-commit.sample pre-commit
chmod +x pre-commit

`pre-commit`: Your Local Guard

The pre-commit hook is one of the most useful client-side hooks. It runs just before Git asks you for a commit message and before the actual commit is created.

If the script exits with a non-zero status, Git aborts the commit. This makes it perfect for:

Running linters (e.g., ESLint, Flake8)
Executing unit tests
Checking for common mistakes (e.g., debug statements)

Example: `pre-commit` for Linting

Here's a simple pre-commit script that checks if any staged files contain the word "TODO". If it finds "TODO", the commit is blocked.

You can edit the .git/hooks/pre-commit file directly to add this content:

#!/bin/sh

# Check for 'TODO' in staged changes
if git diff --cached | grep -q "TODO"; then
  echo "Error: 'TODO' found in staged changes. Please resolve before committing."
  exit 1
fi

Testing the `pre-commit` Hook

Now, let's try to commit a file that contains "TODO". The pre-commit hook should prevent the commit.

First, create a file with "TODO", then try to commit it:

echo "This is a file with a TODO item." > my_feature.txt
git add my_feature.txt
git commit -m "Attempt to commit with TODO"

`post-merge`: After the Merge

The post-merge hook runs immediately after a successful git merge or git pull (which is essentially a fetch followed by a merge or rebase).

It's useful for automating tasks that should happen after your working directory has been updated by a merge, such as:

Installing new dependencies
Rebuilding your project
Updating documentation or symlinks

Example: `post-merge` for Dependencies

Imagine you're working on a project with Node.js. After merging a branch that introduced new dependencies (updated package.json), you'd want to run npm install.

Here's a post-merge script that checks if package.json was changed by the merge and runs npm install if it was:

#!/bin/sh

# Run npm install if package.json changed
if git diff --name-only HEAD@{1} HEAD | grep -q "package.json"; then
  echo "package.json changed, running npm install..."
  # npm install # Uncomment in a real project
  echo "(npm install simulated)"
fi

Hook Challenge

You've learned about client-side Git hooks! Which of the following statements are TRUE about them?

Client-Side Hooks: Recap

Great job! You've successfully explored client-side Git hooks. Here's what we covered:

What they are: Scripts that run automatically at specific Git events.
Where they live: In the .git/hooks directory.
How to activate: Rename from .sample and make executable.
`pre-commit`: Runs before a commit, useful for validation and linting.
`post-merge`: Runs after a merge, good for dependency updates or rebuilding.

Client-side hooks are powerful tools for personal workflow automation and local quality checks!

Questions Fréquemment Posées

La leçon « Hooks Git côté client » est-elle gratuite ?

Oui — le texte complet de « Hooks Git côté client » est gratuit à lire ici sur le web. Pour la pratiquer de manière interactive (un éditeur de code intégré et un tuteur IA 24/7) et déverrouiller le reste du cours Git Advanced: Monorepo, Submodules & Workflows, passe à CoddyKit PRO. Le cours Git Advanced: Monorepo, Submodules & Workflows comprend 4 leçons au total.

Qu'est-ce que j'apprendrai dans « Hooks Git côté client » ?

Comprenez et implémentez des hooks côté client comme `pre-commit` et `post-merge` pour faire respecter les normes localement. Tu pratiques Git Advanced: Monorepo, Submodules & Workflows avec du code pratique que tu exécutes directement dans le navigateur, et un tuteur IA 24/7 répond à tes questions au fur et à mesure que tu avances dans la leçon.

Dois-je avoir de l'expérience pour commencer Git Advanced: Monorepo, Submodules & Workflows ?

Aucune expérience préalable n'est requise. Git Advanced: Monorepo, Submodules & Workflows sur CoddyKit est structuré pour les débutants jusqu'aux apprenants avancés, donc tu peux commencer ici ou depuis le début et avancer à ton rythme. Ceci est la leçon 1 sur 4.

Combien de temps prend la leçon « Hooks Git côté client » ?

La plupart des leçons CoddyKit prennent environ 5–10 minutes. Chacune est courte et interactive, tu progresses régulièrement et tu repiques exactement où tu t'es arrêté sur le web et l'app.

Peux-tu écrire et exécuter du code dans cette leçon Git Advanced: Monorepo, Submodules & Workflows ?

Oui. Chaque leçon Git Advanced: Monorepo, Submodules & Workflows inclut un éditeur de code intégré, tu écris et exécutes du vrai code directement dans ton navigateur et tu reçois des retours IA instantanés — aucune configuration locale requise.

Toutes les leçons de ce cours

Hooks Git côté client
Hooks Git côté serveur
Configuration et alias Git
Partager des hooks avec l’équipe grâce à Husky

← Retour à Git Advanced: Monorepo, Submodules & Workflows