ansible.builtin.hg (v2.9.27) — module

Install Ansible via pip

Install with pip install ansible==2.9.27

Description

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

Usage examples

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

- name: 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

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

- name: Get information about the repository whether or not it has already been cloned locally.
  hg:
    repo: git://bitbucket.org/user/repo
    dest: /srv/checkout
    clone: no
    update: no

Inputs

    
dest:
    description:
    - Absolute path of where the repository should be cloned to. This parameter is required,
      unless clone and update are set to no
    required: true

repo:
    aliases:
    - name
    description:
    - The repository address.
    required: true

clone:
    default: 'yes'
    description:
    - If C(no), do not clone the repository if it does not exist locally.
    type: bool
    version_added: '2.3'
    version_added_collection: ansible.builtin

force:
    default: 'no'
    description:
    - Discards uncommitted changes. Runs C(hg update -C).  Prior to 1.9, the default was
      `yes`.
    type: bool

purge:
    default: 'no'
    description:
    - Deletes untracked files. Runs C(hg purge).
    type: bool

update:
    default: 'yes'
    description:
    - If C(no), do not retrieve new revisions from the origin repository
    type: bool
    version_added: '2.0'
    version_added_collection: ansible.builtin

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

executable:
    description:
    - Path to hg executable to use. If not supplied, the normal mechanism for resolving
      binary paths will be used.
    version_added: '1.4'
    version_added_collection: ansible.builtin