# Trabalhando com branchs

## 1. O que é uma branch?

Acho que, sem sombra de dúvidas, quando começamos a mexer com github essa é a primeira dúvida que vem à nossa mente. Afinal, o que são as famosas branches que todos falam? Para explicar isso, eu gostaria de usar um exemplo mais prático, misturado com algo visual. Quando pesquisamos no google o que são branches, a primeira imagem que nos aparece é essa daqui: ![Demonstração do que seriam branches de forma visual](https://wac-cdn.atlassian.com/dam/jcr:389059a7-214c-46a3-bc52-7781b4730301/hero.svg?cdnVersion=1299) E se você nunca teve contato anteriormente com isso, pode ser meio assustador, mas não se preocupe, é mais fácil do que parece. Branch, é o nome dado para o sistema de versionamento que usamos através do Git e Github, para manter controle dos projetos. Vamos supor que estivéssemos construindo uma calculadora juntos, e decidíssemos que você cuidaria de criar a operação de soma e eu a de subtração. ![Fluxo de branches, indicando onde fica a master e a feature](https://atitudereflexiva.files.wordpress.com/2019/10/branch.png?w=300\&h=208) Quando começamos um projeto, sempre nos encontramos na Master, a branch principal, e quando estamos trabalhando sozinhos ou até mesmo em grupo, é interessante que criemos "cópias" de um momento da nossa master, para podermos trabalhar com as novas features (por exemplo uma nova operação matemática), sem afetar o código que já se encontra funcionando. Ou seja, quando você fosse desenvolver a funcionalidade de soma da nossa calculadora, você criaria uma branch à parte da master, com tudo que ela possuísse naquele momento para que pudesse criar os códigos sem se preocupar em afetar o código que já possuíamos naquele momento.

## 2. Como criar uma branch

Se você deseja criar uma branch via linha de comando, basta ir até o seu terminal (caso você seja usuário de Windows, pode usar o powershell ou, se quiser, baixar o Git Bash [aqui](https://gitforwindows.org/)) e digitar dentro da pasta onde está o seu projeto:

```
git branch nome-da-sua-branch
```

E depois para acessar a branch:

```
git checkout nome-da-sua-branch 
```

Caso você queira em qualquer momento saber em qual branch se encontra, basta digitar:

```
git branch
```

E a branch onde você se encontra vai aparecer com um \* ao lado e colorida, dependendo do terminal que você esteja usando. Caso queira ganhar tempo criando a branch e já indo para ela, basta digitar:

```
git checkout -b nome-da-sua-branch
```

E assim que a branch for criada, você já será levado para ela. Vale ressaltar que é uma boa prática darmos o nome às nossas branches com referência à feature que iremos desenvolver nelas, o que no nosso caso, seria "soma", por exemplo.

**Caso você esteja usando o github, basta seguir os seguintes passos** Abra seu repositório depois de realizar o Fork ou criar um repositório novo. ![printscreen da tela inicial do github](https://947787073-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LN2OUGzk2477L_dOw2Z%2Fuploads%2Fgit-blob-a53341db2e52c5cea2b3adad50b68aa01be7194c%2Fcreate-branches-1.png?alt=media) Clique onde está escrito master, e digite lá o nome da branch que deseja criar ![printscreen do momento da criação da branch via github](https://947787073-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LN2OUGzk2477L_dOw2Z%2Fuploads%2Fgit-blob-1a92da4d6b57d572a460b31194f15d7a05df5239%2Fcreate-branches-2.png?alt=media) Depois disso basta clicar em *Create branch*, para que a branch seja criada remotamente.

## 3. Como alternar entre branches

Conforme explicado acima, podemos usar `git checkout nome-da-branch` para alternar entre as branches, mas existe outra forma também, que é:

```
git switch nome-da-branch 
```

Que funciona da mesma forma que a anterior, e pode ser usada para navegar entre as branches. **Para alterar entre as branches no github basta seguir o seguinte passo** ![printsceen do Github demonstrando onde clicar para alternar entre branches](https://947787073-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LN2OUGzk2477L_dOw2Z%2Fuploads%2Fgit-blob-25f82b9040d61232e868b15597f2ef7b70f1f01b%2Falternate-between-branches.png?alt=media) Basta clicar em master, e selecionar entre as branches disponíveis, para qual você deseja ir.

## 4. Como subir uma branch local para um repositório remoto

Antes de subirmos nossa branch, precisamos verificar se nosso repositório local está com o link do repositório remoto configurado. Para isso, digite no terminal:

```
git remote -v
```

Caso você já tenha algum repositório no github conectado a ele, a resposta vai ser parecida com isso (um exemplo com um repositório meu): ![printsceen do Github demonstrando onde clicar para alternar entre branches](https://947787073-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LN2OUGzk2477L_dOw2Z%2Fuploads%2Fgit-blob-68da54a9a234c5dfa4448eca738e19f26914d5ad%2Fgit-remote-v.png?alt=media) No entanto, caso não retorne nada, você pode criar um repositório no seu github e associar a ele através do comando:

```
git remote add origin https://github.com/CarolPinheiro/git-e-github.git 
```

E já vai poder subir suas branches. Para isso, basta inicialmente digitar o comando:

```
git add arquivos-alterados
```

Adiciona os arquivos selecionados para a área de Stage, onde de uma forma simples, você prepara os arquivos para o commit (ou seja, registrar as atualizações e alterações do projeto). Para commitar basta digitar:

```
git commit -m "Mensagem do commit"
```

O **-m** significa 'message', ou seja ali você digita a mensagem que vai registrar aquela alteração, por exemplo "Função de soma criada". Assim que o commit tiver sido feito, basta ir no terminal e digitar:

```
git push
```

E sua branch já está disponível remotamente no github.

## 5. O que é um merge?

Estamos entendendo como trabalhar com branchs, mas se quisermos trazer o trabalho que fizermos em uma branch para outra?

Possuo duas branchs em um repositório GIT, uma chamada "ciclo-de-vida-basico" e a outra "master", estou trabalhando na primeira e após a finalização quero trazer o meu trabalho para "master", pois ela é a principal branch e onde deve ser depositado todo o código que funciona.

Como fazer isso? Através do **merge**, que é quando pegamos um código de uma branch e adicionamos à outra branch, unificando assim as alterações. É importante para manter sua branch atualizada ou para levar seu código para a branch principal.

Para unificar duas branchs, ou seja, fazer com que o conteúdo da primeira seja adicionado à segunda, utilizamos o comando `git merge nome-da-branch-a-ser-mergeada` na branch de destino.

Abaixo um exemplo de **merge**:

1º Fazer checkout na branch de destino. Minha branch de destino é master, então farei: `git checkout master`.

```
git checkout nome-da-branch-destino
```

2º Executar o merge para unificar sua branch na de destino. Como o nome da minha branch é ciclo-de-vida-basico, farei: `git merge ciclo-de-vida-basico`.

```
git merge nome-da-branch-a-ser-mergeada 
```

Esse comando fará que o GIT automaticamente crie um commit com o branch atual e todo o conteúdo da branch origem.

### Exemplo de um merge local:

Após fazer commit das alterações na minha branch de trabalho, estou apta para fazer merge:

![printsceen de um merge local](https://947787073-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LN2OUGzk2477L_dOw2Z%2Fuploads%2Fgit-blob-052fc632ac9ac8419c707a215a437d75057ee185%2Fhands-on-merge.png?alt=media)