Quanto mais mexemos com git mais descobrimos coisas mirabolantes que ele pode fazer. Descobri há um tempo atrás uma maneira de organizar/alterar seus commits e que me ajudou bastante.
Editar commits? Pra que? Pois é. Alguns casos:
- a mensagem do commit está errada ou não faz sentido;
- a ordem dos commits não está legal em relação à história;
- existe mais de um commit que fazem coisas similares (senão a mesma coisa).
- um commit agrupou muito código diferente e faz sentido dividi-lo em commits menores.
Um exemplo rápido
Um exemplo simples e rápido. Imagine que no seu projeto você fez uma alteração e fez um commit:
Aí você lembrou que tinha que atualizar o README (ou preferiu deixar em commits separados) do projeto:
Então você sai pra pegar um chá (não bebo café ¯\_(ツ)_/¯) e no meio do caminho lembra que faltou uma alteração de CSS. Aí você volta, faz a alteração e comita novamente:
Se rodássemos um simples log para ver os commits teríamos algo assim (limitei apenas aos 3 últimos, para o exemplo):
Se o projeto é pequeno/pessoal, até daria pra deixar assim, no entanto, quando estamos trabalhando com outras pessoas em um projeto grande, pode ficar meio estranho no conjunto da história. É aí que entra o interactive rebase. Com ele conseguimos alterar commits em um mesmo branch. Paremos de falar e vamos ao que interessa.
Como faço?
Rodamos o comando acima onde o:
-i=> modo interativo.~3=> números de commits para abranger.
Feito isso aparecerá uma tela similar a essa abaixo (todas telas citadas abaixo irão abrir no seu editor que estiver setado como default):
Reordenando commits
No exemplo acima poderíamos alterar a ordem dos commits deixando juntos os que são relacionados ao mesmo tema por exemplo. Pra isso, na tela anterior, edite a ordem copiando e colando as linhas na ordem que preferir. Para o exemplo, poderíamos algo mais ou menos assim:
E … pronto! Se Se ocorreu tudo certo aparecerá uma mensagem mais ou menos assim:
Pode ser que conflitos ocorram, nesse caso o rebase para até que você o corrija. Depois é só rodar um git rebase --continue para seguir ou um git rebase --abort se quiser desistir de tudo.
Alterando mensagens
Outra coisa beeeem bacana é a possibilidade de alterar a mensagem de um commit. Voltando ao nosso exemplo, agora queremos trocar a mensagem do commit do README.
Rodamos novamente o rebase:
Caímos novamente naquela tela com a listagem dos commits. Aí digitamos reword no commit que quisermos editar a mensagem.
Feito isso, caíremos em outra tela, similar a essa:
Aí é só taca-le pau na nova mensagem.
E… pronto! \o/ Se rodarmos um log simples, veremos a lista dos commits com a mensagem atualizada:
Forçando o push
Como bem lembrado pelo Cícero Pablo, quando utilizamos o rebase interativo, caso você já tenha um repositório com uma história de commits, será preciso fazer pushcom a flag --force.
Tem mais..
Pra não ficar muito extenso, dividi o assunto em 2 posts. No próximo vamos falar de mesclar commits e dividir um commit em dois. Aqui você consegue ler a segunda parte do artigo.
Obs.
- Os nomes/estrutura dos arquivos e mensagens de commit são a títulos de exemplo.
- Usei a palavra tela para referenciar cada retorno do terminal.
- Uso por padrão como editor o vim, o que facilita a edição das •telas• que comentei no tópico anterior.