Utilisation des extension Mercurial
(Cette page est une traduction de l'original en anglais : UsingExtensions)
Mercurial propose un mécanisme d'extensions pour ajouter de nouvelles commandes.
Les extensions permettent la création de nouvelles fonctionnalités et de les utiliser directement depuis la ligne de commande hg principale comme s'il s'agissait de commandes internes. Référez vous à "hg help extensions" (dans Mercurial 1.3+) pour plus d'informations au sujet des extensions.
Référez vous à CategoryBundledExtension et à CategoryExtensionsByOthers pour les pages de la catégorie extension et à WritingExtensions pour plus d'informations au sujet de l'installation et de l'écriture de nouvelles extensions.
1. Activer une extension
Pour activer une extension "foo" fournie avec Mercurial ou dans le chemin de recherche de Python, créez une entrée pour elle dans votre hgrc comme ceci :
[extensions] foo =
Vous pourriez aussi spécifier le chemin absolu vers une extension :
[extensions] myfeature = ~/.hgext/myfeature.py
Pour explicitement désactiver une extension activée dans un hgrc plus large, préfixez son chemin avec un ! :
[extensions] # désactiver l'extension bar résidant à /path/to/extension/bar.py hgext.bar = !/path/to/extension/bar.py # de même, mais aucun chemin n'a été précisé pour l'extension baz hgext.baz = !
Les extensions peuvent souvent être configurées plus en avant dans une section spécifique, dans le même fichier de configuration.
2. Extensions fournies avec Mercurial
Nom |
Page |
Description |
acl |
Gérer les accès à des parties d'un dépôt en utilisant des listes d'accès |
|
alias |
Alias définis par l'utilisateur pour les commandes (inclus depuis Mercurial 1.3) |
|
bisect |
Trouver rapidement la révision qui introduit un bug ou une fonctionnalité en coupant en deux parties l'arbre d'historique (O(log(n))) (Inclus depuis Mercurial 1.0) |
|
bookmarks |
Marqueurs sur les commits qui s'atallent sur les commits |
|
bugzilla |
Mettre à jour les entrées Bugzilla lorsqu'un "bug id" est référé dans un changeset |
|
children |
Afficher les révisions enfant |
|
churn |
Montrer les statistiques de changements pour les opérations Mercurial par auteur |
|
convert |
Convertir les dépôts d'autres SCM vers Mercurial |
|
color |
Colore la sortie des commandes diff, status et qseries |
|
extdiff |
Comparer les changements en utilisant des programmes externes |
|
fetch |
Les commandes pull, merge et update ont lieue en une étape |
|
gpg |
Signez et vérifiez les signatures des changesets en utilisant GPG |
|
graphlog |
Montre l'historique des révisions à coté d'un graphe ASCII des révisions |
|
hgcia |
Envoyer des notifications à la CIA |
|
hgk |
navigateur graphique des dépôts et historiques basé sur gitk |
|
highlight |
Fichiers dont l'extension est connue surlignés dans la vue des révisions proposée par hgweb |
|
imerge |
Exécute des fusions (merge) interactifs et interruptibles |
|
inotify |
Utilise l'API de notification de Linux 2.6 pour des statuts instantanés de mise à jour |
|
interhg |
Cette extension permet de changer le texte des changelog et résumés comme dans InterWiki |
|
keyword |
Utilise des mots clef comme dans l'extension CVS pour dans les fichiers suivis |
|
mq |
Files de patchs Mercurial - gestion des changements comme une série de patchs |
|
notify |
Envoi un email aux adresses qui ont souscrit aux notifications sur les changements du dépôt |
|
pager |
Vous permet de choisir un pager |
|
parentrevspec |
Utilisez foo^ pour faire référence à la révision parente de foo |
|
patchbomb |
Envoie une collection de changesets changesets comme une série d'emails de patchs |
|
purge |
Purge tous les fichiers et répertoires du dépôt qui ne sont pas suivis par Mercurial |
|
rebase |
Bouger les révisions d'un point à un autre |
|
record |
Sélectionner les changements du répertoire de travail à commiter par bloc à la darcs record |
|
share |
Partager un dépôt entre plusieurs dépôts |
|
transplant |
Permet de transplanter un dépôt |
|
win32mbcs |
Permet l'utilisation de nom de fichiers shift_jis/big5 sous Windows |
|
win32text |
Gère la conversion des éditions de ligne pour les dépôts Windows |
|
zeroconf |
Annonce et navigue dans les dépôts via zeroconf/bonjour |
3. Extensions provided by others
(référez vous à UsingExtensions)