# Les branches

Une branche permet d'essayer sans toucher à la version qui marche.

## Créer, travailler, fusionner

```mermaid
gitGraph
    commit id: "init commit"
    commit id: "commit 2"
    commit id: "whole project"
    branch pathfinding
    checkout pathfinding
    commit id: "Sort find_neighbors de Map"
    commit id: "Ajoute hex_distance"
    checkout main
    commit id: "Corrige le README"
    checkout pathfinding
    commit id: "Ajoute A*"
    checkout main
    merge pathfinding
```

```bash
git switch -c pathfinding     # créer la branche et s'y placer
# ... travailler, committer ...
git switch main               # revenir sur la branche principale
git merge pathfinding         # y intégrer le travail
git branch -d pathfinding     # supprimer la branche fusionnée
```

| Commande | Effet |
| --- | --- |
| `git branch` | Liste les branches, avec une étoile devant la branche courante |
| `git switch nom` | Change de branche |
| `git switch -c nom` | Crée la branche et s'y place |
| `git merge nom` | Intègre `nom` dans la branche courante |

Pour la migration de l'architecture, décrite dans la documentation du jeu, on ouvre une branche par étape : si une étape tourne mal, `main` n'a pas bougé.

## Le conflit

Si deux branches ont modifié les mêmes lignes, Git ne choisit pas à notre place. Il marque l'endroit dans le fichier :

```text
<<<<<<< HEAD
self.max_movement = self.stats["movement"]
=======
self.max_movement = movement
>>>>>>> pathfinding
```

Au-dessus du `=======` se trouve la version de la branche courante. En dessous, celle qu'on fusionne. On édite le fichier pour garder ce qu'on veut, on retire les trois marqueurs, puis :

```bash
git add src/units.py
git commit
```

:::note{title="Un conflit n'est pas une erreur"}

C'est une question que Git pose : deux versions existent, laquelle garder ? Rien n'est perdu tant qu'on n'a pas répondu.

:::
