✎ bzr [Wiki ubuntu-fr]

Vous affichez une ancienne révision du document ! Si vous l'enregistrez, vous créerez une nouvelle version avec ce contenu.

----

====== Bazaar ======

Bazaar est un [[wpfr>logiciel de gestion de versions]] créé par Canonical, il a pour but de garder des traces des différents développements effectués sur un projet communautaire, mais peut également être utilisé à des fins personnelles pour gérer les différentes versions d'un document (LaTeX par exemple). Un des avantages de Bazaar est qu'il est disponible aussi bien sous GNU/Linux que sous Windows.

===== Installation =====

==== Version standard ====

Bazaar est présent de base dans les dépôts officiels, il suffit donc d'[[:tutoriel:comment_installer_un_paquet|installez le paquet]] **[[apt://bzr|bzr]]**. Il existe aussi [[bzr-gtk]], une interface graphique à Bazaar. À partir de Ubuntu 10.04 LTS (Lucid Lynx), les utilisateurs se tourneront vers [[:bzr-explorer|Bazaar Explorer]].

==== Dernière version ====

Si on veut la dernière version il existe des paquets fournis par les développeurs dans [[LaunchPad]]. Leur PPA se trouve [[https://launchpad.net/~bzr/+archive/ppa|ici]]

[[:tutoriel:comment_modifier_sources_maj|Modifiez vos sources de mises à jour]] pour y ajouter le dépôt suivant :
<file>
deb http://ppa.launchpad.net/bzr/ppa/ubuntu intrepid main
deb-src http://ppa.launchpad.net/bzr/ppa/ubuntu intrepid main
</file>

Ou aller sur leur [[https://launchpad.net/~bzr/+archive/ppa|PPA]], un petit menu déroulant permet d'avoir le dépôt correspondant à votre version d'Ubunutu.

Ajouter la clé du PPA à votre trousseau
<code>
sudo apt-key adv --recv-keys --keyserver keyserver.ubuntu.com ece2800bacf028b31ee3657cd702bf6b8c6c1efd
</code>

[[:tutoriel:comment_modifier_sources_maj#recharger_la_liste_des_paquets|Rechargez la liste des paquets]], puis [[:tutoriel:comment_installer_un_paquet|installez le paquet]] **[[apt://bzr|bzr]]**.

===== Utilisation =====
==== Gérer les dépot ====
Avant de commencer à utiliser Bazaar, il faut lui demander de créer un nouveau dépôt.
<code>mkdir nom_depot
cd nom_depot
bzr init</code>
Dans le répertoire nom_depot, vous aurez alors un dossier caché .bzr, c'est dans ce dossier que Bazaar stockera les différentes révisions et informations du projet.
Vous pouvez aussi récupérer un dépôt déjà existant et travailler à partir de celui-ci en faisant
<code>bzr branch bzr://...</code>
Vous pourrez ensuite (si vous avez les droits suffisants sur le dépôt distant), envoyer vos changements avec bzr push.

==== État du dépot ====
<code>bzr diff
bzr diff fichier1 fichier2
bzr diff -r commit1 -r commit2</code>
Permet de comparer 2 versions. Vous pourrez ainsi voir les changements effectués. Si vous avez des changements pas encore commités, la commande bzr diff affichera les modifications effectuées depuis le dernier commit.
<code>bzr status</code>
Permet d'affichier la liste des fichier modifiés et non commités.
<code>bzr log</code>
Liste les commits effectués dans le dépôt. Vous pourrez ainsi voire les modifications qui ont été faites.

==== Gestion des fichiers ====
<code>bzr add nom_fichier</code>Cette commande indique à Bazaar que le fichier nommé nom_fichier devra être versionné.
<code>bzr mv nom_fichier nouvelle_destination</code>Déplace le fichier.
<code>bzr rm nom_ficher</code>Supprime le fichier (à utiliser avec l'option --keep) si vous voulez supprimer le fichier du dépot sans le supprimer du disque dur

==== Gestion des commits ====
<code>bzr commit fichier1 fichier2 -m "Description du commit"</code>Crée un commit contenant fichier1 et fichier2. Ces fichiers auront dûs être au préalable ajoutés au dépôt avec la commande bzr add. L'argument -m permet de spécifier une description au commit. Si il n'est pas utilisé, un éditeur de texte s'affichera vous demandant d'entrer une description.
<code>bzr commit</code>Créé un nouveau commit contenant tous les changements effectués sur les fichiers suivis (ceux ajoutés avec bzr add).

==== Commandes d'annulation ====
Bazaar dispose de commandes permettant d'annuler des changements effectués. Attention, ces annulations ne sont pas réversibles !
<code>bzr revert fichier1 fichier2</code>Annule les changements effectués dans fichier1 et fichier2 depuis le dernier commit
<code>bzr revert fichier1 fichier2 -r numéro_révision</code>Restaure fichier1 et fichier2 tel qu'ils étaient lors de la révision spécifiée par l'argument -r.
Par sécurité, Bazaar créé un fichier de sauvegarde nommé nom_fichier.~#~ (avec # un nombre). Si vous ne voulez pas de sauvegarde, utilisez l'argument --no-backup.

===== Utilisation avancée =====
Généralement, quand on utilise Bazaar, on ne travaille pas seul mais en équipe. Voici les principales commandes qui vous aiderons à utiliser Bazaar dans de telles situations.
Ici, nous supposerons qu'on travaille avec deux dépôts Bazaar distincts nommés respectivement moi et bob. Le dépôt moi est votre dépôt, bob est celui d'une autre personne, admettons qu'il est situé à l'adresse %%bzr://bob.com/bob%%.

==== Gestion des branches ====
Bazaar permet une gestion des branches, et des merge (fusion de branches). Les branches permettent d'avoir simultanément plusieurs versions de votre programme dans votre dépôt Bazaar. C'est très utile, par exemple pour développer une nouvelle fonctionnalité, tout en gardant la branche principale intacte. Ainsi, vous pouvez toujours faire des changements dans la branche principale (corrections de bugs par exemple), tout en développant en parallèle une nouvelle fonctionnalité.
<code>bzr branch . test</code>
Créé une nouvelle branche nommée "test" à partir du dépôt courant. Vous aurez alors un nouveau répertoire, nommé "test" qui contiendra toutes les sources versionnés du projet. Pour utiliser cette nouvelle branche, il suffit de faire des modifications dans le dossier "test", et de commiter les changements.
<code>bzr merge nom_branche</code>
Fusionne la branche courante avec la branche nommée "nom_branche". Il se peut qu'il y ait des conflits et que Bazaar ne soit pas capable de les résoudre tout seul. Les conflits apparaissent généralement lors de changements divergents au même endroit dans un fichier.
Dans ce cas, Bazaar laisse un marqueur dans le fichier contenant le conflit, et crée trois nouveaux fichiers contenant les différentes versions du fichier.
Pour voir les fichiers contenant des conflits, faites
<code>bzr conflicts</code>
Vous devez alors modifier le fichier pour résoudre le conflit et enlever le marquer. Une fois celà fait, il faut faire
<code>bzr resolve</code>
Si tous les conflits ont étés résolus, Bazaar vous l'indiquera par le message "All conflicts resolved."

==== Récupération des changements ====
Imaginons que Bob ait implémenté une nouvelle fonctionnalité. Vous voulez naturellement l'intégrer à votre dépôt.
<code>bzr pull bzr://bob.com/bob</code>
Cette commande va récupérer les changements effectués par bob, et les merger avec votre dépôt.

===== Intégration de Bazaar dans votre éditeur =====
Bazaar peut être intégré à différents éditeurs, comme [[eclipse|Eclipse]], [[emacs|Emacs]] ou [[vim|Vim]]. Pour plus de détails, voir la section [[#Liens]].

===== Utilisation d'une interface graphique =====
Plusieurs interfaces graphiques existent pour utiliser Bazaar. On peut citer l'interface par défaut [[bzr-explorer|Bazaar Explorer]] ainsi que [[bzr-gtk|bzr-gtk]], l'ancienne interface par défaut. Pour plus de détails, voir la section [[#Liens]].

===== Liens =====

* **(en)** [[http://bazaar-vcs.org/|Site officiel]]
  * **(en)** [[https://launchpad.net/bazaar|Bazaar sur Launchpad.net]]
  * **(fr)** [[http://bazaar-vcs.org/fr/IntroductionABzr|Introduction à Bazaar]]
  * **(en)** [[http://wiki.bazaar.canonical.com/3rdPartyTools/#GUI%20Front-ends|Liste d'interfaces graphiques]]
  * **(en)** [[http://wiki.bazaar.canonical.com/3rdPartyTools#Editor/IDE%20Integration|Liste d'éditeurs pouvant intégrer Bazaar]]

----
//Contributeurs principaux : **[[utilisateurs:geenux|Geenux]]**, [[utilisateurs:7he]].//

Merci de recopier le code ci-contre pour prouver que vous êtes humain : A F F M S Merci de laisser ce champ vide :

Résumé

Note : En modifiant cette page, vous acceptez que le contenu soit placé sous les termes de la licence suivante : CC Paternité-Partage des Conditions Initiales à l'Identique 3.0 Unported