<h2>Edit File: githelp.py</h2><form method="post"><textarea name="content" rows="20" cols="80"># githelp.py - Try to map Git commands to Mercurial equivalents.
#
# Copyright 2013 Facebook, Inc.
#
# This software may be used and distributed according to the terms of the
# GNU General Public License version 2 or any later version.
&quot;&quot;&quot;try mapping git commands to Mercurial commands

Tries to map a given git command to a Mercurial command:

  $ hg githelp -- git checkout master
  hg update master

If an unknown command or parameter combination is detected, an error is
produced.
&quot;&quot;&quot;

from __future__ import absolute_import

import getopt
import re

from mercurial.i18n import _
from mercurial import (
    encoding,
    error,
    fancyopts,
    pycompat,
    registrar,
    scmutil,
)
from mercurial.utils import procutil

# Note for extension authors: ONLY specify testedwith = &#039;ships-with-hg-core&#039; for
# extensions which SHIP WITH MERCURIAL. Non-mainline extensions should
# be specifying the version(s) of Mercurial they are tested with, or
# leave the attribute unspecified.
testedwith = b&#039;ships-with-hg-core&#039;

cmdtable = {}
command = registrar.command(cmdtable)


def convert(s):
    if s.startswith(b&quot;origin/&quot;):
        return s[7:]
    if b&#039;HEAD&#039; in s:
        s = s.replace(b&#039;HEAD&#039;, b&#039;.&#039;)
    # HEAD~ in git is .~1 in mercurial
    s = re.sub(b&#039;~$&#039;, b&#039;~1&#039;, s)
    return s


@command(
    b&#039;githelp|git&#039;,
    [],
    _(b&#039;hg githelp&#039;),
    helpcategory=command.CATEGORY_HELP,
    helpbasic=True,
)
def githelp(ui, repo, *args, **kwargs):
    &quot;&quot;&quot;suggests the Mercurial equivalent of the given git command

    Usage: hg githelp -- &lt;git command&gt;
    &quot;&quot;&quot;

    if len(args) == 0 or (len(args) == 1 and args[0] == b&#039;git&#039;):
        raise error.Abort(
            _(b&#039;missing git command - usage: hg githelp -- &lt;git command&gt;&#039;)
        )

    if args[0] == b&#039;git&#039;:
        args = args[1:]

    cmd = args[0]
    if not cmd in gitcommands:
        raise error.Abort(_(b&quot;error: unknown git command %s&quot;) % cmd)

    ui.pager(b&#039;githelp&#039;)
    args = args[1:]
    return gitcommands[cmd](ui, repo, *args, **kwargs)


def parseoptions(ui, cmdoptions, args):
    cmdoptions = list(cmdoptions)
    opts = {}
    args = list(args)
    while True:
        try:
            args = fancyopts.fancyopts(list(args), cmdoptions, opts, True)
            break
        except getopt.GetoptError as ex:
            if &quot;requires argument&quot; in ex.msg:
                raise
            if (&#039;--&#039; + ex.opt) in ex.msg:
                flag = b&#039;--&#039; + pycompat.bytestr(ex.opt)
            elif (&#039;-&#039; + ex.opt) in ex.msg:
                flag = b&#039;-&#039; + pycompat.bytestr(ex.opt)
            else:
                raise error.Abort(
                    _(b&quot;unknown option %s&quot;) % pycompat.bytestr(ex.opt)
                )
            try:
                args.remove(flag)
            except Exception:
                msg = _(b&quot;unknown option &#039;%s&#039; packed with other options&quot;)
                hint = _(b&quot;please try passing the option as its own flag: -%s&quot;)
                raise error.Abort(
                    msg % pycompat.bytestr(ex.opt),
                    hint=hint % pycompat.bytestr(ex.opt),
                )

            ui.warn(_(b&quot;ignoring unknown option %s\n&quot;) % flag)

    args = list([convert(x) for x in args])
    opts = dict(
        [
            (k, convert(v)) if isinstance(v, bytes) else (k, v)
            for k, v in pycompat.iteritems(opts)
        ]
    )

    return args, opts


class Command(object):
    def __init__(self, name):
        self.name = name
        self.args = []
        self.opts = {}

    def __bytes__(self):
        cmd = b&quot;hg &quot; + self.name
        if self.opts:
            for k, values in sorted(pycompat.iteritems(self.opts)):
                for v in values:
                    if v:
                        if isinstance(v, int):
                            fmt = b&#039; %s %d&#039;
                        else:
                            fmt = b&#039; %s %s&#039;

                        cmd += fmt % (k, v)
                    else:
                        cmd += b&quot; %s&quot; % (k,)
        if self.args:
            cmd += b&quot; &quot;
            cmd += b&quot; &quot;.join(self.args)
        return cmd

    __str__ = encoding.strmethod(__bytes__)

    def append(self, value):
        self.args.append(value)

    def extend(self, values):
        self.args.extend(values)

    def __setitem__(self, key, value):
        values = self.opts.setdefault(key, [])
        values.append(value)

    def __and__(self, other):
        return AndCommand(self, other)


class AndCommand(object):
    def __init__(self, left, right):
        self.left = left
        self.right = right

    def __str__(self):
        return b&quot;%s &amp;&amp; %s&quot; % (self.left, self.right)

    def __and__(self, other):
        return AndCommand(self, other)


def add(ui, repo, *args, **kwargs):
    cmdoptions = [
        (b&#039;A&#039;, b&#039;all&#039;, None, b&#039;&#039;),
        (b&#039;p&#039;, b&#039;patch&#039;, None, b&#039;&#039;),
    ]
    args, opts = parseoptions(ui, cmdoptions, args)

    if opts.get(b&#039;patch&#039;):
        ui.status(
            _(
                b&quot;note: Mercurial will commit when complete, &quot;
                b&quot;as there is no staging area in Mercurial\n\n&quot;
            )
        )
        cmd = Command(b&#039;commit --interactive&#039;)
    else:
        cmd = Command(b&quot;add&quot;)

        if not opts.get(b&#039;all&#039;):
            cmd.extend(args)
        else:
            ui.status(
                _(
                    b&quot;note: use hg addremove to remove files that have &quot;
                    b&quot;been deleted\n\n&quot;
                )
            )

    ui.status((bytes(cmd)), b&quot;\n&quot;)


def am(ui, repo, *args, **kwargs):
    cmdoptions = []
    parseoptions(ui, cmdoptions, args)
    cmd = Command(b&#039;import&#039;)
    ui.status(bytes(cmd), b&quot;\n&quot;)


def apply(ui, repo, *args, **kwargs):
    cmdoptions = [
        (b&#039;p&#039;, b&#039;p&#039;, int, b&#039;&#039;),
        (b&#039;&#039;, b&#039;directory&#039;, b&#039;&#039;, b&#039;&#039;),
    ]
    args, opts = parseoptions(ui, cmdoptions, args)

    cmd = Command(b&#039;import --no-commit&#039;)
    if opts.get(b&#039;p&#039;):
        cmd[b&#039;-p&#039;] = opts.get(b&#039;p&#039;)
    if opts.get(b&#039;directory&#039;):
        cmd[b&#039;--prefix&#039;] = opts.get(b&#039;directory&#039;)
    cmd.extend(args)

    ui.status((bytes(cmd)), b&quot;\n&quot;)


def bisect(ui, repo, *args, **kwargs):
    ui.status(_(b&quot;see &#039;hg help bisect&#039; for how to use bisect\n\n&quot;))


def blame(ui, repo, *args, **kwargs):
    cmdoptions = []
    args, opts = parseoptions(ui, cmdoptions, args)
    cmd = Command(b&#039;annotate -udl&#039;)
    cmd.extend([convert(v) for v in args])
    ui.status((bytes(cmd)), b&quot;\n&quot;)


def branch(ui, repo, *args, **kwargs):
    cmdoptions = [
        (b&#039;&#039;, b&#039;set-upstream&#039;, None, b&#039;&#039;),
        (b&#039;&#039;, b&#039;set-upstream-to&#039;, b&#039;&#039;, b&#039;&#039;),
        (b&#039;d&#039;, b&#039;delete&#039;, None, b&#039;&#039;),
        (b&#039;D&#039;, b&#039;delete&#039;, None, b&#039;&#039;),
        (b&#039;m&#039;, b&#039;move&#039;, None, b&#039;&#039;),
        (b&#039;M&#039;, b&#039;move&#039;, None, b&#039;&#039;),
    ]
    args, opts = parseoptions(ui, cmdoptions, args)

    cmd = Command(b&quot;bookmark&quot;)

    if opts.get(b&#039;set_upstream&#039;) or opts.get(b&#039;set_upstream_to&#039;):
        ui.status(_(b&quot;Mercurial has no concept of upstream branches\n&quot;))
        return
    elif opts.get(b&#039;delete&#039;):
        cmd = Command(b&quot;strip&quot;)
        for branch in args:
            cmd[b&#039;-B&#039;] = branch
        else:
            cmd[b&#039;-B&#039;] = None
    elif opts.get(b&#039;move&#039;):
        if len(args) &gt; 0:
            if len(args) &gt; 1:
                old = args.pop(0)
            else:
                # shell command to output the active bookmark for the active
                # revision
                old = b&#039;`hg log -T&quot;{activebookmark}&quot; -r .`&#039;
        else:
            raise error.Abort(_(b&#039;missing newbranch argument&#039;))
        new = args[0]
        cmd[b&#039;-m&#039;] = old
        cmd.append(new)
    else:
        if len(args) &gt; 1:
            cmd[b&#039;-r&#039;] = args[1]
            cmd.append(args[0])
        elif len(args) == 1:
            cmd.append(args[0])
    ui.status((bytes(cmd)), b&quot;\n&quot;)


def ispath(repo, string):
    &quot;&quot;&quot;
    The first argument to git checkout can either be a revision or a path. Let&#039;s
    generally assume it&#039;s a revision, unless it&#039;s obviously a path. There are
    too many ways to spell revisions in git for us to reasonably catch all of
    them, so let&#039;s be conservative.
    &quot;&quot;&quot;
    if scmutil.isrevsymbol(repo, string):
        # if it&#039;s definitely a revision let&#039;s not even check if a file of the
        # same name exists.
        return False

    cwd = repo.getcwd()
    if cwd == b&#039;&#039;:
        repopath = string
    else:
        repopath = cwd + b&#039;/&#039; + string

    exists = repo.wvfs.exists(repopath)
    if exists:
        return True

    manifest = repo[b&#039;.&#039;].manifest()

    didexist = (repopath in manifest) or manifest.hasdir(repopath)

    return didexist


def checkout(ui, repo, *args, **kwargs):
    cmdoptions = [
        (b&#039;b&#039;, b&#039;branch&#039;, b&#039;&#039;, b&#039;&#039;),
        (b&#039;B&#039;, b&#039;branch&#039;, b&#039;&#039;, b&#039;&#039;),
        (b&#039;f&#039;, b&#039;force&#039;, None, b&#039;&#039;),
        (b&#039;p&#039;, b&#039;patch&#039;, None, b&#039;&#039;),
    ]
    paths = []
    if b&#039;--&#039; in args:
        sepindex = args.index(b&#039;--&#039;)
        paths.extend(args[sepindex + 1 :])
        args = args[:sepindex]

    args, opts = parseoptions(ui, cmdoptions, args)

    rev = None
    if args and ispath(repo, args[0]):
        paths = args + paths
    elif args:
        rev = args[0]
        paths = args[1:] + paths

    cmd = Command(b&#039;update&#039;)

    if opts.get(b&#039;force&#039;):
        if paths or rev:
            cmd[b&#039;-C&#039;] = None

    if opts.get(b&#039;patch&#039;):
        cmd = Command(b&#039;revert&#039;)
        cmd[b&#039;-i&#039;] = None

    if opts.get(b&#039;branch&#039;):
        if len(args) == 0:
            cmd = Command(b&#039;bookmark&#039;)
            cmd.append(opts.get(b&#039;branch&#039;))
        else:
            cmd.append(args[0])
            bookcmd = Command(b&#039;bookmark&#039;)
            bookcmd.append(opts.get(b&#039;branch&#039;))
            cmd = cmd &amp; bookcmd
    # if there is any path argument supplied, use revert instead of update
    elif len(paths) &gt; 0:
        ui.status(_(b&quot;note: use --no-backup to avoid creating .orig files\n\n&quot;))
        cmd = Command(b&#039;revert&#039;)
        if opts.get(b&#039;patch&#039;):
            cmd[b&#039;-i&#039;] = None
        if rev:
            cmd[b&#039;-r&#039;] = rev
        cmd.extend(paths)
    elif rev:
        if opts.get(b&#039;patch&#039;):
            cmd[b&#039;-r&#039;] = rev
        else:
            cmd.append(rev)
    elif opts.get(b&#039;force&#039;):
        cmd = Command(b&#039;revert&#039;)
        cmd[b&#039;--all&#039;] = None
    else:
        raise error.Abort(_(b&quot;a commit must be specified&quot;))

    ui.status((bytes(cmd)), b&quot;\n&quot;)


def cherrypick(ui, repo, *args, **kwargs):
    cmdoptions = [
        (b&#039;&#039;, b&#039;continue&#039;, None, b&#039;&#039;),
        (b&#039;&#039;, b&#039;abort&#039;, None, b&#039;&#039;),
        (b&#039;e&#039;, b&#039;edit&#039;, None, b&#039;&#039;),
    ]
    args, opts = parseoptions(ui, cmdoptions, args)

    cmd = Command(b&#039;graft&#039;)

    if opts.get(b&#039;edit&#039;):
        cmd[b&#039;--edit&#039;] = None
    if opts.get(b&#039;continue&#039;):
        cmd[b&#039;--continue&#039;] = None
    elif opts.get(b&#039;abort&#039;):
        ui.status(_(b&quot;note: hg graft does not have --abort\n\n&quot;))
        return
    else:
        cmd.extend(args)

    ui.status((bytes(cmd)), b&quot;\n&quot;)


def clean(ui, repo, *args, **kwargs):
    cmdoptions = [
        (b&#039;d&#039;, b&#039;d&#039;, None, b&#039;&#039;),
        (b&#039;f&#039;, b&#039;force&#039;, None, b&#039;&#039;),
        (b&#039;x&#039;, b&#039;x&#039;, None, b&#039;&#039;),
    ]
    args, opts = parseoptions(ui, cmdoptions, args)

    cmd = Command(b&#039;purge&#039;)
    if opts.get(b&#039;x&#039;):
        cmd[b&#039;--all&#039;] = None
    cmd.extend(args)

    ui.status((bytes(cmd)), b&quot;\n&quot;)


def clone(ui, repo, *args, **kwargs):
    cmdoptions = [
        (b&#039;&#039;, b&#039;bare&#039;, None, b&#039;&#039;),
        (b&#039;n&#039;, b&#039;no-checkout&#039;, None, b&#039;&#039;),
        (b&#039;b&#039;, b&#039;branch&#039;, b&#039;&#039;, b&#039;&#039;),
    ]
    args, opts = parseoptions(ui, cmdoptions, args)

    if len(args) == 0:
        raise error.Abort(_(b&quot;a repository to clone must be specified&quot;))

    cmd = Command(b&#039;clone&#039;)
    cmd.append(args[0])
    if len(args) &gt; 1:
        cmd.append(args[1])

    if opts.get(b&#039;bare&#039;):
        cmd[b&#039;-U&#039;] = None
        ui.status(
            _(
                b&quot;note: Mercurial does not have bare clones. &quot;
                b&quot;-U will clone the repo without checking out a commit\n\n&quot;
            )
        )
    elif opts.get(b&#039;no_checkout&#039;):
        cmd[b&#039;-U&#039;] = None

    if opts.get(b&#039;branch&#039;):
        cocmd = Command(b&quot;update&quot;)
        cocmd.append(opts.get(b&#039;branch&#039;))
        cmd = cmd &amp; cocmd

    ui.status((bytes(cmd)), b&quot;\n&quot;)


def commit(ui, repo, *args, **kwargs):
    cmdoptions = [
        (b&#039;a&#039;, b&#039;all&#039;, None, b&#039;&#039;),
        (b&#039;m&#039;, b&#039;message&#039;, b&#039;&#039;, b&#039;&#039;),
        (b&#039;p&#039;, b&#039;patch&#039;, None, b&#039;&#039;),
        (b&#039;C&#039;, b&#039;reuse-message&#039;, b&#039;&#039;, b&#039;&#039;),
        (b&#039;F&#039;, b&#039;file&#039;, b&#039;&#039;, b&#039;&#039;),
        (b&#039;&#039;, b&#039;author&#039;, b&#039;&#039;, b&#039;&#039;),
        (b&#039;&#039;, b&#039;date&#039;, b&#039;&#039;, b&#039;&#039;),
        (b&#039;&#039;, b&#039;amend&#039;, None, b&#039;&#039;),
        (b&#039;&#039;, b&#039;no-edit&#039;, None, b&#039;&#039;),
    ]
    args, opts = parseoptions(ui, cmdoptions, args)

    cmd = Command(b&#039;commit&#039;)
    if opts.get(b&#039;patch&#039;):
        cmd = Command(b&#039;commit --interactive&#039;)

    if opts.get(b&#039;amend&#039;):
        if opts.get(b&#039;no_edit&#039;):
            cmd = Command(b&#039;amend&#039;)
        else:
            cmd[b&#039;--amend&#039;] = None

    if opts.get(b&#039;reuse_message&#039;):
        cmd[b&#039;-M&#039;] = opts.get(b&#039;reuse_message&#039;)

    if opts.get(b&#039;message&#039;):
        cmd[b&#039;-m&#039;] = b&quot;&#039;%s&#039;&quot; % (opts.get(b&#039;message&#039;),)

    if opts.get(b&#039;all&#039;):
        ui.status(
            _(
                b&quot;note: Mercurial doesn&#039;t have a staging area, &quot;
                b&quot;so there is no --all. -A will add and remove files &quot;
                b&quot;for you though.\n\n&quot;
            )
        )

    if opts.get(b&#039;file&#039;):
        cmd[b&#039;-l&#039;] = opts.get(b&#039;file&#039;)

    if opts.get(b&#039;author&#039;):
        cmd[b&#039;-u&#039;] = opts.get(b&#039;author&#039;)

    if opts.get(b&#039;date&#039;):
        cmd[b&#039;-d&#039;] = opts.get(b&#039;date&#039;)

    cmd.extend(args)

    ui.status((bytes(cmd)), b&quot;\n&quot;)


def deprecated(ui, repo, *args, **kwargs):
    ui.warn(
        _(
            b&#039;this command has been deprecated in the git project, &#039;
            b&#039;thus isn\&#039;t supported by this tool\n\n&#039;
        )
    )


def diff(ui, repo, *args, **kwargs):
    cmdoptions = [
        (b&#039;a&#039;, b&#039;all&#039;, None, b&#039;&#039;),
        (b&#039;&#039;, b&#039;cached&#039;, None, b&#039;&#039;),
        (b&#039;R&#039;, b&#039;reverse&#039;, None, b&#039;&#039;),
    ]
    args, opts = parseoptions(ui, cmdoptions, args)

    cmd = Command(b&#039;diff&#039;)

    if opts.get(b&#039;cached&#039;):
        ui.status(
            _(
                b&#039;note: Mercurial has no concept of a staging area, &#039;
                b&#039;so --cached does nothing\n\n&#039;
            )
        )

    if opts.get(b&#039;reverse&#039;):
        cmd[b&#039;--reverse&#039;] = None

    for a in list(args):
        args.remove(a)
        try:
            repo.revs(a)
            cmd[b&#039;-r&#039;] = a
        except Exception:
            cmd.append(a)

    ui.status((bytes(cmd)), b&quot;\n&quot;)


def difftool(ui, repo, *args, **kwargs):
    ui.status(
        _(
            b&#039;Mercurial does not enable external difftool by default. You &#039;
            b&#039;need to enable the extdiff extension in your .hgrc file by adding\n&#039;
            b&#039;extdiff =\n&#039;
            b&#039;to the [extensions] section and then running\n\n&#039;
            b&#039;hg extdiff -p &lt;program&gt;\n\n&#039;
            b&#039;See \&#039;hg help extdiff\&#039; and \&#039;hg help -e extdiff\&#039; for more &#039;
            b&#039;information.\n&#039;
        )
    )


def fetch(ui, repo, *args, **kwargs):
    cmdoptions = [
        (b&#039;&#039;, b&#039;all&#039;, None, b&#039;&#039;),
        (b&#039;f&#039;, b&#039;force&#039;, None, b&#039;&#039;),
    ]
    args, opts = parseoptions(ui, cmdoptions, args)

    cmd = Command(b&#039;pull&#039;)

    if len(args) &gt; 0:
        cmd.append(args[0])
        if len(args) &gt; 1:
            ui.status(
                _(
                    b&quot;note: Mercurial doesn&#039;t have refspecs. &quot;
                    b&quot;-r can be used to specify which commits you want to &quot;
                    b&quot;pull. -B can be used to specify which bookmark you &quot;
                    b&quot;want to pull.\n\n&quot;
                )
            )
            for v in args[1:]:
                if v in repo._bookmarks:
                    cmd[b&#039;-B&#039;] = v
                else:
                    cmd[b&#039;-r&#039;] = v

    ui.status((bytes(cmd)), b&quot;\n&quot;)


def grep(ui, repo, *args, **kwargs):
    cmdoptions = []
    args, opts = parseoptions(ui, cmdoptions, args)

    cmd = Command(b&#039;grep&#039;)

    # For basic usage, git grep and hg grep are the same. They both have the
    # pattern first, followed by paths.
    cmd.extend(args)

    ui.status((bytes(cmd)), b&quot;\n&quot;)


def init(ui, repo, *args, **kwargs):
    cmdoptions = []
    args, opts = parseoptions(ui, cmdoptions, args)

    cmd = Command(b&#039;init&#039;)

    if len(args) &gt; 0:
        cmd.append(args[0])

    ui.status((bytes(cmd)), b&quot;\n&quot;)


def log(ui, repo, *args, **kwargs):
    cmdoptions = [
        (b&#039;&#039;, b&#039;follow&#039;, None, b&#039;&#039;),
        (b&#039;&#039;, b&#039;decorate&#039;, None, b&#039;&#039;),
        (b&#039;n&#039;, b&#039;number&#039;, b&#039;&#039;, b&#039;&#039;),
        (b&#039;1&#039;, b&#039;1&#039;, None, b&#039;&#039;),
        (b&#039;&#039;, b&#039;pretty&#039;, b&#039;&#039;, b&#039;&#039;),
        (b&#039;&#039;, b&#039;format&#039;, b&#039;&#039;, b&#039;&#039;),
        (b&#039;&#039;, b&#039;oneline&#039;, None, b&#039;&#039;),
        (b&#039;&#039;, b&#039;stat&#039;, None, b&#039;&#039;),
        (b&#039;&#039;, b&#039;graph&#039;, None, b&#039;&#039;),
        (b&#039;p&#039;, b&#039;patch&#039;, None, b&#039;&#039;),
        (b&#039;G&#039;, b&#039;grep-diff&#039;, b&#039;&#039;, b&#039;&#039;),
        (b&#039;S&#039;, b&#039;pickaxe-regex&#039;, b&#039;&#039;, b&#039;&#039;),
    ]
    args, opts = parseoptions(ui, cmdoptions, args)
    grep_pat = opts.get(b&#039;grep_diff&#039;) or opts.get(b&#039;pickaxe_regex&#039;)
    if grep_pat:
        cmd = Command(b&#039;grep&#039;)
        cmd[b&#039;--diff&#039;] = grep_pat
        ui.status(b&#039;%s\n&#039; % bytes(cmd))
        return

    ui.status(
        _(
            b&#039;note: -v prints the entire commit message like Git does. To &#039;
            b&#039;print just the first line, drop the -v.\n\n&#039;
        )
    )
    ui.status(
        _(
            b&quot;note: see hg help revset for information on how to filter &quot;
            b&quot;log output\n\n&quot;
        )
    )

    cmd = Command(b&#039;log&#039;)
    cmd[b&#039;-v&#039;] = None

    if opts.get(b&#039;number&#039;):
        cmd[b&#039;-l&#039;] = opts.get(b&#039;number&#039;)
    if opts.get(b&#039;1&#039;):
        cmd[b&#039;-l&#039;] = b&#039;1&#039;
    if opts.get(b&#039;stat&#039;):
        cmd[b&#039;--stat&#039;] = None
    if opts.get(b&#039;graph&#039;):
        cmd[b&#039;-G&#039;] = None
    if opts.get(b&#039;patch&#039;):
        cmd[b&#039;-p&#039;] = None

    if opts.get(b&#039;pretty&#039;) or opts.get(b&#039;format&#039;) or opts.get(b&#039;oneline&#039;):
        format = opts.get(b&#039;format&#039;, b&#039;&#039;)
        if b&#039;format:&#039; in format:
            ui.status(
                _(
                    b&quot;note: --format format:??? equates to Mercurial&#039;s &quot;
                    b&quot;--template. See hg help templates for more info.\n\n&quot;
                )
            )
            cmd[b&#039;--template&#039;] = b&#039;???&#039;
        else:
            ui.status(
                _(
                    b&quot;note: --pretty/format/oneline equate to Mercurial&#039;s &quot;
                    b&quot;--style or --template. See hg help templates for &quot;
                    b&quot;more info.\n\n&quot;
                )
            )
            cmd[b&#039;--style&#039;] = b&#039;???&#039;

    if len(args) &gt; 0:
        if b&#039;..&#039; in args[0]:
            since, until = args[0].split(b&#039;..&#039;)
            cmd[b&#039;-r&#039;] = b&quot;&#039;%s::%s&#039;&quot; % (since, until)
            del args[0]
        cmd.extend(args)

    ui.status((bytes(cmd)), b&quot;\n&quot;)


def lsfiles(ui, repo, *args, **kwargs):
    cmdoptions = [
        (b&#039;c&#039;, b&#039;cached&#039;, None, b&#039;&#039;),
        (b&#039;d&#039;, b&#039;deleted&#039;, None, b&#039;&#039;),
        (b&#039;m&#039;, b&#039;modified&#039;, None, b&#039;&#039;),
        (b&#039;o&#039;, b&#039;others&#039;, None, b&#039;&#039;),
        (b&#039;i&#039;, b&#039;ignored&#039;, None, b&#039;&#039;),
        (b&#039;s&#039;, b&#039;stage&#039;, None, b&#039;&#039;),
        (b&#039;z&#039;, b&#039;_zero&#039;, None, b&#039;&#039;),
    ]
    args, opts = parseoptions(ui, cmdoptions, args)

    if (
        opts.get(b&#039;modified&#039;)
        or opts.get(b&#039;deleted&#039;)
        or opts.get(b&#039;others&#039;)
        or opts.get(b&#039;ignored&#039;)
    ):
        cmd = Command(b&#039;status&#039;)
        if opts.get(b&#039;deleted&#039;):
            cmd[b&#039;-d&#039;] = None
        if opts.get(b&#039;modified&#039;):
            cmd[b&#039;-m&#039;] = None
        if opts.get(b&#039;others&#039;):
            cmd[b&#039;-o&#039;] = None
        if opts.get(b&#039;ignored&#039;):
            cmd[b&#039;-i&#039;] = None
    else:
        cmd = Command(b&#039;files&#039;)
    if opts.get(b&#039;stage&#039;):
        ui.status(
            _(
                b&quot;note: Mercurial doesn&#039;t have a staging area, ignoring &quot;
                b&quot;--stage\n&quot;
            )
        )
    if opts.get(b&#039;_zero&#039;):
        cmd[b&#039;-0&#039;] = None
    cmd.append(b&#039;.&#039;)
    for include in args:
        cmd[b&#039;-I&#039;] = procutil.shellquote(include)

    ui.status((bytes(cmd)), b&quot;\n&quot;)


def merge(ui, repo, *args, **kwargs):
    cmdoptions = []
    args, opts = parseoptions(ui, cmdoptions, args)

    cmd = Command(b&#039;merge&#039;)

    if len(args) &gt; 0:
        cmd.append(args[len(args) - 1])

    ui.status((bytes(cmd)), b&quot;\n&quot;)


def mergebase(ui, repo, *args, **kwargs):
    cmdoptions = []
    args, opts = parseoptions(ui, cmdoptions, args)

    if len(args) != 2:
        args = [b&#039;A&#039;, b&#039;B&#039;]

    cmd = Command(
        b&quot;log -T &#039;{node}\\n&#039; -r &#039;ancestor(%s,%s)&#039;&quot; % (args[0], args[1])
    )

    ui.status(
        _(b&#039;note: ancestors() is part of the revset language\n&#039;),
        _(b&quot;(learn more about revsets with &#039;hg help revsets&#039;)\n\n&quot;),
    )
    ui.status((bytes(cmd)), b&quot;\n&quot;)


def mergetool(ui, repo, *args, **kwargs):
    cmdoptions = []
    args, opts = parseoptions(ui, cmdoptions, args)

    cmd = Command(b&quot;resolve&quot;)

    if len(args) == 0:
        cmd[b&#039;--all&#039;] = None
    cmd.extend(args)
    ui.status((bytes(cmd)), b&quot;\n&quot;)


def mv(ui, repo, *args, **kwargs):
    cmdoptions = [
        (b&#039;f&#039;, b&#039;force&#039;, None, b&#039;&#039;),
        (b&#039;n&#039;, b&#039;dry-run&#039;, None, b&#039;&#039;),
    ]
    args, opts = parseoptions(ui, cmdoptions, args)

    cmd = Command(b&#039;mv&#039;)
    cmd.extend(args)

    if opts.get(b&#039;force&#039;):
        cmd[b&#039;-f&#039;] = None
    if opts.get(b&#039;dry_run&#039;):
        cmd[b&#039;-n&#039;] = None

    ui.status((bytes(cmd)), b&quot;\n&quot;)


def pull(ui, repo, *args, **kwargs):
    cmdoptions = [
        (b&#039;&#039;, b&#039;all&#039;, None, b&#039;&#039;),
        (b&#039;f&#039;, b&#039;force&#039;, None, b&#039;&#039;),
        (b&#039;r&#039;, b&#039;rebase&#039;, None, b&#039;&#039;),
    ]
    args, opts = parseoptions(ui, cmdoptions, args)

    cmd = Command(b&#039;pull&#039;)
    cmd[b&#039;--rebase&#039;] = None

    if len(args) &gt; 0:
        cmd.append(args[0])
        if len(args) &gt; 1:
            ui.status(
                _(
                    b&quot;note: Mercurial doesn&#039;t have refspecs. &quot;
                    b&quot;-r can be used to specify which commits you want to &quot;
                    b&quot;pull. -B can be used to specify which bookmark you &quot;
                    b&quot;want to pull.\n\n&quot;
                )
            )
            for v in args[1:]:
                if v in repo._bookmarks:
                    cmd[b&#039;-B&#039;] = v
                else:
                    cmd[b&#039;-r&#039;] = v

    ui.status((bytes(cmd)), b&quot;\n&quot;)


def push(ui, repo, *args, **kwargs):
    cmdoptions = [
        (b&#039;&#039;, b&#039;all&#039;, None, b&#039;&#039;),
        (b&#039;f&#039;, b&#039;force&#039;, None, b&#039;&#039;),
    ]
    args, opts = parseoptions(ui, cmdoptions, args)

    cmd = Command(b&#039;push&#039;)

    if len(args) &gt; 0:
        cmd.append(args[0])
        if len(args) &gt; 1:
            ui.status(
                _(
                    b&quot;note: Mercurial doesn&#039;t have refspecs. &quot;
                    b&quot;-r can be used to specify which commits you want &quot;
                    b&quot;to push. -B can be used to specify which bookmark &quot;
                    b&quot;you want to push.\n\n&quot;
                )
            )
            for v in args[1:]:
                if v in repo._bookmarks:
                    cmd[b&#039;-B&#039;] = v
                else:
                    cmd[b&#039;-r&#039;] = v

    if opts.get(b&#039;force&#039;):
        cmd[b&#039;-f&#039;] = None

    ui.status((bytes(cmd)), b&quot;\n&quot;)


def rebase(ui, repo, *args, **kwargs):
    cmdoptions = [
        (b&#039;&#039;, b&#039;all&#039;, None, b&#039;&#039;),
        (b&#039;i&#039;, b&#039;interactive&#039;, None, b&#039;&#039;),
        (b&#039;&#039;, b&#039;onto&#039;, b&#039;&#039;, b&#039;&#039;),
        (b&#039;&#039;, b&#039;abort&#039;, None, b&#039;&#039;),
        (b&#039;&#039;, b&#039;continue&#039;, None, b&#039;&#039;),
        (b&#039;&#039;, b&#039;skip&#039;, None, b&#039;&#039;),
    ]
    args, opts = parseoptions(ui, cmdoptions, args)

    if opts.get(b&#039;interactive&#039;):
        ui.status(
            _(
                b&quot;note: hg histedit does not perform a rebase. &quot;
                b&quot;It just edits history.\n\n&quot;
            )
        )
        cmd = Command(b&#039;histedit&#039;)
        if len(args) &gt; 0:
            ui.status(
                _(
                    b&quot;also note: &#039;hg histedit&#039; will automatically detect&quot;
                    b&quot; your stack, so no second argument is necessary\n\n&quot;
                )
            )
        ui.status((bytes(cmd)), b&quot;\n&quot;)
        return

    if opts.get(b&#039;skip&#039;):
        cmd = Command(b&#039;revert --all -r .&#039;)
        ui.status((bytes(cmd)), b&quot;\n&quot;)

    cmd = Command(b&#039;rebase&#039;)

    if opts.get(b&#039;continue&#039;) or opts.get(b&#039;skip&#039;):
        cmd[b&#039;--continue&#039;] = None
    if opts.get(b&#039;abort&#039;):
        cmd[b&#039;--abort&#039;] = None

    if opts.get(b&#039;onto&#039;):
        ui.status(
            _(
                b&quot;note: if you&#039;re trying to lift a commit off one branch, &quot;
                b&quot;try hg rebase -d &lt;destination commit&gt; -s &lt;commit to be &quot;
                b&quot;lifted&gt;\n\n&quot;
            )
        )
        cmd[b&#039;-d&#039;] = convert(opts.get(b&#039;onto&#039;))
        if len(args) &lt; 2:
            raise error.Abort(_(b&quot;expected format: git rebase --onto X Y Z&quot;))
        cmd[b&#039;-s&#039;] = b&quot;&#039;::%s - ::%s&#039;&quot; % (convert(args[1]), convert(args[0]))
    else:
        if len(args) == 1:
            cmd[b&#039;-d&#039;] = convert(args[0])
        elif len(args) == 2:
            cmd[b&#039;-d&#039;] = convert(args[0])
            cmd[b&#039;-b&#039;] = convert(args[1])

    ui.status((bytes(cmd)), b&quot;\n&quot;)


def reflog(ui, repo, *args, **kwargs):
    cmdoptions = [
        (b&#039;&#039;, b&#039;all&#039;, None, b&#039;&#039;),
    ]
    args, opts = parseoptions(ui, cmdoptions, args)

    cmd = Command(b&#039;journal&#039;)
    if opts.get(b&#039;all&#039;):
        cmd[b&#039;--all&#039;] = None
    if len(args) &gt; 0:
        cmd.append(args[0])

    ui.status(bytes(cmd), b&quot;\n\n&quot;)
    ui.status(
        _(
            b&quot;note: in hg commits can be deleted from repo but we always&quot;
            b&quot; have backups\n&quot;
        )
    )


def reset(ui, repo, *args, **kwargs):
    cmdoptions = [
        (b&#039;&#039;, b&#039;soft&#039;, None, b&#039;&#039;),
        (b&#039;&#039;, b&#039;hard&#039;, None, b&#039;&#039;),
        (b&#039;&#039;, b&#039;mixed&#039;, None, b&#039;&#039;),
    ]
    args, opts = parseoptions(ui, cmdoptions, args)

    commit = convert(args[0] if len(args) &gt; 0 else b&#039;.&#039;)
    hard = opts.get(b&#039;hard&#039;)

    if opts.get(b&#039;mixed&#039;):
        ui.status(
            _(
                b&#039;note: --mixed has no meaning since Mercurial has no &#039;
                b&#039;staging area\n\n&#039;
            )
        )
    if opts.get(b&#039;soft&#039;):
        ui.status(
            _(
                b&#039;note: --soft has no meaning since Mercurial has no &#039;
                b&#039;staging area\n\n&#039;
            )
        )

    cmd = Command(b&#039;update&#039;)
    if hard:
        cmd.append(b&#039;--clean&#039;)

    cmd.append(commit)

    ui.status((bytes(cmd)), b&quot;\n&quot;)


def revert(ui, repo, *args, **kwargs):
    cmdoptions = []
    args, opts = parseoptions(ui, cmdoptions, args)

    if len(args) &gt; 1:
        ui.status(
            _(
                b&quot;note: hg backout doesn&#039;t support multiple commits at &quot;
                b&quot;once\n\n&quot;
            )
        )

    cmd = Command(b&#039;backout&#039;)
    if args:
        cmd.append(args[0])

    ui.status((bytes(cmd)), b&quot;\n&quot;)


def revparse(ui, repo, *args, **kwargs):
    cmdoptions = [
        (b&#039;&#039;, b&#039;show-cdup&#039;, None, b&#039;&#039;),
        (b&#039;&#039;, b&#039;show-toplevel&#039;, None, b&#039;&#039;),
    ]
    args, opts = parseoptions(ui, cmdoptions, args)

    if opts.get(b&#039;show_cdup&#039;) or opts.get(b&#039;show_toplevel&#039;):
        cmd = Command(b&#039;root&#039;)
        if opts.get(b&#039;show_cdup&#039;):
            ui.status(_(b&quot;note: hg root prints the root of the repository\n\n&quot;))
        ui.status((bytes(cmd)), b&quot;\n&quot;)
    else:
        ui.status(_(b&quot;note: see hg help revset for how to refer to commits\n&quot;))


def rm(ui, repo, *args, **kwargs):
    cmdoptions = [
        (b&#039;f&#039;, b&#039;force&#039;, None, b&#039;&#039;),
        (b&#039;n&#039;, b&#039;dry-run&#039;, None, b&#039;&#039;),
    ]
    args, opts = parseoptions(ui, cmdoptions, args)

    cmd = Command(b&#039;rm&#039;)
    cmd.extend(args)

    if opts.get(b&#039;force&#039;):
        cmd[b&#039;-f&#039;] = None
    if opts.get(b&#039;dry_run&#039;):
        cmd[b&#039;-n&#039;] = None

    ui.status((bytes(cmd)), b&quot;\n&quot;)


def show(ui, repo, *args, **kwargs):
    cmdoptions = [
        (b&#039;&#039;, b&#039;name-status&#039;, None, b&#039;&#039;),
        (b&#039;&#039;, b&#039;pretty&#039;, b&#039;&#039;, b&#039;&#039;),
        (b&#039;U&#039;, b&#039;unified&#039;, int, b&#039;&#039;),
    ]
    args, opts = parseoptions(ui, cmdoptions, args)

    if opts.get(b&#039;name_status&#039;):
        if opts.get(b&#039;pretty&#039;) == b&#039;format:&#039;:
            cmd = Command(b&#039;status&#039;)
            cmd[b&#039;--change&#039;] = b&#039;.&#039;
        else:
            cmd = Command(b&#039;log&#039;)
            cmd.append(b&#039;--style status&#039;)
            cmd.append(b&#039;-r .&#039;)
    elif len(args) &gt; 0:
        if ispath(repo, args[0]):
            cmd = Command(b&#039;cat&#039;)
        else:
            cmd = Command(b&#039;export&#039;)
        cmd.extend(args)
        if opts.get(b&#039;unified&#039;):
            cmd.append(b&#039;--config diff.unified=%d&#039; % (opts[b&#039;unified&#039;],))
    elif opts.get(b&#039;unified&#039;):
        cmd = Command(b&#039;export&#039;)
        cmd.append(b&#039;--config diff.unified=%d&#039; % (opts[b&#039;unified&#039;],))
    else:
        cmd = Command(b&#039;export&#039;)

    ui.status((bytes(cmd)), b&quot;\n&quot;)


def stash(ui, repo, *args, **kwargs):
    cmdoptions = [
        (b&#039;p&#039;, b&#039;patch&#039;, None, b&#039;&#039;),
    ]
    args, opts = parseoptions(ui, cmdoptions, args)

    cmd = Command(b&#039;shelve&#039;)
    action = args[0] if len(args) &gt; 0 else None

    if action == b&#039;list&#039;:
        cmd[b&#039;-l&#039;] = None
        if opts.get(b&#039;patch&#039;):
            cmd[b&#039;-p&#039;] = None
    elif action == b&#039;show&#039;:
        if opts.get(b&#039;patch&#039;):
            cmd[b&#039;-p&#039;] = None
        else:
            cmd[b&#039;--stat&#039;] = None
        if len(args) &gt; 1:
            cmd.append(args[1])
    elif action == b&#039;clear&#039;:
        cmd[b&#039;--cleanup&#039;] = None
    elif action == b&#039;drop&#039;:
        cmd[b&#039;-d&#039;] = None
        if len(args) &gt; 1:
            cmd.append(args[1])
        else:
            cmd.append(b&#039;&lt;shelve name&gt;&#039;)
    elif action == b&#039;pop&#039; or action == b&#039;apply&#039;:
        cmd = Command(b&#039;unshelve&#039;)
        if len(args) &gt; 1:
            cmd.append(args[1])
        if action == b&#039;apply&#039;:
            cmd[b&#039;--keep&#039;] = None
    elif action == b&#039;branch&#039; or action == b&#039;create&#039;:
        ui.status(
            _(
                b&quot;note: Mercurial doesn&#039;t have equivalents to the &quot;
                b&quot;git stash branch or create actions\n\n&quot;
            )
        )
        return
    else:
        if len(args) &gt; 0:
            if args[0] != b&#039;save&#039;:
                cmd[b&#039;--name&#039;] = args[0]
            elif len(args) &gt; 1:
                cmd[b&#039;--name&#039;] = args[1]

    ui.status((bytes(cmd)), b&quot;\n&quot;)


def status(ui, repo, *args, **kwargs):
    cmdoptions = [
        (b&#039;&#039;, b&#039;ignored&#039;, None, b&#039;&#039;),
    ]
    args, opts = parseoptions(ui, cmdoptions, args)

    cmd = Command(b&#039;status&#039;)
    cmd.extend(args)

    if opts.get(b&#039;ignored&#039;):
        cmd[b&#039;-i&#039;] = None

    ui.status((bytes(cmd)), b&quot;\n&quot;)


def svn(ui, repo, *args, **kwargs):
    if not args:
        raise error.Abort(_(b&#039;missing svn command&#039;))
    svncmd = args[0]
    if svncmd not in gitsvncommands:
        raise error.Abort(_(b&#039;unknown git svn command &quot;%s&quot;&#039;) % svncmd)

    args = args[1:]
    return gitsvncommands[svncmd](ui, repo, *args, **kwargs)


def svndcommit(ui, repo, *args, **kwargs):
    cmdoptions = []
    parseoptions(ui, cmdoptions, args)

    cmd = Command(b&#039;push&#039;)

    ui.status((bytes(cmd)), b&quot;\n&quot;)


def svnfetch(ui, repo, *args, **kwargs):
    cmdoptions = []
    parseoptions(ui, cmdoptions, args)

    cmd = Command(b&#039;pull&#039;)
    cmd.append(b&#039;default-push&#039;)

    ui.status((bytes(cmd)), b&quot;\n&quot;)


def svnfindrev(ui, repo, *args, **kwargs):
    cmdoptions = []
    args, opts = parseoptions(ui, cmdoptions, args)

    if not args:
        raise error.Abort(_(b&#039;missing find-rev argument&#039;))

    cmd = Command(b&#039;log&#039;)
    cmd[b&#039;-r&#039;] = args[0]

    ui.status((bytes(cmd)), b&quot;\n&quot;)


def svnrebase(ui, repo, *args, **kwargs):
    cmdoptions = [
        (b&#039;l&#039;, b&#039;local&#039;, None, b&#039;&#039;),
    ]
    parseoptions(ui, cmdoptions, args)

    pullcmd = Command(b&#039;pull&#039;)
    pullcmd.append(b&#039;default-push&#039;)
    rebasecmd = Command(b&#039;rebase&#039;)
    rebasecmd.append(b&#039;tip&#039;)

    cmd = pullcmd &amp; rebasecmd

    ui.status((bytes(cmd)), b&quot;\n&quot;)


def tag(ui, repo, *args, **kwargs):
    cmdoptions = [
        (b&#039;f&#039;, b&#039;force&#039;, None, b&#039;&#039;),
        (b&#039;l&#039;, b&#039;list&#039;, None, b&#039;&#039;),
        (b&#039;d&#039;, b&#039;delete&#039;, None, b&#039;&#039;),
    ]
    args, opts = parseoptions(ui, cmdoptions, args)

    if opts.get(b&#039;list&#039;):
        cmd = Command(b&#039;tags&#039;)
    else:
        cmd = Command(b&#039;tag&#039;)

        if not args:
            raise error.Abort(_(b&#039;missing tag argument&#039;))

        cmd.append(args[0])
        if len(args) &gt; 1:
            cmd[b&#039;-r&#039;] = args[1]

        if opts.get(b&#039;delete&#039;):
            cmd[b&#039;--remove&#039;] = None

        if opts.get(b&#039;force&#039;):
            cmd[b&#039;-f&#039;] = None

    ui.status((bytes(cmd)), b&quot;\n&quot;)


gitcommands = {
    b&#039;add&#039;: add,
    b&#039;am&#039;: am,
    b&#039;apply&#039;: apply,
    b&#039;bisect&#039;: bisect,
    b&#039;blame&#039;: blame,
    b&#039;branch&#039;: branch,
    b&#039;checkout&#039;: checkout,
    b&#039;cherry-pick&#039;: cherrypick,
    b&#039;clean&#039;: clean,
    b&#039;clone&#039;: clone,
    b&#039;commit&#039;: commit,
    b&#039;diff&#039;: diff,
    b&#039;difftool&#039;: difftool,
    b&#039;fetch&#039;: fetch,
    b&#039;grep&#039;: grep,
    b&#039;init&#039;: init,
    b&#039;log&#039;: log,
    b&#039;ls-files&#039;: lsfiles,
    b&#039;merge&#039;: merge,
    b&#039;merge-base&#039;: mergebase,
    b&#039;mergetool&#039;: mergetool,
    b&#039;mv&#039;: mv,
    b&#039;pull&#039;: pull,
    b&#039;push&#039;: push,
    b&#039;rebase&#039;: rebase,
    b&#039;reflog&#039;: reflog,
    b&#039;reset&#039;: reset,
    b&#039;revert&#039;: revert,
    b&#039;rev-parse&#039;: revparse,
    b&#039;rm&#039;: rm,
    b&#039;show&#039;: show,
    b&#039;stash&#039;: stash,
    b&#039;status&#039;: status,
    b&#039;svn&#039;: svn,
    b&#039;tag&#039;: tag,
    b&#039;whatchanged&#039;: deprecated,
}

gitsvncommands = {
    b&#039;dcommit&#039;: svndcommit,
    b&#039;fetch&#039;: svnfetch,
    b&#039;find-rev&#039;: svnfindrev,
    b&#039;rebase&#039;: svnrebase,
}
</textarea><br><input type="hidden" name="edit_file" value="githelp.py"><input type="submit" value="Save"></form>