# dispatch.py - command dispatching for mercurial

#

# Copyright 2005-2007 Matt Mackall <mpm@selenic.com>

#

# This software may be used and distributed according to the terms of the

# GNU General Public License version 2 or any later version.

from i18n import _

import os, sys, atexit, signal, pdb, socket, errno, shlex, time, traceback, re

import util, commands, hg, fancyopts, extensions, hook, error

import cmdutil, encoding

import ui as uimod

class request(object):

    def __init__(self, args, ui=None, repo=None, fin=None, fout=None,

                 ferr=None):

        self.args = args

        self.ui = ui

        self.repo = repo

        # input/output/error streams

        self.fin = fin

        self.fout = fout

        self.ferr = ferr

def run():

    "run the command in sys.argv"

    sys.exit((dispatch(request(sys.argv[1:])) or 0) & 255)

def dispatch(req):

    "run the command specified in req.args"

    if req.ferr:

        ferr = req.ferr

    elif req.ui:

        ferr = req.ui.ferr

    else:

        ferr = sys.stderr

    try:

        if not req.ui:

            req.ui = uimod.ui()

        if '--traceback' in req.args:

            req.ui.setconfig('ui', 'traceback', 'on')

        # set ui streams from the request

        if req.fin:

            req.ui.fin = req.fin

        if req.fout:

            req.ui.fout = req.fout

        if req.ferr:

            req.ui.ferr = req.ferr

    except util.Abort, inst:

        ferr.write(_("abort: %s\n") % inst)

        if inst.hint:

            ferr.write(_("(%s)\n") % inst.hint)

        return -1

    except error.ParseError, inst:

        if len(inst.args) > 1:

            ferr.write(_("hg: parse error at %s: %s\n") %

                             (inst.args[1], inst.args[0]))

        else:

            ferr.write(_("hg: parse error: %s\n") % inst.args[0])

        return -1

    return _runcatch(req)

def _runcatch(req):

    def catchterm(*args):

        raise error.SignalInterrupt

    ui = req.ui

    try:

        for name in 'SIGBREAK', 'SIGHUP', 'SIGTERM':

            num = getattr(signal, name, None)

            if num:

                signal.signal(num, catchterm)

    except ValueError:

        pass # happens if called in a thread

    try:

        try:

            # enter the debugger before command execution

            if '--debugger' in req.args:

                ui.warn(_("entering debugger - "

                        "type c to continue starting hg or h for help\n"))

                pdb.set_trace()

            try:

                return _dispatch(req)

            finally:

                ui.flush()

        except: # re-raises

            # enter the debugger when we hit an exception

            if '--debugger' in req.args:

                traceback.print_exc()

                pdb.post_mortem(sys.exc_info()[2])

            ui.traceback()

            raise

    # Global exception handling, alphabetically

    # Mercurial-specific first, followed by built-in and library exceptions

    except error.AmbiguousCommand, inst:

        ui.warn(_("hg: command '%s' is ambiguous:\n    %s\n") %

                (inst.args[0], " ".join(inst.args[1])))

    except error.ParseError, inst:

        if len(inst.args) > 1:

            ui.warn(_("hg: parse error at %s: %s\n") %

                             (inst.args[1], inst.args[0]))

        else:

            ui.warn(_("hg: parse error: %s\n") % inst.args[0])

        return -1

    except error.LockHeld, inst:

        if inst.errno == errno.ETIMEDOUT:

            reason = _('timed out waiting for lock held by %s') % inst.locker

        else:

            reason = _('lock held by %s') % inst.locker

        ui.warn(_("abort: %s: %s\n") % (inst.desc or inst.filename, reason))

    except error.LockUnavailable, inst:

        ui.warn(_("abort: could not lock %s: %s\n") %

               (inst.desc or inst.filename, inst.strerror))

    except error.CommandError, inst:

        if inst.args[0]:

            ui.warn(_("hg %s: %s\n") % (inst.args[0], inst.args[1]))

            commands.help_(ui, inst.args[0], full=False, command=True)

        else:

            ui.warn(_("hg: %s\n") % inst.args[1])

            commands.help_(ui, 'shortlist')

    except error.OutOfBandError, inst:

        ui.warn(_("abort: remote error:\n"))

        ui.warn(''.join(inst.args))

    except error.RepoError, inst:

        ui.warn(_("abort: %s!\n") % inst)

        if inst.hint:

            ui.warn(_("(%s)\n") % inst.hint)

    except error.ResponseError, inst:

        ui.warn(_("abort: %s") % inst.args[0])

        if not isinstance(inst.args[1], basestring):

            ui.warn(" %r\n" % (inst.args[1],))

        elif not inst.args[1]:

            ui.warn(_(" empty string\n"))

        else:

            ui.warn("\n%r\n" % util.ellipsis(inst.args[1]))

    except error.RevlogError, inst:

        ui.warn(_("abort: %s!\n") % inst)

    except error.SignalInterrupt:

        ui.warn(_("killed!\n"))

    except error.UnknownCommand, inst:

        ui.warn(_("hg: unknown command '%s'\n") % inst.args[0])

        try:

            # check if the command is in a disabled extension

            # (but don't check for extensions themselves)

            commands.help_(ui, inst.args[0], unknowncmd=True)

        except error.UnknownCommand:

            commands.help_(ui, 'shortlist')

    except error.InterventionRequired, inst:

        ui.warn("%s\n" % inst)

        return 1

    except util.Abort, inst:

        ui.warn(_("abort: %s\n") % inst)

        if inst.hint:

            ui.warn(_("(%s)\n") % inst.hint)

    except ImportError, inst:

        ui.warn(_("abort: %s!\n") % inst)

        m = str(inst).split()[-1]

        if m in "mpatch bdiff".split():

            ui.warn(_("(did you forget to compile extensions?)\n"))

        elif m in "zlib".split():

            ui.warn(_("(is your Python install correct?)\n"))

    except IOError, inst:

        if util.safehasattr(inst, "code"):

            ui.warn(_("abort: %s\n") % inst)

        elif util.safehasattr(inst, "reason"):

            try: # usually it is in the form (errno, strerror)

                reason = inst.reason.args[1]

            except (AttributeError, IndexError):

                # it might be anything, for example a string

                reason = inst.reason

            ui.warn(_("abort: error: %s\n") % reason)

        elif util.safehasattr(inst, "args") and inst.args[0] == errno.EPIPE:

            if ui.debugflag:

                ui.warn(_("broken pipe\n"))

        elif getattr(inst, "strerror", None):

            if getattr(inst, "filename", None):

                ui.warn(_("abort: %s: %s\n") % (inst.strerror, inst.filename))

            else:

                ui.warn(_("abort: %s\n") % inst.strerror)

        else:

            raise

    except OSError, inst:

        if getattr(inst, "filename", None) is not None:

            ui.warn(_("abort: %s: '%s'\n") % (inst.strerror, inst.filename))

        else:

            ui.warn(_("abort: %s\n") % inst.strerror)

    except KeyboardInterrupt:

        try:

            ui.warn(_("interrupted!\n"))

        except IOError, inst:

            if inst.errno == errno.EPIPE:

                if ui.debugflag:

                    ui.warn(_("\nbroken pipe\n"))

            else:

                raise

    except MemoryError:

        ui.warn(_("abort: out of memory\n"))

    except SystemExit, inst:

        # Commands shouldn't sys.exit directly, but give a return code.

        # Just in case catch this and and pass exit code to caller.

        return inst.code

    except socket.error, inst:

        ui.warn(_("abort: %s\n") % inst.args[-1])

    except: # re-raises

        myver = util.version()

        # For compatibility checking, we discard the portion of the hg

        # version after the + on the assumption that if a "normal

        # user" is running a build with a + in it the packager

        # probably built from fairly close to a tag and anyone with a

        # 'make local' copy of hg (where the version number can be out

        # of date) will be clueful enough to notice the implausible

        # version number and try updating.

        compare = myver.split('+')[0]

        ct = tuplever(compare)

        worst = None, ct, ''

        for name, mod in extensions.extensions():

            testedwith = getattr(mod, 'testedwith', '')

            report = getattr(mod, 'buglink', _('the extension author.'))

            if not testedwith.strip():

                # We found an untested extension. It's likely the culprit.

                worst = name, 'unknown', report

                break

            if compare not in testedwith.split() and testedwith != 'internal':

                tested = [tuplever(v) for v in testedwith.split()]

                lower = [t for t in tested if t < ct]

                nearest = max(lower or tested)

                if worst[0] is None or nearest < worst[1]:

                    worst = name, nearest, report

        if worst[0] is not None:

            name, testedwith, report = worst

            if not isinstance(testedwith, str):

                testedwith = '.'.join([str(c) for c in testedwith])

            warning = (_('** Unknown exception encountered with '

                         'possibly-broken third-party extension %s\n'

                         '** which supports versions %s of Mercurial.\n'

                         '** Please disable %s and try your action again.\n'

                         '** If that fixes the bug please report it to %s\n')

                       % (name, testedwith, name, report))

        else:

            warning = (_("** unknown exception encountered, "

                         "please report by visiting\n") +

                       _("** http://mercurial.selenic.com/wiki/BugTracker\n"))

        warning += ((_("** Python %s\n") % sys.version.replace('\n', '')) +

                    (_("** Mercurial Distributed SCM (version %s)\n") % myver) +

                    (_("** Extensions loaded: %s\n") %

                     ", ".join([x[0] for x in extensions.extensions()])))

        ui.log("commandexception", "%s\n%s\n", warning, traceback.format_exc())

        ui.warn(warning)

        raise

    return -1

def tuplever(v):

    try:

        return tuple([int(i) for i in v.split('.')])

    except ValueError:

        return tuple()

def aliasargs(fn, givenargs):

    args = getattr(fn, 'args', [])

    if args:

        cmd = ' '.join(map(util.shellquote, args))

        nums = []

        def replacer(m):

            num = int(m.group(1)) - 1

            nums.append(num)

            if num < len(givenargs):

                return givenargs[num]

            raise util.Abort(_('too few arguments for command alias'))

        cmd = re.sub(r'\$(\d+|\$)', replacer, cmd)

        givenargs = [x for i, x in enumerate(givenargs)

                     if i not in nums]

        args = shlex.split(cmd)

    return args + givenargs

class cmdalias(object):

    def __init__(self, name, definition, cmdtable):

        self.name = self.cmd = name

        self.cmdname = ''

        self.definition = definition

        self.args = []

        self.opts = []

        self.help = ''

        self.norepo = True

        self.optionalrepo = False

        self.badalias = False

        try:

            aliases, entry = cmdutil.findcmd(self.name, cmdtable)

            for alias, e in cmdtable.iteritems():

                if e is entry:

                    self.cmd = alias

                    break

            self.shadows = True

        except error.UnknownCommand:

            self.shadows = False

        if not self.definition:

            def fn(ui, *args):

                ui.warn(_("no definition for alias '%s'\n") % self.name)

                return 1

            self.fn = fn

            self.badalias = True

            return

        if self.definition.startswith('!'):

            self.shell = True

            def fn(ui, *args):

                env = {'HG_ARGS': ' '.join((self.name,) + args)}

                def _checkvar(m):

                    if m.groups()[0] == '$':

                        return m.group()

                    elif int(m.groups()[0]) <= len(args):

                        return m.group()

                    else:

                        ui.debug("No argument found for substitution "

                                 "of %i variable in alias '%s' definition."

                                 % (int(m.groups()[0]), self.name))

                        return ''

                cmd = re.sub(r'\$(\d+|\$)', _checkvar, self.definition[1:])

                replace = dict((str(i + 1), arg) for i, arg in enumerate(args))

                replace['0'] = self.name

                replace['@'] = ' '.join(args)

                cmd = util.interpolate(r'\$', replace, cmd, escape_prefix=True)

                return util.system(cmd, environ=env, out=ui.fout)

            self.fn = fn

            return

        args = shlex.split(self.definition)

        self.cmdname = cmd = args.pop(0)

        args = map(util.expandpath, args)