Skip to main content

A simple script & library to handle syncing remote mercuial repositories

Project description

When developing a cross platform application it can be neccesary to transfer changes between different machines in order to test changes out. Mercurials push & pull help to make this process simpler, however keeping your repositories in sync is not neccesarily a single step process. Particularly if you rebase and collapse changesets quite frequently, and especially if you like to make use of the mq extension.

This script intends to make the process of syncing two mercurial repositories to exactly the same point as easy as possible, by taking care of all the steps neccesary in a single command.

Currently it can:

  • Clone a new remote repository
  • Refresh the local mq patch
  • Strip superflous changesets from the remote repository
  • Push to and update the remote repository
  • Commit to the local mq repository
  • Push to and update the remote mq repository
  • Ensure the remote repository has the correct mq patches pushed


Python 2.7 & Mercurial 2.3 are recommended, though others may work.

Synchg depends on these python packages:

It also requires the mq mercurial extension is enabled on any remote machines it is used with.


Synchg and it’s python dependencies can be installed via pip:

pip install synchg

Preparing Repositories

Prior to running synchg for the first time it is recommended that you delete any remote repositories you intend to use it with, and allow synchg to perform the initial clone. If you intend to use mq patches with synchg, you should also ensure you have run hg init --mq on your local repositories.

It should be noted that synchg regards remote repositories as “slaves” and will strip out any changesets it finds that are not in the local repository. You will be prompted before this happens, but the script will be unable to continue if you don’t answer yes. This is to avoid creating additional heads on the remote.


Synchg should be run from the command line:

synchg remote_host [local_path=None]

Where remote_host is the host you wish to sync with and local_path is the optional path to the local mercurial repository (if missing, the current directory will be assumed)

More options can be found by running:

synchg --help

On first run, you will be prompted for some configuration options:

  • Remote source directory - this is the path on the remote under which all your repositories should be found

Project details

Release history Release notifications

History Node


History Node


History Node


History Node


History Node


History Node


This version
History Node


History Node


History Node


History Node


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
SyncHg-0.9.3-py2.7.egg (21.4 kB) Copy SHA256 hash SHA256 Egg 2.7 Oct 23, 2012
SyncHg-0.9.3.tar.gz (10.5 kB) Copy SHA256 hash SHA256 Source None Oct 23, 2012

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page