Git Advanced: Monorepo, Submodules & Workflows · Aula

Ganchos do Git no Cliente

Entenda e implemente ganchos no cliente, como `pre-commit` e `post-merge`, para impor padrões localmente.

Ganchos do Git no Cliente é uma aula grátis de Git Advanced: Monorepo, Submodules & Workflows no CoddyKit. Esta é a aula 1 de 4. Você pode ler a aula completa abaixo gratuitamente — depois pratica ao vivo no navegador com um editor de código integrado e um tutor de IA 24/7. Faz parte do caminho de aprendizado de Git Advanced: Monorepo, Submodules & Workflows, e seu progresso é sincronizado entre a web e o app CoddyKit. O curso de Git Advanced: Monorepo, Submodules & Workflows inclui 4 aulas no total.

Partes desta aula ainda não foram traduzidas e aparecem em inglês.

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!

Perguntas Frequentes

A aula “Ganchos do Git no Cliente” é grátis?

Sim — o texto completo de “Ganchos do Git no Cliente” é grátis para ler aqui na web. Para praticá-la interativamente (um editor de código integrado e um tutor de IA 24/7) e desbloquear o restante do curso de Git Advanced: Monorepo, Submodules & Workflows, atualize para CoddyKit PRO. O curso de Git Advanced: Monorepo, Submodules & Workflows inclui 4 aulas no total.

O que vou aprender em “Ganchos do Git no Cliente”?

Entenda e implemente ganchos no cliente, como `pre-commit` e `post-merge`, para impor padrões localmente. Você pratica Git Advanced: Monorepo, Submodules & Workflows com código prático que executa diretamente no navegador, e um tutor de IA 24/7 responde suas dúvidas enquanto trabalha na aula.

Preciso ter experiência prévia para começar Git Advanced: Monorepo, Submodules & Workflows?

Nenhuma experiência prévia é necessária. Git Advanced: Monorepo, Submodules & Workflows no CoddyKit é estruturado para alunos iniciantes até avançados, então você pode começar aqui ou desde o início e aprender no seu ritmo. Esta é a aula 1 de 4.

Quanto tempo leva a aula “Ganchos do Git no Cliente”?

A maioria das aulas CoddyKit leva cerca de 5–10 minutos. Cada uma é compacta e interativa, então você faz progresso constante e retoma exatamente de onde parou entre web e app.

Posso escrever e executar código nesta aula de Git Advanced: Monorepo, Submodules & Workflows?

Sim. Cada aula de Git Advanced: Monorepo, Submodules & Workflows inclui um editor de código integrado, então você escreve e executa código real direto no navegador e recebe feedback de IA instantaneamente — nenhuma configuração local necessária.

Todas as aulas deste curso

Ganchos do Git no Cliente
Ganchos do Git no Servidor
Configuração e Aliases do Git
Compartilhando hooks com a equipe usando Husky

← Voltar para Git Advanced: Monorepo, Submodules & Workflows