ANSIBLE.HG(3)

NAME
hg - Manages Mercurial (hg) repositories.

DESCRIPTION

Manages Mercurial (hg) repositories. Supports SSH, HTTP/S and local address.

OPTIONS

dest
    Absolute path of where the repository should be cloned to.(required)

force
    Discards uncommited changes. Runs hg update -C. Choices: yes,no. (default: yes)

purge
    Delets untracked files. Runs hg purge. Note this requires purge extension to be enabled if purge=yes. This module will modify hgrc file on behalf of the user and undo the changes before exiting the task. Choices: yes,no. (default: no)

repo
    The repository address.(required)

revision
    Equivalent -r option in hg command which could be the changeset, revision number, branch name or even tag. (default: default)."

NOTES

If the task seems to be hanging, first verify remote host is in known_hosts. SSH will prompt user to authorize the first contact with a remote host. One solution is to add StrictHostKeyChecking no in .ssh/config which will accept and authorize the connection on behalf of the user. However, if you run as a different user such as setting sudo to True), for example, root will not look at the user .ssh/config setting.

EXAMPLES

Ensure the current working copy is inside the stable branch and deletes untracked files if any.
hg: repo=https://bitbucket.org/user/repo1 dest=/home/user/repo1 revision=stable purge=yes
None

AUTHOR
Yeukhon Wong

SEE ALSO
ansible(1), http://ansible.github.com/modules.html#hg