Expresso Livre Comunidade

h1. Comandos básicos do Git

h2. Branches

h3. Listar branches

<pre>

$ git branch

$ git branch -a

O ramo que tiver um '*' é o ramo ativo

</pre> 

h3. Selecionar branch

<pre>

$ git checkout <nome_do_branch>

Ativa o branch como padrão

</pre> 

h3. Criar branch

<pre>

$ git branch <nome_do_branch>

Posicionar no branch a partir do qual será gerado o novo branch. Ex: master

</pre> 

h3. Criar branch local e associar com branch remoto

<pre>

$ git branch --track <nome-branch-local> origin/<nome-branch-remoto>

</pre>

h3. Excluir branch

<pre>

$ git branch -d <nome_do_branch>

Use -D para forçar exclusão do branch mesmo que existam diferenças

</pre>

h3. Mesclar branches

<pre>

$ git merge <nome_branch_mesclar>

Posicionar no branch que receberá o merge

Em caso de conflito fazer git mergetool

</pre> 

h3. Criar um branch a partir de uma tag

<pre>

$ git checkout -b <nome-do-branch> tags/<nome-da-tag>

</pre>

h3. Posicionar um branch em uma revisão

<pre>

$ git reset --hard <hash-da-revisao>

$ git reset --hard HEAD

</pre>

h3. Commitar uma revisão qualquer sobre um branch

<pre>

$ git cherry-pick --edit <hash-da-revisao>

Posicionar primeiramente no branch que receberá o commit

</pre>

h3. Remover um branch do repositório principal

<pre>

$ git push origin --delete <remoteBranchName>

</pre>

------

h2. Operações sobre o repositório

h3. Exibir situação do repositório

<pre>

$ git status

Lista a situação do repositório, mostrando o ramo ativo, posição do ponteiro do ramo em 

relação ao remoto, arquivos modificados e arquivos pendentes de commit

</pre>

h3. Adicionar um servidor remoto

<pre>

$ git remote add <nome-repositorio> <caminho>

Exemplo:

$ git remote add repo-externo https://github.com/ComunidadeExpresso/expressomobile.git

</pre>

h3. Atualizar repositório local com a versão mais recente do repositório remoto

<pre>

$ git pull

Posicionar no branch que receberá as atualizações

</pre>

h3. Enviar dados do branch para o servidor remoto

<pre>

$ git push

Posicionar no branch que será origem do envio

ou:

$ git push <nome-repositorio> <nome_branch>

Exemplo: git push origin master

</pre> 

h3. Ver o log

<pre>

$ git log

$ git log -4

</pre>

h3. Exibir informações do repositório remoto

<pre>

$ git remote show <nome-repositorio>

Exemplo: git remote show origin

</pre>

h3. Atualizar repositório local com últimas atualizações dos remotos

<pre>

$ git fetch --all

</pre>

h3. Salvar as atualizações locais antes de atualizar o repositório

<pre>

$ git pull --rebase

Irá salvar as alterações locais, atualizar o repositório local a partir do remoto e reaplicar as 

atualizações locais

</pre>

h3. Listar dados estatísticos de revisões

<pre>

$ git log --no-merges --author="Nome Completo" --stat --pretty=oneline  db00991..001eb43

</pre>

---------

h2. Operações sobre arquivos

h3. Adicionar arquivos na área de staging 

<pre>

$ git add <arquivo>

$ git add *

$ git add --all

Irá marcar os arquivos modificados como prontos para serem enviados ao repositório local (commit)

</pre>

h3. Remover arquivos do repositório

<pre>

$ git rm <arquivo>

$ git rm <pasta>

</pre>

h3. Reverter a atualização em um arquivo

<pre>

$ git checkout <arquivo>

</pre>

h3. Commit dos arquivos da área de staging

<pre>

$ git commit -m "Issue #<nnnn> - <Comentários das alterações>"

</pre>

Onde <nnnn> é o número da Issue a que se refere o commit

Exemplo:

<pre>

$ git commit -m "Issue #1885 - Implementa o construtor da classe Imap"

O uso do número da issue no comentário do commit fará com que o Redmine anote no histórico da issue 

o número da revisão do commit

Caso uma mensagem de commit esteja fora do padrão, o servidor irá retornar um aviso de erro e o push 

não será efetivado

</pre>

h3. Colocar alterações locais em área temporária

<pre>

$ git stash -u -a

Irá salvar as atualizações locais e retornar o repositório à posição da última sincronização

</pre>

h3. Retornar alterações na área temporária

<pre>

$ git stash pop

$ git stash apply

Pode ser combinado com o identificador do pacote. Por exemplo:

$ git stash pop stash@{1}

</pre>

h3. Visualizar diferenças

<pre>

$ git diff <branch_origem> <branch_destino>

$ git diff <commit> <commit>

$ git diff <arquivo>

</pre>

h3. Aplicar um patch

<pre>

$ patch -p1 -i <arquivo-diff>

Gere o arquivo de diferenças com o comando git diff

</pre>

h3. Corrigir a descrição do último commit antes do push

<pre>

$ git commit --amend

</pre>

h3. Corrigir a descrição do último commit após o push

<pre>

$ git commit --amend

$ git push --force-with-lease

</pre>

h3. Alterar o comentário de uma revisão antiga

<pre>

$ git pull --rebase

$ git rebase HEAD~5

  (mostra 5 revisões e permite navegar sobre elas e alterar o comentário)

$ git push -f

</pre>

h3. Posicionar no commit anterior ao topo

<pre>

$ git reset HEAD~1

</pre>

-----

h2. Tags

h3. Criar uma tag

<pre>

$ git tag <nome-da-tag>

Posicionar no branch que será origem da tag

</pre>

h3. Remover uma tag

<pre>

$ git tag -d <nome-da-tag>

</pre>

h3. Enviar tags para o repositório remoto

<pre>

$ git push --tags

</pre>

h3. Remover uma tag no repositório remoto

<pre>

$ git push --delete origin <nome-da-tag>

</pre>

h3. Listar tags do repositório local

<pre>

$ git tag

</pre>

h3. Listar tags do repositório remoto

<pre>

$ git ls-remote --tags origin

</pre>

------

h2. Softwares com interface gráfica para git

<pre>

* git-gui

* gitk

</pre>