API de Mercurial para Python

Mercurial como ya se ha explicado es un sistema de control de versiones distribuído desarrollado en python, otros sistemas de control de versiones tienen API o módulos para python, pero para el caso de mercurial no había visto una API para usarlo desde python.

Revisando los artículos que publican en los sparks de python  en Google+ me encuentro con que existe un API que se llama hgapi.

El API soporta lo siguiente:

hg init
hg id
hg add <file>
hg commit [files] [-u name] [--close-branch]
hg update <rev>
hg heads
hg log
hg remove
hg status
hg merge (fails on conflict)
hg revert

El procedimiento para instalarlo es el siguiente:
 # pip install hgapi

 Downloading/unpacking hgapi
  Downloading hgapi-1.1.0.tar.gz
  Running setup.py egg_info for package hgapi
  
Installing collected packages: hgapi
  Running setup.py install for hgapi
  
Successfully installed hgapi
Cleaning up...

Se crea el directorio pruebas:

$mkdir pruebas

Dentro del directorio pruebas se crea el archivo hora.txt:

cd pruebas

touch hora.txt

Ya está todo listo para probar el API.

1. Se importa el módulo hgapi:

import hgapi

2. Fuera del directorio pruebas se crea la instancia del repositorio:

repo = hgapi.Repo("pruebas")

3. Se inicializa el repositorio:

repo.hg_init()

4. Se agrega el archivo hora.txt:

repo.hg_add("hora.txt")

5. Se realiza el commit colocando la descripción y el usuario quien realiza el commit:

repo.hg_commit("Agregando archivo hora.txt",user="ernesto")

6. Se captura la descripción:

str(repo['tip'].desc)

'Agregando archivo hora.txt'

Esto es lo básico que explica el sitio de hgapi. Lo interesante es que ya se puede automatizar procesos de mercurial desde python.

La documentación de hgapi la pueden revisar aquí.