Renomeando Arquivos no Git

Por que renomear arquivos?

Renomear arquivos é uma prática comum no desenvolvimento de software por diversos motivos:

• Maior clareza: renomear arquivos pode melhorar a clareza da estrutura do projeto, facilitando para os colaboradores entenderem o propósito de cada arquivo;
• Consistência: manter convenções de nomenclatura consistentes em todo o projeto é fundamental para a legibilidade e manutenção;
• Mudanças de funcionalidade: à medida que o projeto evolui, a funcionalidade de certos arquivos pode mudar. Renomeá-los para refletir essas mudanças é essencial para uma documentação precisa.

Comando Git para renomear arquivos

O Git simplifica o processo de renomear arquivos, e é fundamental utilizar comandos do Git para garantir que o histórico de versões permaneça intacto. O comando principal para renomear arquivos é:

git mv old_filename new_filename

Onde old_filename é o nome atual do arquivo e new_filename é o nome para o qual deseja renomear. Esse comando realiza três ações simultaneamente:

• Renomeia o arquivo localmente;
• Adiciona a alteração à área de stage para commit;
• Modifica o arquivo no diretório de trabalho.

Após executar esse comando, é possível realizar o commit das alterações.

Cenário de Exemplo

Primeiro, criar um arquivo de configuração chamado cg.txt contendo uma única linha com um valor de chave secreta de exemplo:

echo "SECRET_KEY=1234" > cg.txt

Agora, verificar o status da árvore de trabalho e da área de stage:

git status

Adicionar este arquivo à área de staging:

git add cg.txt

Em seguida, faça o commit desta adição:

git commit -m "Add config file" 

O commit foi bem-sucedido, mas o nome do arquivo de configuração não está muito claro, então renomeie para config.txt:

git mv cg.txt config.txt

Mais uma vez, verificação do status da árvore de trabalho e da área de preparação:

git status

Como você pode ver, o status mostra que o arquivo foi renomeado de cg.txt para config.txt, e essa alteração já está preparada (staged) e pronta para ser confirmada (committed).

Agora confirme essa alteração:

git commit -m "Rename config file"

O arquivo de configuração foi renomeado com sucesso e o commit foi realizado com êxito.