💾 Archived View for gemini.ctrl-c.club › ~gmgall › blog › squash+merge-no-git › index.gmi captured on 2024-07-08 at 23:59:02. Gemini links have been rewritten to link to archived content
⬅️ Previous capture (2023-09-28)
-=-=-=-=-=-=-
Postado em 01.05.2023 23:22
Às vezes, depois de terminar o trabalho num *feature branch* qualquer, você não deseja simplesmente fazer um `merge`. Você quer dar uma "limpada" no histórico primeiro antes de fazer `merge`.
Frequentemente essa "limpeza" se dá na forma de um `squash`, uma junção das alterações inseridas por mais de um *commit*.
Por exemplo: o [repositório desse site](https://github.com/gmgall/gmgall.net) tem um *branch* `main` com histórico relativamente "limpo". Cada *commit* representa um novo conteúdo no site ou uma nova funcionalidade. O [workflow que faz deploy](https://github.com/gmgall/gmgall.net/blob/main/.github/workflows/gh-pages-deployment.yml) do site é disparado cada vez que eu faço um `push` em `main`.
Eu criei um *branch* local chamado `fediverse_comments` para trabalhar na funcionalidade de comentários. Era uma funcionalidade nova, eu não sabia exatamente quantos *commits* eu precisaria fazer. Estava experimentando muita coisa. Então, mesmo sendo local, não quis fazer bagunça em `main`.
{{< figure src="branches_antes.png" alt="Screenshot do gitk mostrando um branch main e um branch fediverse_comments com vários commits desorganizados." title="Branch main \"limpo\" e feature branch fediverse_comments \"sujo\" antes do merge." >}}
Depois de 5 *commits* em `fediverse_comments` (na imagem acima só aparecem 4, mas fiz mais um depois de tirar o *screenshot*) me dei por satisfeito. Era hora do `merge`.
Eu normalmente faria:
Eu achava um pouco "indireto" demais "limpar" um *branch* que em breve estaria em desuso para só depois fazer `merge`, mas era como eu sabia fazer e nunca me questionei muito.
Pois bem, descobri uma forma que me pareceu mais intuitiva semana passada. O comando `merge` já possui uma *flag* `--squash` que faz o que eu precisava.
Então, depois de terminar os trabalhos em `fediverse_comments`, foi só trocar para `main` e dar o seguinte comando:
git merge --squash fediverse_comments
O que esse comando faz é colocar no **working directory** e na **staging area** todas as alterações em `fediverse_comments`. Porém, **não faz `commit`**. Acho isso positivo porque me dá a oportunidade de dar uma última revisada ou de fazer mais alguma alteração no *commit*.
Não precisei nessa situação, então fiz um *commit* de mensagem `Adiciona comentários pelo fediverso` em `main`.
{{< figure src="branches_depois.png" alt="Screenshot do gitk mostrando um branch main com um único commit limpo que traz as alterações de todos os commits sujos de fediverse_comments." title="Branch main \"limpo\" com um único commit com todas alternações feitas em fediverse_comments." >}}
Dessa forma, meu `main` ficou apenas com *commits* "limpos" e poupei a etapa de fazer `squash` no *feature branch*. Devo fazer mais dessa forma no futuro.