Introduction à Mercurial

Si vous êtes seul, vous devez initier votre dépôt mercurial. Pour cela, placez-vous dans le répertoire contenant les sources à versionner désiré et tapez la commande suivante :

hg init

Cette commande aura pour effet de rajouter un dossier (.hg). C'est ce répertoire qui contient tout l'historique de votre dépôt.

Imaginons maintenant que vous souhaitiez récupérer le contenu d'un dépôt existant, par exemple celui-ci : http://www.selenic.com/repo/hello. Ce dépôt est un dépôt mis à disposition par la société selenic afin de tester les capacités de mercurial. (tutoriel officiel)
Il vous suffit de faire :

hg clone http://www.selenic.com/repo/hello [NomQueVousVoulez]

Le paramètre [NomQueVousVoulez] est optionnel. Il vous permet de choisir le nom de votre copie locale, si vous ne le précisez pas, le nom utilisé sera celui du dépôt d'origine.
Sur l'exemple, ce sera « hello ». Tout comme lors de la création d'un dépôt, vous retrouverez le dossier .hg. Contrairement à Subversion, ce dossier contient tout l'historique des modifications, il n'y a pas d'autres dossiers servant d'historique. C'est grâce à cet historique que l'on peut faire un « commit » de ses modifications sans avoir le serveur en face. Enfin, il est possible de cloner un dépôt local, il suffit d'exécuter la commande suivante :

hg clone depot-existant chemin/vers/nouveauDepot

Avec subversion, pour mettre à jour sa copie locale, on exécute la commande :

svn checkout

depuis le répertoire de la copie locale. Avec mercurial, on effectue la commande suivante depuis le dépôt local :

hg pull [dépôt à utiliser]

Là encore, il y a une différence avec subversion. Cette commande sans paramètre va chercher les dernières modifications du dépôt qui a servi à la création du dépôt local.
Si l'on reprend l'exemple avec le clone du dépôt de selenic, la commande ira télécharger les modifications sur le site de selenic. Il est possible de mettre à jour un dépôt, depuis un autre dépôt que celui ayant servi à la création du clone. Il suffit de préciser son emplacement.
Précision importante : la commande hg pull mettra à jour uniquement le dossier .hg. Si vous souhaitez mettre à jour les fichiers de la copie de travail, il faut utiliser la commande suivante :

hg update

Enfin, si vous avez fait des modifications dans votre dépôt local, il est nécessaire de lancer la commande :

hg merge

Cette commande va fusionner les dernières modifications distantes avec les vôtres. En cas de conflit, mercurial ouvrira l'outil dédié à la fusion des fichiers.
Puis vous devrez livrer les modifications dans votre dépôt local avec la commande :

hg commit

Ici, nous allons nous retrouver en terrain connu. Pour ajouter des fichiers dans le dépôt, il suffit de faire un :

hg add [fichier/dossiers]

Si on ne précise pas de nom de fichiers/répertoire, tous les fichiers inconnus du dépôt seront ajoutés.

Pour supprimer des fichiers, il faut utiliser la commande hg remove.

hg remove fichiers/dossier

Une fois les fichiers rajoutés/modifiés/supprimés, il faut utiliser la commande hg commit.

hg commit [-u username] [-m "un message"] -v

Cette commande crée un « changeset » dans votre dépôt. Dans mercurial, on n'utilise pas le terme de révision, mais de changeset (tout comme dans Git ou dans bazaar). Un changeset est unique parmi tous les dépôts d'un projet.
Cependant, il existe un numéro de révision plus classique, mais qui dépend du dépôt. Le numéro de révision est indiqué devant le changeset.

L'option -v permet d'afficher le nouveau changeset.

Note : ici, je n'ai pas configuré avec un nom d'utilisateur mercurial, d'où l'avertissement.
Note 2 : le message est optionnel si vous avez configuré un éditeur de texte. Ce dernier sera lancé automatiquement. Si vous n'en avez pas configuré, l'éditeur de texte par défaut sera lancé (Notepad pour windows, vi pour les unix).

Comme indiqué plus haut, la command hg commit livre les modifications dans le dépôt local. Alors qu'avec Subversion, il n'est pas possible de faire « svn commit » sans dépôt central. Avec ce mode, il est simple d'enregistrer ces modifications lorsque l'on ne dispose pas de connexion réseau.
Une fois la connexion réseau rétablie, il suffit de faire une mise à jour de son dépôt local (hg pull), puis de fusionner son travail avec les autres modifications (hg update -m + hg commit).

Mercurial propose des commandes particulières afin de rattraper des erreurs provenant d'un « hg commit » ou d'un « hg remove » malencontreux.

Pour annuler des modifications non livrées par un hg commit ou pour restaurer des fichiers à une révision antérieure, il faut utiliser la commande

hg revert [--all] [-r revision] [-n][ Fichiers]

L'option --all annule tous les changements survenus dans le dépôt.
L'option -r permet de revenir à une révision particulière. Si vous ne la précisez pas cette option, seules les modifications non livrées seront annulées.
L'option -n permet de voir ce que ferait la commande.
Enfin il est possible de préciser les répertoires ou les fichiers qui seront la cible de la commande.
Les fichiers modifiés par la commande sont sauvegardés avec le suffixe .orig avant application de la restauration.

Si vous vous êtes trompé et que vous avez déjà exécuté la commande « hg commit ». Vous pouvez utiliser la commande hg rollback.
Cette commande annule la dernière transaction. Les opérations créant une transaction sont « commit », « import », « push », « pull ».
Si vous venez d'utiliser la commande « hg commit », l'utilisation de cette commande supprimera cette transaction. Il n'est pas possible d'annuler l'effet de cette commande.

Tout comme la commande svn log, la commande hg log vous permet d'afficher l'historique d'un dépôt ou d'un fichier.

hg log [-r rev/changeset] [-f] [-u nomUser] [...] [File]

Voici une petite explication de ces options :

• l'option -r : vous permet d'afficher le détail d'une révision ou d'un changeset. Il existe des révisions spéciales comme la révision « tip » (la révision la plus récente). Vous pouvez spécifier le nom d'un tag ;
• l'option -f : vous permet de suivre dans l'historique les opérations de copie et de renommage ;
• l'option -u : vous permet de lister les livraisons effectuées par l'utilisateur spécifié.

Je ne vous n'ai présenté que quelques options de cette commande, il en existe beaucoup d'autres.
Il existe une extension (glog) qui vous permet d'avoir un historique avec un graphe en ASCII.

En général avec Subversion, lorsque vous souhaitez créer une étiquette (ou un tag), vous créez une copie de votre branche de développement vers l'arborescence tagsliens vers le 'svn red book', chapitre sur les tags.
En fait les tags dans svn sont plus une convention. Dans mercurial, les tags sont définis par un changeset particulier et un nom. Pour créer un tag il suffit de taper la commande suivante :

hg tag [-l ][-u userName] [--remove] [-m "un message particulier"] [-r "une révision"] nomDuTag

Comme vous pouvez le voir, il est possible de spécifier un message pour la livraison. Si vous ne le spécifiez pas, il aura cette forme : « Added tag NomDuTag for changeset b1e4171a0973 ».
Si vous avez besoin de supprimer un tag, l'option --remove vous sera utile, un « commit » sera là aussi effectué.
l'option « -l » est particulière, elle permet de créer un tag local. C'est-à-dire que ce dernier ne sera pas cloné comme le reste de l'historique du dépôt.

Vous savez comment créer un tag, mais pour en faire l'inventaire que faut-il faire ? La commande hg tags répond à cette demande.

hg tags [-v]

L'option « -v » permet d'afficher une troisième colonne où apparaît la mention « local » pour les tags locaux.
Tous les tags sont référencés dans le fichier .hgtags. Il est possible de rajouter des tags en modifiant manuellement le fichier .hgtags et en livrant ces modifications dans le dépôt.

Après avoir récupéré la version en cours de développement, effectué des modifications, livré ces modifications, il faut publier ces modifications.

III-H-1. La commande hg push▲

Voici la commande qui permet de faire remonter les modifications de votre dépôt vers un autre.

 

Sélectionnez

hg push

va par défaut, faire remonter les modifications de votre dépôt dans le dépôt parent.

 

Sélectionnez

hg push http://unEmplcamentOuReseau

permet d'indiquer le dépôt de destination. Mercurial, par défaut, vous avertira si vous tentez de pousser des modifications vers un dépôt qui n'a aucun lien avec le vôtre :

 

Sélectionnez

hg push ../growl
pushing to ../growl/
searching for changes
abort: repository is unrelated

Ce contrôle est aussi fait pour la commande hg pull.

III-H-2. La commande hg export▲

hg export

svn export

hg export révision > monpatch.diff

# HG changeset patch
# User Matt Mackall <mpm@selenic.com>
# Node ID b8daa9444f08a98a0d91d922dbeba05ab3247169
# Parent 82e55d328c8ca4ee16520036c0aaace03a5beb65
Voici l'expression de la grande joie de l'existence de Mercurial


diff -r 82e55d328c8c -r b8daa9444f08 hello.c
--- a/hello.c Fri Aug 26 08:21:28 2005
+++ b/hello.c Sun Aug 28 09:10:28 2005
@@ -12,5 +12,6 @@
int main(int argc, char **argv)
{
printf("hello, world!\n");
+ printf("Certain que vous êtes heureux d'utiliser Mercurial!\n");
return 0;
}

hg import monpatch.diff

Cette commande est une extension de mercurial qui permet d'afficher l'historique d'un dépôt.
C'est un portage de la commande gitk qui provient du gestionnaire de source git et qui a été renommé en hgk.
Elle utilise le couple tcl/tk pour fonctionner.

Cet outil vous permet de :

• visualiser tous les changesets ;
• effectuer des recherches dans les changesets ;
• visualiser tous les changesets (fichiers modifiés, commentaires, parents, enfants…).

IV-A-1. Installation sous Windows▲

hg clone http://selenic.com/hg hg-upstream
hg up -r votreVersion

[extensions]
hgext.hgk=

[hgk]
path="C:\le repertoire\hgk.tcl"

IV-A-2. Installation sous Linux Ubuntu 8.04▲

sudo apt-get install tk8.4

[hgk] path=/usr/share/mercurial/hgk

IV-A-3. Installation sous Mac OS▲

hg clone http://selenic.com/hg hg-upstream
hg up -r votreVersion
mkdir bin
cp hg-upstream/contrib/hgk ./bin/

[extensions]
hgext.hgk=
[hgk]
path=/Users/votreUser/bin/hgk

Depuis la version 6.0, Netbeans intègre un plugin pour gérer les dépôts mercurial au sein des projets de l'EDI. Ce dernier est présent dans toutes les distributions officielles.

Le plugin Netbeans est bien intégré, il gère la récupération des projets et les fonctionnalités mercurial de base.
Si vous clonez un dépôt mercurial qui contient un projet que votre installation de Netbeans peut gérer, il vous sera proposé d'ouvrir le(s) projet(s).

Il existe un plugin pour eclipse v 3.3+ afin de gérer les dépôts mercurial depuis eclipse. Il propose des fonctionnalités similaires. Avec des petits plus : il est possible d'afficher un graphe de l'historique du dépôt. Il est possible de gérer une « Mercurial Queues » (voir l'extension « Mercurial Queues »sur le wiki) il est possible de lancer le serveur standalone de mercurial

Tortoise HG est un clone du projet TortoiseSvn. Son but est le même, vous permettre de gérer vos dépôts mercurial depuis l'explorateur de fichier.
Mais les moyens de mise en œuvre sont différents, ce projet utilise python comme langage. De plus il est possible de l'intégrer à Nautilus, l'explorateur de fichier de Gnome.

Ici on peut voir les fichiers marqués dans l'explorateur Windows comme étant livrés dans le dépôt. Et en premier plan la fenêtre de tortoise hg permettant de récupérer les modifications d'un dépôt distant.