Neste laboratório, aprenderemos como determinar se um diretório está sendo rastreado pelo Git. Exploraremos o conteúdo de um repositório Git usando o comando git ls-tree para inspecionar os arquivos e diretórios em um commit específico.
Além disso, utilizaremos o comando git status para verificar o status atual de rastreamento dos arquivos dentro de nosso repositório e entender como o Git lida com diretórios vazios.
Nesta etapa, exploraremos o conteúdo de nosso repositório Git usando o comando git ls-tree. Este comando nos permite visualizar o conteúdo de um objeto tree (árvore), que representa o estado de um diretório em um commit específico.
Primeiro, certifique-se de estar no seu diretório my-time-machine:
cd ~/project/my-time-machineAgora, vamos usar git ls-tree para ver o conteúdo do último commit. Usaremos HEAD para nos referir ao último commit:
git ls-tree HEADVocê deve ver uma saída semelhante a esta:
100644 blob a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6q7r8s9 message.txtVamos analisar essa saída:
100644: Este é o modo do arquivo, indicando que é um arquivo regular.blob: Isso indica o tipo de objeto. Um objeto blob armazena o conteúdo de um arquivo.a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6q7r8s9: Este é o identificador único (hash SHA-1) do objeto blob que armazena o conteúdo de message.txt. Seu hash será diferente.message.txt: Este é o nome do arquivo.O comando git ls-tree é útil para inspecionar o conteúdo de um commit específico sem fazer o checkout do commit inteiro. Ele mostra os arquivos e diretórios que foram rastreados pelo Git naquele ponto no tempo.
Pense nisso como olhar dentro de uma cápsula do tempo específica (commit) para ver exatamente quais arquivos foram incluídos e quais eram suas impressões digitais únicas (hashes blob). Esta é uma maneira poderosa de entender a estrutura e o conteúdo do histórico do seu projeto.
Nas etapas anteriores, criamos um arquivo e o committamos em nosso repositório Git. Agora, vamos usar o comando git status novamente para ver o estado atual do nosso repositório e confirmar que nosso arquivo está sendo rastreado.
Certifique-se de ainda estar no diretório ~/project/my-time-machine:
cd ~/project/my-time-machineAgora, execute o comando git status:
git statusVocê deve ver uma saída semelhante a esta:
On branch master
nothing to commit, working tree cleanEsta saída nos diz algumas coisas importantes:
On branch master: Estamos atualmente na branch master, que é a linha do tempo principal do nosso projeto.nothing to commit, working tree clean: Esta é a parte chave. Significa que não há alterações em nosso diretório de trabalho que ainda não foram committadas. O Git está rastreando todos os arquivos que devem ser rastreados, e não há arquivos novos ou modificados que precisem ser adicionados ou committados.Este é o estado desejado quando você terminou de fazer alterações e committá-las. Ele confirma que o Git está ciente do estado atual do seu projeto e que tudo está atualizado em seu repositório.
Comparar esta saída com a saída de git status que vimos antes de criar e commitar message.txt destaca a diferença entre um repositório vazio, um repositório com arquivos não rastreados e um repositório limpo com arquivos rastreados.
Entender git status é crucial porque é sua principal ferramenta para saber o que está acontecendo em seu repositório e quais ações você precisa tomar (como adicionar ou commitar arquivos).
Nesta etapa, exploraremos como o Git lida com diretórios vazios. Este é um ponto comum de confusão para iniciantes, pois o Git se comporta de maneira diferente com diretórios em comparação com arquivos.
Primeiro, certifique-se de estar no seu diretório ~/project/my-time-machine:
cd ~/project/my-time-machineAgora, vamos criar um novo diretório vazio dentro do nosso projeto:
mkdir empty-folderCriamos o diretório. Agora, vamos verificar o status do nosso repositório usando git status:
git statusVocê deve ver uma saída semelhante a esta:
On branch master
nothing to commit, working tree cleanObserve que o Git não relata empty-folder como um diretório não rastreado. Isso ocorre porque o Git rastreia o conteúdo do arquivo, não os diretórios em si. Um diretório vazio não tem conteúdo para rastrear.
Este é um conceito importante no Git. Se você precisar incluir um diretório vazio em seu repositório, a solução comum é colocar um arquivo dummy dentro dele. Uma prática comum é criar um arquivo chamado .gitkeep (embora o nome não importe, é apenas uma convenção).
Vamos criar um arquivo .gitkeep dentro de empty-folder:
touch empty-folder/.gitkeepAgora, vamos verificar o git status novamente:
git statusDesta vez, você deve ver:
On branch master
Changes not staged for commit:
(use "git add <file>..." to update what will be committed)
(use "git restore <file>..." to discard changes in working directory)
untracked files present (use "git add" to track)
Untracked files:
(use "git add <file>..." to include in what will be committed)
empty-folder/Agora, o Git vê o empty-folder/ porque ele contém um arquivo (.gitkeep) que pode ser rastreado.
Isso demonstra que o Git rastreia a presença de arquivos dentro de diretórios, em vez dos próprios diretórios. Para incluir um diretório no histórico do seu repositório, ele deve conter pelo menos um arquivo rastreado.
Neste laboratório, aprendemos como verificar se um diretório e seu conteúdo são rastreados pelo Git. Usamos o comando git ls-tree HEAD para inspecionar o conteúdo do último commit, entendendo que ele exibe os arquivos rastreados e seus objetos blob e hashes associados. Este comando fornece um snapshot do estado do repositório em um commit específico.
Também utilizamos o comando git status para verificar o status atual de rastreamento dos arquivos dentro do repositório, confirmando que os arquivos committados são de fato rastreados pelo Git. Por fim, exploramos como o Git lida com diretórios vazios, descobrindo que o Git não rastreia diretórios vazios diretamente, mas sim os arquivos dentro deles.
