Mercurial-3.7.1

Introduction à Mercurial

Mercurial est un outil de gestion de contrôle des sources distribuées identique à Git et Bazaar. Mercurial est écrit en Python et il est utilisé par des projets tels que Mozilla et Vim.

Ce paquet est connu pour se construire correctement sur une plateforme LFS-7.9.

Informations sur le paquet

  • Téléchargement (HTTP) : https://www.mercurial-scm.org/release/mercurial-3.7.1.tar.gz

  • Téléchargement (FTP) :

  • Somme de contrôle MD5 du téléchargement : 4e922fcc9454d2665f20c3b9b4741add

  • Taille du téléchargement : 4.5 Mo

  • Estimation de l'espace disque requis : 54 Mo (avec la documentation, 378 Mo avec la documentation et les tests)

  • Estimation du temps de construction : moins de 0..1 SBU (avec la documentation, 3.4 SBU avec la documentation et les tests, avec -j8)

Dépendances de Mercurial

Requises

Python-2.7.11

Facultatives

git-2.7.1, GnuPG-2.1.11 (gpg2 avec les bindings Python), Subversion-1.9.3 (avec les bindings Python), Bazaar, CVS, Docutils (requis pour construire la documentation), pyflakes, pygments et pyOpenSSL

Notes utilisateur : http://wiki.linuxfromscratch.org/blfs/wiki/mercurial

Installation de Mercurial

Construisez Mercurial en lançant la commande suivante :

make build

Pour construire la documentation (exige Docutils), lancez :

make doc

Le lancement de la suite de tests est facultatif. Les tests qui échouent peuvent être désactivés en les ajoutant à tests/blacklists/failed-tests. Pour exécuter la suite de tests en utilisant le répertoire temporaire tests/tmp et en sautant les tests qui échouent, lancez :

cat > tests/blacklists/failed-tests << "EOF"
# Test Failures
  test-convert-svn-source.t
  test-convert-hg-svn.t
  test-gpg.t
EOF

rm -rf tests/tmp &&

TESTFLAGS="-j<N> --tmpdir tmp --blacklist blacklists/failed-tests" \
make check

<N> est un nombre entier entre un et le nombre de cœurs du processeur. Afin de pouvoir investiguer un test échouant en particulier, utilisez le script run-tests.py. Pour voir les presque quarante options, dont certaines très utiles, lancez tests/run-tests.py --help. Avec la commande suivante, vous exécuterez seulement les tests précédemment échoués :

pushd tests  &&
  rm -rf tmp &&

  ./run-tests.py --tmpdir tmp              \
                 test-convert-svn-source.t \
                 test-convert-hg-svn.t     \
                 test-gpg.t                &&
popd

Normalement les échecs précédents sont confirmés, sauf pour « test-gpg.t » qui réussi maintenant (c'est étrange !). Cependant, si vous ajoutez l'option --debug avant "--tmpdir", et que vous lancez de nouveau, certains échec disparaissent, ce qui semble être un problème avec la suite de tests. Si cela arrive, normalement, à partir d'ici, il n'y aura plus de tels échecs que vous utilisiez l'option debug ou non.

Une option intéressante est « --time », qui génère à la fin de l'exécution de la suite de tests un tableau avec tous les tests exécutés et leur temps respectifs de début, fin, utilisateur, système et réel. Notez que les options peuvent être utilisés avec make check, en les ajoutant à la variable d'environnement TESTFLAGS.

Installez Mercurial en lançant les commandes suivantes (en tant qu'utilisateur root) :

make PREFIX=/usr install-bin

Si vous avez construit la documentation, installez-la en lançant la commande suivante (en tant qu'utilisateur root) :

make PREFIX=/usr install-doc

Après l'installation, deux tests rapides et simples peuvent être lancés correctement. Le premier demande un peu de configuration :

cat >> ~/.hgrc << "EOF"
[ui]
username = <user_name> <user@mail>
EOF

où vous devez remplacer <user_name> et <your@mail> (mail est facultatif et peut être omis). Une fois l'identité de l'utilisateur définie, lancez hg debuginstall et quelques lignes seront affichées, la dernière affichant « no problems detected ». Un autre test rapide et simple est juste hg, qui doit afficher les commandes basiques qui peuvent être utilisée avec hg.

Configuration de Mercurial

Fichiers de configuration

/etc/mercurial/hgrc et ~/.hgrc

La grande majorité des extensions est désactivée par défaut. Lancez hg help extensions si vous souhaitez en activer une, par exemple lorsque vous investiguez des tests échoués. Vous obtiendrai la liste des extensions activées et désactivées, et plus d'information, comme comment les activer ou les désactiver avec les fichiers de configuration.

Si vous avez installé les Certificats d'autorité de certification et que vous souhaitez que Mercurial les utilise, lancez, en tant qu'utilisateur root :

install -v -d -m755 /etc/mercurial &&
cat >> /etc/mercurial/hgrc << "EOF"
[web]
cacerts = /etc/ssl/ca-bundle.crt
EOF

Contenu

Programmes installés: hg
Bibliothèques installées: plusieurs modules internes dans /usr/lib/python2.7/site-packages/mercurial
Répertoires installés: /etc/mercurial et /usr/lib/python2.7/site-packages/{hgext,mercurial}

Descriptions courtes

hg

est le fichier programme pour mercurial.

Last updated on 2016-02-29 22:16:05 +0100