Ce document est une traduction de la version anglaise : TutorialClone
Tutoriel - Cloner un dépôt
(Cette page est la partie 2 sur 9 de la série Tutoriel. La partie précédente est FrenchTutorialInstall, la suivante est FrenchTutorialHistory)
Vous avez bien suivi le tutoriel d'installation ? Bien !
Avec Mercurial, tout le travail se fait dans un Dépôt. Un dépôt est un répertoire qui contient tous les fichiers source dont on veut conserver un historique en lien avec celui de l'ensemble des sources.
La manière la plus simple de commencer avec Mercurial est d'utiliser un dépôt qui contient déjà quelques fichiers et un historique.
Pour le faire, nous utilisons la commande clone. Cela fait un clonage d'un dépôt : une copie complète d'un autre dépôt pour que nous ayons le notre, privé, pour travailler dedans.
Clonons un petit dépôt "hello, world" hébergé à selenic.com :
$ hg clone http://www.selenic.com/repo/hello mon-hello
Si tout s'est bien passé, la commande clone affiche ceci (Mercurial 1.0):
requesting all changes adding changesets adding manifests adding file changes added 2 changesets with 2 changes to 2 files updating working directory 2 files updated, 0 files merged, 0 files removed, 0 files unresolved
Nous devrions maintenant trouver un répertoire appelé mon-hello dans notre répertoire courant :
$ ls mon-hello
Dans le répertoire mon-hello, nous devrions trouver certains fichiers :
$ ls mon-hello Makefile hello.c
Ces fichiers sont des copies exactes des fichiers du dépôt que l'on vient de cloner.
Note : Dans Mercurial, chaque répertoire est en un seul bloc. Quand vous clonez un dépôt, le nouveau dépôt devient la copie exacte de l'existant au moment du clonage, mais les changements suivants dans l'un ne se verront pas dans l'autre sans que vous ne les transfériez explicitement (pull/push).
Par défaut, hg clone récupère (cf. update) la plus récente révision (Tip) du dépôt dans le répertoire de travail. Pour vérifier quelle est la version de la révision qui est suivie, on peut utiliser la commande parents:
$ cd my-hello $ hg parents changeset: 1:82e55d328c8c tag: tip user: mpm@selenic.com date: Fri Aug 26 01:21:28 2005 -0700 summary: Create a makefile
A ce moment, on peut commencer à examiner l'historique de notre nouveau dépôt en continuant au FrenchTutorialHistory.