Git: Os novos comandos git restore e git switch

Para facilitar e dividir as responsabilidades, o Git, a partir da versão 2.23.0, incorporou dois novos comandos: o git restore e o git switch.

A confusão do git checkout

Temos um projeto já criado com a branch master e precisamos inserir um novo código. Seguindo as convenções de desenvolvimento temos que criar uma nova branch para inserirmos essas alterações e posteriormente enviamos para uma análise e um possível merge na master.

Nesse cenário o comando git checkout é nosso grande aliado, com ele podemos criar branchs usando a flag -b dessa forma:

E com isso já criamos e selecionamos nossa branch chamada novo-codigo, sendo uma grande facilidade tendo em vista que precisaríamos utilizar dois comandos:

Porém como vocês já devem saber também podemos utilizar o git checkout para alterar entre branch já existentes, poderíamos simplesmente usar o seguinte comando para voltarmos para a branch master do nosso projeto:

Além disso podemos utilizar o git checkout a nível de arquivo, e assim podemos descartar todas as alterações que fizemos em um determinado arquivo.

Assim, podemos desejar descartar todas as alterações do arquivo index.html do nosso projeto, e como estávamos fazendo essas alterações na nossa nova branch novo-codigo então precisamos alternar para ela e depois descartar as alterações, para isso podemos utilizar os dois comandos:

Pronto, agora temos o arquivo index.html sem nenhuma modificação, igual ao estado do último commit. E ainda podemos ter outras utilizações do comando git checkout, vocês podem verificar na documentação todas as possibilidades.

Porém, com podemos perceber o git checkout, faz muitas coisas, tem muitas responsabilidades e isso em um momento pode nos confundir e nos deixar pensando a respeito da utilização do comando, que é bastante semelhante para várias ações.

Devemos estar sempre atentos ao nível de escopo em que vamos utilizar o comando git checkout. Ao nível de escopo de arquivo ele tem um comportamento, ao nível de commit tem um outro comportamento e ao nível de branch outro comportamento.

A divisão de responsabilidades

Pensando nisso, os mantenedores do Git incorporaram dois novos comandos a partir da versão 2.23.0 e ambos vêm com o intuito de dividir responsabilidades, e de serem mais específicos para as funções que se propõem realizar.

Os novos comandos são o git restore e o git switch, veremos nas próximas seções com mais detalhes como esses comandos funcionam e como podemos ir aos poucos utilizando eles no lugar de utilizar somente o git checkout.

Git restore

O git restore é uma nova opção quando estamos trabalhando e precisamos restaurar algum arquivo ou o projeto por completo, e isso o git checkout também faz, porém o git restore é especificamente para trabalhar com essa parte de restauração de arquivos ou projeto ao um ponto anterior que chamamos de fonte de restauração (source).

Em nosso projeto que já está sendo versionando temos o arquivo index.html, e já fizemos três commits:

Os dois últimos commits (Adicionando o Title do site, Adicionado barra de pesquisa) não foram aprovadas e nesse momento precisamos voltar todo o projeto (para isso usamos o ponto final: .) ao estado do primeiro commit (Estrutura inicial do HTML5), poderíamos fazer isso usando o git checkout informando o ID do commit da seguinte forma:

Porém com o git restore também podemos fazer o mesmo, entretanto precisamos informar o ID do primeiro commit como um valor para a flag source, que é o ponto ou fonte de restauração da seguinte maneira:

Mas podemos parar e pensar que usando o comando git restore a sintaxe é mais verbosa, agora temos que passar uma flag (--source) indicando qual o ponto, ou seja qual o estado que desejamos voltar?

A resposta é sim, e isso é uma tendência, antes tínhamos isso não só no Git, mas em muitas outras ferramentas, essa ideia de um comando realizar diversas tarefas. Porém agora os mantenedores estão dividindo as responsabilidades e deixando os comando um pouco mais verbosos, porém semanticamente melhores de identificar cada parte do comando, bem como deixa o mesmo mais organizado e de fácil compreensão para outras pessoas.

git switch

O git switch surge como alternativa quando estamos trabalhando com branchs. Com o git checkout podemos criar novas branchs e também alternamos entre os mesmos, e com o git switch podemos fazer o mesmo.

No nosso projeto precisamos criar uma nova branch com o nome nova-branch no nosso projeto, poderíamos utilizar o seguinte comando:

Agora se executarmos o comando git branch para visualizar a lista de branchs que temos atualmente no projeto temos uma lista como essa:

Note que o asterisco (*) significa qual o branch está em uso no momento, nesse caso é o branch novo-codigo que criamos numa seção anterior. Assim, precisamos alternar para esse “novo-branch”, e para isso podemos utilizar um comando bastante semelhante:

Pronto, já estamos utilizando o nova-branch, para confirmarmos isso podemos executar o comando git branch novamente, dessa vez a saída deve ser com o nova-branch selecionado:

Uma outra possibilidade que temos usando o git switch é usá-lo juntamente com o comando git branch, assim poderíamos criar a branch com o comando git branch e apenas selecionarmos o mesmo com o switch:

O switch também nos fornece um atalho bastante interessante quando precisamos selecionar a branch master, podemos simplesmente utilizar um sinal de subtração ( - ) no lugar do nome do branch:

Se executarmos o comando git branch podemos perceber que estamos novamente com a branch master selecionada:

Mais um possibilidade que o switch disponibiliza é alternamos para um branch remoto, no caso um branch que nosso projeto não tenha localmente ainda, então primeiro precisamos executar o comandogit fecth para atualizarmos as informações do projeto remoto:

E logo em seguida usamos o comando com a seguinte sintaxe:

Conclusão

Assim, podemos entender que a divisão das responsabilidades do comando git checkout com os comandos git restore e git switch faz com que os comandos fiquem mais claros e mais bem definidos.

Torna mais fácil o aprendizado, bem como o entendimento acerca das tarefas que cada um pode executar. E são de grande ajuda quando estamos versionando código, seja em um projeto pequeno, ou em um grande projeto de uma grande empresa. Entender e saber como utilizar esses novos recursos é muito importante. Ainda não sabemos com certeza mas talvez o comando git checkout possa nem existir em versões futuras do Git!

Gostou do artigo e quer saber mais sobre Git, aqui na alura temos o Curso de Git e Github: Controle e compartilhe seu código que é um curso introdutório e também o Curso de Git e Github: Estratégias de ramificação, Conflitos e Pull Requests que é mais avançado e trata também de GitHub, e como usar essa poderosa ferramenta a nosso favor.