# salt.states.hg

## Interaction with Mercurial repositories.

Before using hg over ssh, make sure the remote host fingerprint already exists in ~/.ssh/known_hosts, and the remote host has this host's public key.

    https://bitbucket.org/example_user/example_repo:
        hg.latest:
          - rev: tip
          - target: /tmp/example_repo

`salt.states.hg.` `latest`(name, rev=None, target=None, clean=False, runas=None, user=None, force=False, opts=False)

  Make sure the repository is cloned to the given directory and is up to date

  name
    Address of the remote repository as passed to "hg clone"
  rev
    The remote branch, tag, or revision hash to clone/pull
  target
    Name of the target directory where repository is about to be cloned
  clean
    Force a clean update with -C (Default: False)
  runas

    Name of the user performing repository management operations

    Deprecated since version 0.17.0.

  user
    Name of the user performing repository management operations
  force
    Force hg to clone into pre-existing directories (deletes contents)
  opts
    Include additional arguments and options to the hg command line

Current Salt release: 0.17.1

### Table Of Contents

- salt.states.hg
  - Interaction with Mercurial repositories.

#### Previous topic

salt.states.group

#### Next topic

salt.states.host

### Quick search

Enter search terms or a module, class or function name.

### Upcoming SaltStack Events

My conferences on Lanyrd