Utilise Bob pour créer un branch, préparer des modifications, générer un message de commit, pousser vers ton dépôt et ouvrir une pull request.

Bob a un support natif pour le contrôle de version Git et te permet de gérer tes modifications de code sans quitter l'IDE.

Dans ce tutoriel, tu utilises Bob pour créer un branch, préparer des modifications de code, générer un message de commit descriptif, pousser les modifications vers ton dépôt et ouvrir une pull request que tu peux réviser et merger.

Prérequis

IBM Bob IDE

Télécharge et installe l'application IBM Bob sur ton ordinateur. Bob est une application IDE autonome et non une extension.

Git

Installe Git pour cloner le dépôt d'exemple.

GitHub

Un compte GitHub et un fork du dépôt d'exemple Galaxium Travels. Pour créer le fork, suis la documentation de GitHub sur le fork d'un dépôt. Configure Git avec des identifiants qui peuvent pousser vers ton fork.

Authentification SSH GitHub

Génère une clé SSH et ajoute-la au ssh-agent pour pouvoir pousser vers ton fork via SSH.

Configurer le projet

Prépare une copie de travail du dépôt.

Forker le dépôt

Tu travailleras depuis un fork du dépôt Galaxium Travels.

Va sur le dépôt Galaxium Travels sur GitHub.
Clique sur le bouton Fork dans le coin supérieur droit de la page.
Sélectionne ton compte GitHub comme propriétaire du fork.

Pour en savoir plus sur le fork d'un dépôt, consulte la documentation de GitHub sur le fork d'un dépôt.

Cloner le dépôt

Dans un terminal, clone le dépôt Galaxium Travels forké. Remplace <your-id> par ton nom d'utilisateur GitHub dans la commande suivante :
```
git clone git@github.com:<YOUR_ID>/galaxium-travels.git
```

Si tu obtiens une erreur d'authentification, assure-toi d'avoir ajouté ta clé SSH au ssh-agent. Consulte la documentation de GitHub pour plus d'informations.

Dans Bob, clique sur Fichier puis sur Ouvrir un dossier.
Navigue vers le répertoire galaxium-travels que tu viens de cloner et ouvre-le.

Passer en mode Agent

Si l'interface de chat de Bob n'est pas déjà ouverte, ouvre-la en cliquant sur l'icône Bob à côté de la barre de navigation ou utilise le raccourci Option + Command + B (Mac) ou Ctrl + Alt + B (Windows).

Panneau de chat Bob ouvert dans IBM Bob IDE

Utilise le mode Agent pour que Bob puisse écrire et modifier du code, exécuter des commandes Git et te guider dans le workflow. Bob demande toujours la permission avant chaque opération sauf si explicitement autorisé.

Clique sur le sélecteur de mode dans le chat agentique et sélectionne Agent, ou tape /agent dans le chat.

Créer un branch

Avant d'apporter des modifications, crée un branch de fonctionnalité pour que ton travail reste séparé de main.

Exécute le prompt suivant :

Crée et bascule vers un nouveau branch nommé update-header.

Bob demande la permission d'exécuter git checkout -b update-header.

Clique sur Approuver pour la tâche pour créer le branch et y basculer.

Apporter une modification de code

Apporte une petite modification pour que Bob ait quelque chose à committer.

Ouvrir le composant Header

Dans le codebase Galaxium Travels, ouvre booking_system_frontend/src/components/layout/Header.tsx.

Modifier le texte du header

Demande à Bob d'apporter la modification de Galaxium Travels à Galaxium Travel Agency. Le préfixe @ ajoute un fichier au contexte de Bob pour qu'il sache exactement quel fichier modifier.

Change le nom du Header de `Galaxium Travels` à `Galaxium Travel Agency`
dans @booking_system_frontend/src/components/layout/Header.tsx

Alternativement, tu peux modifier manuellement le fichier et changer Galaxium Travels en Galaxium Travel Agency.

<span className="text-2xl font-bold bg-cosmic-gradient bg-clip-text text-transparent">
    Galaxium Travel Agency
</span>

Exécuter le workflow Git

Utilise Bob pour préparer, committer, pousser tes modifications, puis ouvrir une pull request.

Préparer tes modifications

Exécute le prompt suivant pour préparer tes modifications :

Prépare toutes les modifications que j'ai faites pour la mise à jour du composant header.

Bob inspecte l'arborescence de travail, identifie les fichiers modifiés et demande la permission d'exécuter git add.

Clique sur Approuver pour la tâche pour autoriser Bob à exécuter la commande.

Committer tes modifications

Exécute le prompt suivant pour committer les modifications préparées :

Committe les modifications préparées avec un message de commit descriptif qui résume ce qui a été ajouté.

Bob examine le diff préparé et génère un message de commit qui décrit l'objectif et la portée des modifications.

Bob affiche une invite de permission dans l'IDE pour exécuter des commandes.

Clique sur Je comprends les risques, puis sur Approuver pour que Bob puisse exécuter git commit.

Pousser les modifications

Exécute le prompt suivant pour pousser ton commit vers le dépôt distant :

Pousse mes modifications vers le dépôt distant.

Bob identifie le branch actuel et le distant, puis demande la permission d'exécuter git push.

Clique sur Approuver pour la tâche pour pousser le commit. Bob confirme dans l'historique du chat que le push a réussi.

Ouvrir une pull request

Exécute le prompt suivant pour créer une pull request :

Crée une pull request pour merger mes modifications dans le branch main. Écris un titre et une description clairs basés sur ce qui a été modifié.

Bob nécessite une authentification GitHub la première fois que tu crées une pull request. Bob ouvre une fenêtre de navigateur pour que tu autorises l'accès. Une fois que tu autorises, Bob ouvre la pull request. Clique sur le lien fourni pour accéder à la pull request dans ton navigateur. Après avoir vérifié le titre et la description, clique sur Créer une pull request.

Bob retourne l'URL de la pull request pour que tu puisses la réviser, la partager ou la merger directement depuis ton navigateur.

Pour que Bob crée des pull requests sans fenêtre de confirmation, installe le GitHub CLI et demande à Bob de l'utiliser pour créer des pull requests.

Résolution de problèmes

Push rejeté ou authentification échouée : Confirme que Git est configuré avec des identifiants qui peuvent pousser vers ton fork.

Le branch update-header existe déjà : Demande à Bob de basculer vers le branch existant ou choisis un autre nom de branch.

La pull request cible IBM/galaxium-travels : Change le dépôt de base vers ton fork avant de créer la pull request.

Nettoyage

Après avoir terminé ce tutoriel, tu peux supprimer les ressources que tu as créées :

Bascule ton clone local de retour vers le branch main.

Ferme ou merge la pull request sur GitHub.

Supprime le branch update-header de ton fork.

Supprime ton fork de Galaxium Travels si tu n'en as plus besoin.

Prochaines étapes

Dans ce tutoriel, tu as appris à utiliser l'intégration Git native de Bob pour gérer tes modifications de code sans quitter l'IDE.

Passe à Standardiser le comportement de Bob pour apprendre à définir des règles persistantes qui contrôlent le comportement de Bob dans chaque conversation et chaque mode.

Créer un commit et une pull request avec Bob