Mercurial-6.2.1

Introduction à Mercurial

Mercurial est un outil de gestion de contrôle des sources distribuée similaire à Git et Bazaar. Mercurial est écrit en Python et il est utilisé par des projets tels que Mozilla pour Firefox et Thunderbird.

[Note]

Note

Development versions of BLFS may not build or run some packages properly if dependencies have been updated since the most recent stable versions of the book.

Informations sur le paquet

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

  • Téléchargement (FTP) :

  • Somme de contrôle MD5 : ff21d19b55da86d8e95c44df1b3be97a

  • Taille du téléchargement : 7.7 Mo

  • Estimation de l'espace disque requis : 76 Mo (avec la doc, plus 2,0 Go pour les tests)

  • Estimation du temps de construction : 0,4 SBU (avec la doc, plus 26 SBU pour les tests avec -j4)

Dépendances de Mercurial

Facultatives

docutils-0.19 (requis pour construire la documentation), git-2.37.1, GPGME-1.17.1 (avec les liaisons Python), OpenSSH-9.0p1 (exécution, pour accéder aux dépôts ssh://...), Pygments-2.12.0, rustc-1.60.0 (voir rust/README.rst et rust/rhg/README.md), Subversion-1.14.2 (avec les liaisons Python), Bazaar, CVS, pyflakes, pyOpenSSL et re2

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

Installation de Mercurial

Construisez Mercurial en exécutant la commande suivante :

make build

Pour construire la documentation (exige docutils-0.19), lancez :

make doc

Pour lancer la suite de tests, lancez (8 tests sont connus pour échouer) :

TESTFLAGS="-j<N> --tmpdir tmp --blacklist blacklists/fsmonitor --blacklist blacklists/linux-vfat" make check

<N> est un nombre entier entre un et le nombre de (processeurs × threads) inclus. Cinq tests échouent à cause de messages d'erreur qui ont changé dans Python, ou de certains avertissement d'obsolescence qui sont affichés, et qui n'étaient pas présents quand les tests ont été conçus. 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-gpg.t
popd

Normalement les échecs précédents seront confirmés. Cependant, si vous ajoutez l'option --debug avant --tmpdir, et que vous lancez de nouveau, certains échecs disparaissent, ce qui est un problème avec la suite de tests. Si cela arrive, 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 un tableau avec tous les tests exécutés et leur temps respectifs de début, fin, utilisateur, système et réel à la fin de l'exécution de la suite de tests. Remarquez que ces options peuvent être utilisés avec make check, en les ajoutant à la variable d'environnement TESTFLAGS.

Installez Mercurial en exécutant les commandes suivantes (en tant qu'utilisateur root) :

make PREFIX=/usr install-bin

Si vous avez construit la documentation, installez-la en exécutant la commande suivante (en tant qu'utilisateur root) :

make PREFIX=/usr install-doc

Après l'installation, vous devriez pouvoir correctement lancer deux tests très rapides et simples. 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 obtiendrez 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 make-ca-1.10 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/pki/tls/certs/ca-bundle.crt
EOF

Contenu

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

Descriptions courtes

hg

est le système de contrôle de version mercurial

Last updated on