Quanto mais mexemos com git mais descobrimos coisas mirabolantes que ele pode fazer. Descobri há um tempo uma maneira de organizar/alterar seus commits e que me ajudou bastante.
Editar commits? Pra quê? 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 faz 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:
git commit -m 'Ajustes de CSS e JS no slideshow.'
Aí você lembrou que tinha que atualizar o README (ou preferiu deixar em commits separados) do projeto:
git commit -m 'Atualiza o README.'
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:
git commit -m 'Mais ajustes de CSS e JS no slideshow.'
Se rodássemos um simples log para ver os commits, teríamos algo assim (limitei apenas aos 3 últimos, para o exemplo):
git log --oneline
74e6f3e Mais ajustes de CSS e JS no slideshow.
1ee9572 Atualiza o README.
9afe987 Ajustes de CSS e JS no slideshow.
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?
git rebase -i HEAD~3
Rodamos o comando acima, onde:
- -i => modo interativo.
- ~3 => números de commits para abranger.
Feito isso, aparecerá uma tela similar a esta abaixo (todas as telas citadas abaixo irão abrir no seu editor que estiver setado como default):
pick 74e6f3e Mais ajustes de CSS e JS no slideshow.
pick 1ee9572 Atualiza o README.
pick 9afe987 Ajustes de CSS e JS no slideshow.
# Rebase 5644bdd..74e6f3e onto 5644bdd
#
# Commands:
# p, pick = use commit
# r, reword = use commit, but edit the commit message
# e, edit = use commit, but stop for amending
# s, squash = use commit, but meld into previous commit
# f, fixup = like "squash", but discard this commit's log message
# x, exec = run command (the rest of the line) using shell
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:
pick 1ee9572 Atualiza o README.
pick 74e6f3e Mais ajustes de CSS e JS no slideshow.
pick 9afe987 Ajustes de CSS e JS no slideshow.
E … pronto! Se ocorreu tudo certo, aparecerá uma mensagem mais ou menos assim:
Successfully rebased and updated refs/heads/develop.
Pode ser que conflitos ocorram – nesse caso, o rebase 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:
git rebase -i HEAD~3
Caímos novamente naquela tela com a listagem dos commits. Aí digitamos reword no commit se quisermos editar a mensagem.
pick 9afe987 Ajustes de CSS e JS no slideshow. pick 74e6f3e Mais ajustes de CSS e JS no slideshow. reword 1ee9572 Atualiza o README.
Feito isso, cairemos em outra tela, similar a esta:
Atualiza o README.
# Please enter the commit message for your changes. Lines starting
# with '#' will be ignored, and an empty message aborts the commit.
#
# Date: Mon Dec 15 19:09:30 2014 -0200
#
# rebase in progress; onto 5644bdd
# You are currently editing a commit while rebasing branch 'develop' on '5644bdd'.
#
# Changes to be committed:
# modified: README.md
#
Aí é só taca-le pau na nova mensagem.
Atualiza informações sobre dependências JS no README.
...
E… pronto! \o/ Se rodarmos um log simples, veremos a lista dos commits com a mensagem atualizada:
1ee9572 Atualiza informações sobre dependências JS no README.
74e6f3e Mais ajustes de CSS e JS no slideshow.
9afe987 Ajustes de CSS e JS no slideshow.
Pra não ficar muito extenso, dividi o assunto em dois artigos. No próximo, vamos falar de mesclar commits e dividir um commit em dois.
Obs.:
- Os nomes/estruturas dos arquivos e mensagens de commit são exemplos.
- 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.
Gostou? Escrevi alguma groselha? Quer melhorar? Abra uma issue com a hashtag 1postperweek e vamos conversar.
***
Artigo publicado originalmente em: http://www.raphaelfabeni.com.br/git-alterando-commits-parte-1/