Mercurial

This module provides low-level tools for managing Mercurial repositories. You should normally not use them directly but rather use the high-level wrapper fabtools.require.mercurial.working_copy() instead.
See also
fabtools.require.mercurial
fabtools.mercurial.clone(remote_url, path=None, use_sudo=False, user=None)[source]
Clone a remote Mercurial repository into a new directory.

Parameters:
- remote_url (str) – URL of the remote repository to clone.
- path (str) – Path of the working copy directory. Must not exist yet.
- use_sudo (bool) – If True execute hg with fabric.operations.sudo(), else with fabric.operations.run().
- user (str) – If use_sudo is True, run fabric.operations.sudo() with the given user. If use_sudo is False this parameter has no effect.

fabtools.mercurial.update(path, branch=’default’, use_sudo=False, user=None, force=False)[source]
Merge changes to a working copy and/or switch branches.

Parameters:
- path (str) – Path of the working copy directory. This directory must exist and be a Mercurial working copy.
- use_sudo (bool) – If True execute hg with fabric.operations.sudo(), else with fabric.operations.run().
- user (str) – If use_sudo is True, run fabric.operations.sudo() with the given user. If use_sudo is False this parameter has no effect.

fabtools.mercurial.pull(path, use_sudo=False, user=None)[source]
Pull changes from the default remote repository.

Parameters:
- path (str) – Path of the working copy directory. This directory must exist and be a Mercurial working copy with a default remote to pull from.
- use_sudo (bool) – If True execute hg with fabric.operations.sudo(), else with fabric.operations.run().
- user (str) – If use_sudo is True, run fabric.operations.sudo() with the given user. If use_sudo is False this parameter has no effect.