Mercurial script avec python

C'est vrai il n'y a aucun officielle de l'API, mais vous pouvez vous faire une idée sur les meilleures pratiques en lisant d'autres extensions, en particulier ceux regroupés avec hg. Pour ce problème particulier, je voudrais faire quelque chose comme ceci:

from mercurial import ui, hg
from mercurial.node import hex

repo = hg.repository('/path/to/repo/root', ui.ui())
fctx = repo.filectx('/path/to/file', 'tip')
hexnode = hex(fctx.node())

Mise à jour À un certain point, le paramètre d'ordre a changé, maintenant c'est comme ça:

   repo = hg.repository(ui.ui(), '/path/to/repo/root' )

Une mise à jour, plus propre version sous-processus (utilisations .check_output(), ajouté en Python 2.7/3.1) que j'utilise dans mon Django fichier de paramètres pour un brut de fin de déploiement de bout en vérifier (j'ai un dump dans un commentaire HTML):

import subprocess

HG_REV = subprocess.check_output(['hg', 'id', '--id']).strip()

Vous pourriez l'envelopper dans un try si vous ne voulez pas quelque étrange hoquet pour éviter de démarrage:

try:
    HG_REV = subprocess.check_output(['hg', 'id', '--id']).strip()
except OSError:
    HG_REV = "? (Couldn't find HG)"
except subprocess.CalledProcessError as e:
    HG_REV = "? (Error {})".format(e.returncode)
except:
    # should never have to deal with a hangup 
    HG_REV = "???"

Si vous utilisez Python 2, vous souhaitez utiliser hglib.

Je ne sais pas quoi en faire l'usage si vous êtes à l'aide de Python 3, désolé. Probablement hgapi.

Contenu de cette réponse

• Mercurial Api
• Comment utiliser hglib
• Pourquoi hglib est le meilleur choix pour Python 2 utilisateurs
• Si vous êtes à la rédaction d'un crochet, qui décourageait l'interface interne est drôlement pratique

Mercurial Api

Mercurial officielles Api.

1. Mercurial commande du serveur. Vous pouvez parler de Python 2 à l'aide de la hglib (wiki, PyPI) package, qui est géré par l'Mercurial équipe.
2. Mercurial interface de ligne de commande. Vous pouvez parler à elle par la sous-processus, ou hgapi, ou somesuch.

Comment utiliser hglib

Installation:

pip install python-hglib

Utilisation:

import hglib
client = hglib.open("/path/to/repo")

commit = client.log("tip")
print commit.author

Plus de renseignements sur l'utilisation de la hglib page wiki.

Pourquoi hglib est le meilleur choix pour Python 2 utilisateurs

Car elle est maintenue par l'Mercurial équipe, et c'est ce que l'Mercurial équipe recommander pour l'interfaçage avec Mercurial.

À partir Mercurial wiki, la déclaration suivante sur l'interfaçage avec Mercurial:

Pour la grande majorité de la troisième partie du code, la meilleure approche est d'utiliser Mercurial publié, documenté, et API stable: l'interface de ligne de commande. Alternativement, utilisez le CommandServer ou les bibliothèques, qui sont fondés sur elle pour obtenir un rapide, stable, indépendant de la langue de l'interface.

À partir de l'invite du serveur de la page:

[La commande server permet à] des applications tierces et des bibliothèques pour communiquer avec Mercurial-dessus d'un tuyau qui élimine la commande de démarrage de frais généraux. Les bibliothèques peuvent encapsuler la commande de la génération et l'analyse de présenter une langue-API appropriée à ces commandes.

L'interface Python à l'Mercurial de commande du serveur, comme l'a dit, est hglib.

Par commande frais généraux de l'interface de ligne de commande n'est pas une blague, par la manière. Une fois, j'ai construit une très petite suite de test (seulement environ 5 tests) qui ont utilisé la hg via subprocess de créer, de s'engager par commettre une poignée de repos avec par exemple la fusion des situations. Tout au long du projet, l'exécution de la suite séjourné entre 5 à 30 secondes, avec presque tout le temps consacré à la hg appels.

Si vous êtes à la rédaction d'un crochet, qui décourageait l'interface interne est drôlement pratique

La signature d'un Python fonction de raccordement est comme suit:

# In the hgrc:
# [hooks]
# preupdate.my_hook = python:/path/to/file.py:my_hook

def my_hook(
    ui, repo, hooktype, 
    ... hook-specific args, find them in `hg help config` ..., 
    **kwargs)

ui et repo font partie de ladite découragé officieux API interne. Le fait qu'ils sont là, dans votre fonction args rend très pratique à utiliser, comme dans cet exemple de preupdate crochet qui interdit les fusions entre certaines branches.

def check_if_merge_is_allowed(ui, repo, hooktype, parent1, parent2, **kwargs):
    from_ = repo[parent2].branch()
    to_ = repo[parent1].branch()
    ...
    # return True if the hook fails and the merge should not proceed.

Si votre code de hook n'est pas si important, et vous n'êtes pas le publier, vous pourriez choisir d'utiliser les découragés officieux interne de l'API. Si votre crochet fait partie d'une extension que vous êtes à la publication, à une meilleure utilisation hglib.

J'ai voulu faire la même chose que l'OP voulait faire, obtenir hg id -i à partir d'un script (obtenir la dernière révision de l'ensemble du RÉFÉRENTIEL, non pas d'un seul FICHIER dans ce repo) mais je n'ai pas envie d'utiliser popen, et le code de brendan qui m'a, mais n'était pas ce que je voulais.

J'ai donc écrit ce... Commentaires/critiques de bienvenue. Cela devient à la pointe rev en hexadécimal comme une chaîne de caractères.

from mercurial import ui, hg, revlog
# from mercurial.node import hex  # should I have used this?

def getrepohex(reporoot):
    repo = hg.repository(ui.ui(), reporoot)
    revs = repo.revs('tip')
    if len(revs)==1:
      return str(repo.changectx(revs[0]))
    else:
      raise Exception("Internal failure in getrepohex")