rename to finaloption, docstring for @command, few small change to behaviour
authorAlexander Solovyov <piranha@piranha.org.ua>
Mon, 13 Jul 2009 15:50:16 +0300
changeset 31 80701f91156c
parent 30 1fc9a029d760
child 32 9d42e3d16bcf
rename to finaloption, docstring for @command, few small change to behaviour
fancycmd.py
finaloption.py
test.py
test_opts.py
--- a/fancycmd.py	Mon Jul 13 00:48:07 2009 +0300
+++ /dev/null	Thu Jan 01 00:00:00 1970 +0000
@@ -1,417 +0,0 @@
-# (c) Alexander Solovyov, 2009, under terms of the new BSD License
-'''Fancy command line arguments parser
-'''
-
-import sys, traceback, getopt, types, textwrap, inspect
-from itertools import imap
-
-__all__ = ['command', 'dispatch']
-
-write = sys.stdout.write
-err = sys.stderr.write
-
-CMDTABLE = {}
-
-# --------
-# Public interface
-# --------
-
-def command(options=None, usage='', name=None, shortlist=False):
-    '''Mark function to be used for command line processing.
-    '''
-    def wrapper(func):
-        if '%prog' in usage.split():
-            name_ = sys.argv[0]
-            if name_.startswith('./'):
-                name_ = name_[2:]
-            usage_ = usage.replace('%prog', name_, 1)
-        else:
-            name_ = name or func.__name__
-            usage_ = name_ + ': ' + usage
-        options_ = options or list(guess_options(func))
-        options_.append(('h', 'help', False, 'show help'))
-
-        CMDTABLE[(shortlist and '^' or '') + name_] = (
-            func, options_, usage_)
-
-        def help_func(name=None):
-            return help_cmd(func, usage_, options_)
-
-        def inner(args=None):
-            args = args or sys.argv[1:]
-            if not args:
-                return help_func()
-
-            try:
-                opts, args = catcher(lambda: parse(args, options_), help_func)
-                if opts.pop('help', False):
-                    return help_func()
-                return catcher(
-                    lambda: call_cmd(name_, func, *args, **opts),
-                    help_func)
-            except Abort:
-                return -1
-
-        return inner
-    return wrapper
-
-
-def dispatch(args=None, cmdtable=None, globalopts=None):
-    '''Dispatch command arguments based on subcommands.
-
-     - ``args``: list of arguments, default: sys.argv[1:]
-     - ``cmdtable``: dict of commands in next format::
-
-     {'name': (function, options, usage)}
-
-       if not supplied, functions decorated with @command will be used.
-
-     - ``globalopts``: list of options which are applied to all
-       commands, if not supplied will contain ``--help`` option
-
-    cmdtable format description follows:
-
-     - ``name`` is the name used on command-line. Can containt
-       aliases (separate them with '|') or pointer to the fact
-       that this command should be displayed in short help (start
-       name with '^')
-     - ``function`` is the actual callable
-     - ``options`` is options list in fancyopts format
-     - ``usage`` is the short string of usage
-    '''
-    args = args or sys.argv[1:]
-    cmdtable = cmdtable or CMDTABLE
-
-    globalopts = globalopts or []
-    globalopts.append(('h', 'help', False, 'display help'))
-
-    cmdtable['help'] = (help_(cmdtable, globalopts), [], '[TOPIC]')
-    help_func = cmdtable['help'][0]
-
-    try:
-        name, func, args, kwargs = catcher(
-            lambda: _dispatch(args, cmdtable, globalopts),
-            help_func)
-        return catcher(
-            lambda: call_cmd(name, func, *args, **kwargs),
-            help_func)
-    except Abort:
-        pass
-    return -1
-
-# --------
-# Help
-# --------
-
-def help_(cmdtable, globalopts):
-    def inner(name=None):
-        '''Show help for a given help topic or a help overview
-
-        With no arguments, print a list of commands with short help messages.
-
-        Given a command name, print help for that command.
-        '''
-        def helplist():
-            hlp = {}
-            # determine if any command is marked for shortlist
-            shortlist = (name == 'shortlist' and
-                         any(imap(lambda x: x.startswith('^'), cmdtable)))
-
-            for cmd, info in cmdtable.items():
-                if shortlist and not cmd.startswith('^'):
-                    continue # short help contains only marked commands
-                cmd = cmd.lstrip('^')
-                doc = info[0].__doc__ or '(no help text available)'
-                hlp[cmd] = doc.splitlines()[0].rstrip()
-
-            hlplist = sorted(hlp)
-            maxlen = max(map(len, hlplist))
-            for cmd in hlplist:
-                doc = hlp[cmd]
-                if False: # verbose?
-                    write(' %s:\n     %s\n' % (cmd.replace('|', ', '), doc))
-                else:
-                    write(' %-*s  %s\n' % (maxlen, cmd.split('|', 1)[0],
-                                              doc))
-
-        if not cmdtable:
-            return err('No commands specified!\n')
-
-        if not name or name == 'shortlist':
-            return helplist()
-
-        aliases, (cmd, options, usage) = findcmd(name, cmdtable)
-        return help_cmd(cmd, aliases[0]  + ' ' + usage, options)
-    return inner
-
-def help_cmd(func, usage, options):
-    '''show help for given command
-
-    >>> def test(*args, **opts):
-    ...     """that's a test command
-    ...
-    ...        you can do nothing with this command"""
-    ...     pass
-    >>> opts = [('l', 'listen', 'localhost',
-    ...          'ip to listen on'),
-    ...         ('p', 'port', 8000,
-    ...          'port to listen on'),
-    ...         ('d', 'daemonize', False,
-    ...          'daemonize process'),
-    ...         ('', 'pid-file', '',
-    ...          'name of file to write process ID to')]
-    >>> help_cmd(test, 'test [-l HOST] [NAME]', opts)
-    test [-l HOST] [NAME]
-    <BLANKLINE>
-    that's a test command
-    <BLANKLINE>
-           you can do nothing with this command
-    <BLANKLINE>
-    options:
-    <BLANKLINE>
-     -l --listen     ip to listen on (default: localhost)
-     -p --port       port to listen on (default: 8000)
-     -d --daemonize  daemonize process
-        --pid-file   name of file to write process ID to
-    <BLANKLINE>
-    '''
-    print '%s\n' % usage
-    doc = func.__doc__
-    if not doc:
-        doc = '(no help text available)'
-    print '%s\n' % doc.strip()
-    if options:
-        print ''.join(help_options(options))
-
-def help_options(options):
-    yield 'options:\n\n'
-    output = []
-    for short, name, default, desc in options:
-        default = default and ' (default: %s)' % default or ''
-        output.append(('%2s%s' % (short and '-%s' % short,
-                                  name and ' --%s' % name),
-                       '%s%s' % (desc, default)))
-
-    opts_len = max([len(first) for first, second in output if second] or [0])
-    for first, second in output:
-        if second:
-            # wrap description at 78 chars
-            second = textwrap.wrap(second, width=(78 - opts_len - 3))
-            pad = '\n' + ' ' * (opts_len + 3)
-            yield ' %-*s  %s\n' % (opts_len, first, pad.join(second))
-        else:
-            yield '%s\n' % first
-
-
-# --------
-# Options parsing
-# --------
-
-def parse(args, options):
-    '''
-    >>> opts = [('l', 'listen', 'localhost',
-    ...          'ip to listen on'),
-    ...         ('p', 'port', 8000,
-    ...          'port to listen on'),
-    ...         ('d', 'daemonize', False,
-    ...          'daemonize process'),
-    ...         ('', 'pid-file', '',
-    ...          'name of file to write process ID to')]
-    >>> print parse(['-l', '0.0.0.0', '--pi', 'test', 'all'], opts)
-    ({'pid_file': 'test', 'daemonize': False, 'port': 8000, 'listen': '0.0.0.0'}, ['all'])
-
-    '''
-    argmap, defmap, state = {}, {}, {}
-    shortlist, namelist = '', []
-
-    for short, name, default, comment in options:
-        # change name to match Python styling
-        pyname = name.replace('-', '_')
-        argmap['-' + short] = argmap['--' + name] = pyname
-        defmap[pyname] = default
-
-        # copy defaults to state
-        if isinstance(default, list):
-            state[pyname] = default[:]
-        elif callable(default):
-            state[pyname] = None
-        else:
-            state[pyname] = default
-
-        # getopt wants indication that it takes a parameter
-        if not (default is None or default is True or default is False):
-            if short: short += ':'
-            if name: name += '='
-        if short:
-            shortlist += short
-        if name:
-            namelist.append(name)
-
-    opts, args = getopt.gnu_getopt(args, shortlist, namelist)
-
-    # transfer result to state
-    for opt, val in opts:
-        name = argmap[opt]
-        t = type(defmap[name])
-        if t is types.FunctionType:
-            state[name] = defmap[name](val)
-        elif t is types.IntType:
-            state[name] = int(val)
-        elif t is types.StringType:
-            state[name] = val
-        elif t is types.ListType:
-            state[name].append(val)
-        elif t in (types.NoneType, types.BooleanType):
-            state[name] = not defmap[name]
-
-    return state, args
-
-
-# --------
-# Subcommand system
-# --------
-
-def _dispatch(args, cmdtable, globalopts):
-    cmd, func, args, options, globaloptions = cmdparse(args, cmdtable,
-                                                       globalopts)
-
-    if globaloptions['help']:
-        return 'help', cmdtable['help'][0], [cmd], {}
-    elif not cmd:
-        return 'help', cmdtable['help'][0], ['shortlist'], {}
-
-    return cmd, func, args, options
-
-def cmdparse(args, cmdtable, globalopts):
-    # command is the first non-option
-    cmd = None
-    for arg in args:
-        if not arg.startswith('-'):
-            cmd = arg
-            break
-
-    if cmd:
-        args.pop(args.index(cmd))
-
-        aliases, info = findcmd(cmd, cmdtable)
-        cmd = aliases[0]
-        possibleopts = list(info[1])
-    else:
-        possibleopts = []
-
-    possibleopts.extend(globalopts)
-
-    try:
-        options, args = parse(args, possibleopts)
-    except getopt.GetoptError, e:
-        raise ParseError(cmd, e)
-
-    globaloptions = {}
-    for o in globalopts:
-        name = o[1]
-        globaloptions[name] = options.pop(name)
-
-    return (cmd, cmd and info[0] or None, args, options, globaloptions)
-
-def findpossible(cmd, table):
-    """
-    Return cmd -> (aliases, command table entry)
-    for each matching command.
-    """
-    choice = {}
-    for e in table.keys():
-        aliases = e.lstrip("^").split("|")
-        found = None
-        if cmd in aliases:
-            found = cmd
-        else:
-            for a in aliases:
-                if a.startswith(cmd):
-                    found = a
-                    break
-        if found is not None:
-            choice[found] = (aliases, table[e])
-
-    return choice
-
-def findcmd(cmd, table):
-    """Return (aliases, command table entry) for command string."""
-    choice = findpossible(cmd, table)
-
-    if cmd in choice:
-        return choice[cmd]
-
-    if len(choice) > 1:
-        clist = choice.keys()
-        clist.sort()
-        raise AmbiguousCommand(cmd, clist)
-
-    if choice:
-        return choice.values()[0]
-
-    raise UnknownCommand(cmd)
-
-# --------
-# Helpers
-# --------
-
-def guess_options(func):
-    args, varargs, varkw, defaults = inspect.getargspec(func)
-    for lname, (sname, default, hlp) in zip(args[-len(defaults):], defaults):
-        yield (sname, lname, default, hlp)
-
-
-def catcher(target, help_func):
-    try:
-        return target()
-    except UnknownCommand, e:
-        err("unknown command: '%s'\n" % e)
-    except AmbiguousCommand, e:
-        err("command '%s' is ambiguous:\n    %s\n" %
-            (e.args[0], ' '.join(e.args[1])))
-    except ParseError, e:
-        err('%s: %s\n' % (e.args[0], e.args[1]))
-        help_func(e.args[0])
-    except getopt.GetoptError, e:
-        err('error: %s\n' % e)
-        help_func()
-    except KeyboardInterrupt:
-        err('interrupted!\n')
-    except SystemExit:
-        raise
-    except:
-        err('unknown exception encountered')
-        raise
-
-    raise Abort
-
-def call_cmd(name, func, *args, **kwargs):
-    try:
-        return func(*args, **kwargs)
-    except TypeError:
-        if len(traceback.extract_tb(sys.exc_info()[2])) == 1:
-            raise ParseError(name, "invalid arguments")
-        raise
-
-# --------
-# Exceptions
-# --------
-
-# Command exceptions
-class CommandException(Exception):
-    'Base class for command exceptions'
-
-class AmbiguousCommand(CommandException):
-    'Raised if command is ambiguous'
-
-class UnknownCommand(CommandException):
-    'Raised if command is unknown'
-
-class ParseError(CommandException):
-    'Raised on error in command line parsing'
-
-class SignatureError(CommandException):
-    'Raised if function signature does not correspond to arguments'
-
-class Abort(CommandException):
-    'Abort execution'
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/finaloption.py	Mon Jul 13 15:50:16 2009 +0300
@@ -0,0 +1,432 @@
+# (c) Alexander Solovyov, 2009, under terms of the new BSD License
+'''Command line arguments parser
+'''
+
+import sys, traceback, getopt, types, textwrap, inspect
+from itertools import imap
+
+__all__ = ['command', 'dispatch']
+
+write = sys.stdout.write
+err = sys.stderr.write
+
+CMDTABLE = {}
+
+# --------
+# Public interface
+# --------
+
+def command(options=None, usage='%name', name=None, shortlist=False):
+    '''Decorator to mark function to be used for command line processing.
+
+    All arguments are optional:
+
+     - ``options``: options in format described in docs. If not supplied,
+       will be determined from function.
+     - ``usage``: usage string for function, replaces %name with name
+       of program or subcommand. In case if it's subcommand and %name
+       is not present, usage is prepended by 'name: '
+     - ``name``: used for multiple subcommands. defaults to wrapped
+       function name
+     - ``shortlist``: if command should be included in shortlist. Used
+       only for multiple subcommands
+    '''
+    def wrapper(func):
+        name_ = name or func.__name__
+        if '%name' in usage.split():
+            usage_ = usage.replace('%name', name_, 1)
+        else:
+            usage_ = name_ + (usage and ': ' + usage or '')
+
+        options_ = options or list(guess_options(func))
+        options_.append(('h', 'help', False, 'show help'))
+
+        CMDTABLE[(shortlist and '^' or '') + name_] = (
+            func, options_, usage_)
+
+        def help_func(name=None):
+            name_ = sys.argv[0]
+            if name_.startswith('./'):
+                name_ = name_[2:]
+            usage_ = usage.replace('%name', name_, 1)
+            return help_cmd(func, usage_, options_)
+
+        def inner(args=None):
+
+            args = args or sys.argv[1:]
+            if not args:
+                return help_func()
+
+            try:
+                opts, args = catcher(lambda: parse(args, options_), help_func)
+                if opts.pop('help', False):
+                    return help_func()
+                return catcher(
+                    lambda: call_cmd(name_, func, *args, **opts),
+                    help_func)
+            except Abort:
+                return -1
+
+        return inner
+    return wrapper
+
+
+def dispatch(args=None, cmdtable=None, globalopts=None):
+    '''Dispatch command arguments based on subcommands.
+
+     - ``args``: list of arguments, default: sys.argv[1:]
+     - ``cmdtable``: dict of commands in next format::
+
+     {'name': (function, options, usage)}
+
+       if not supplied, functions decorated with @command will be used.
+
+     - ``globalopts``: list of options which are applied to all
+       commands, if not supplied will contain ``--help`` option
+
+    cmdtable format description follows:
+
+     - ``name`` is the name used on command-line. Can containt
+       aliases (separate them with '|') or pointer to the fact
+       that this command should be displayed in short help (start
+       name with '^')
+     - ``function`` is the actual callable
+     - ``options`` is options list in format described in docs
+     - ``usage`` is the short string of usage
+    '''
+    args = args or sys.argv[1:]
+    cmdtable = cmdtable or CMDTABLE
+
+    globalopts = globalopts or []
+    globalopts.append(('h', 'help', False, 'display help'))
+
+    cmdtable['help'] = (help_(cmdtable, globalopts), [], '[TOPIC]')
+    help_func = cmdtable['help'][0]
+
+    try:
+        name, func, args, kwargs = catcher(
+            lambda: _dispatch(args, cmdtable, globalopts),
+            help_func)
+        return catcher(
+            lambda: call_cmd(name, func, *args, **kwargs),
+            help_func)
+    except Abort:
+        pass
+    return -1
+
+# --------
+# Help
+# --------
+
+def help_(cmdtable, globalopts):
+    def inner(name=None):
+        '''Show help for a given help topic or a help overview
+
+        With no arguments, print a list of commands with short help messages.
+
+        Given a command name, print help for that command.
+        '''
+        def helplist():
+            hlp = {}
+            # determine if any command is marked for shortlist
+            shortlist = (name == 'shortlist' and
+                         any(imap(lambda x: x.startswith('^'), cmdtable)))
+
+            for cmd, info in cmdtable.items():
+                if shortlist and not cmd.startswith('^'):
+                    continue # short help contains only marked commands
+                cmd = cmd.lstrip('^')
+                doc = info[0].__doc__ or '(no help text available)'
+                hlp[cmd] = doc.splitlines()[0].rstrip()
+
+            hlplist = sorted(hlp)
+            maxlen = max(map(len, hlplist))
+            for cmd in hlplist:
+                doc = hlp[cmd]
+                if False: # verbose?
+                    write(' %s:\n     %s\n' % (cmd.replace('|', ', '), doc))
+                else:
+                    write(' %-*s  %s\n' % (maxlen, cmd.split('|', 1)[0],
+                                              doc))
+
+        if not cmdtable:
+            return err('No commands specified!\n')
+
+        if not name or name == 'shortlist':
+            return helplist()
+
+        aliases, (cmd, options, usage) = findcmd(name, cmdtable)
+        return help_cmd(cmd, aliases[0]  + ' ' + usage, options)
+    return inner
+
+def help_cmd(func, usage, options):
+    '''show help for given command
+
+    >>> def test(*args, **opts):
+    ...     """that's a test command
+    ...
+    ...        you can do nothing with this command"""
+    ...     pass
+    >>> opts = [('l', 'listen', 'localhost',
+    ...          'ip to listen on'),
+    ...         ('p', 'port', 8000,
+    ...          'port to listen on'),
+    ...         ('d', 'daemonize', False,
+    ...          'daemonize process'),
+    ...         ('', 'pid-file', '',
+    ...          'name of file to write process ID to')]
+    >>> help_cmd(test, 'test [-l HOST] [NAME]', opts)
+    test [-l HOST] [NAME]
+    <BLANKLINE>
+    that's a test command
+    <BLANKLINE>
+           you can do nothing with this command
+    <BLANKLINE>
+    options:
+    <BLANKLINE>
+     -l --listen     ip to listen on (default: localhost)
+     -p --port       port to listen on (default: 8000)
+     -d --daemonize  daemonize process
+        --pid-file   name of file to write process ID to
+    <BLANKLINE>
+    '''
+    print '%s\n' % usage
+    doc = func.__doc__
+    if not doc:
+        doc = '(no help text available)'
+    print '%s\n' % doc.strip()
+    if options:
+        print ''.join(help_options(options))
+
+def help_options(options):
+    yield 'options:\n\n'
+    output = []
+    for short, name, default, desc in options:
+        default = default and ' (default: %s)' % default or ''
+        output.append(('%2s%s' % (short and '-%s' % short,
+                                  name and ' --%s' % name),
+                       '%s%s' % (desc, default)))
+
+    opts_len = max([len(first) for first, second in output if second] or [0])
+    for first, second in output:
+        if second:
+            # wrap description at 78 chars
+            second = textwrap.wrap(second, width=(78 - opts_len - 3))
+            pad = '\n' + ' ' * (opts_len + 3)
+            yield ' %-*s  %s\n' % (opts_len, first, pad.join(second))
+        else:
+            yield '%s\n' % first
+
+
+# --------
+# Options parsing
+# --------
+
+def parse(args, options):
+    '''
+    >>> opts = [('l', 'listen', 'localhost',
+    ...          'ip to listen on'),
+    ...         ('p', 'port', 8000,
+    ...          'port to listen on'),
+    ...         ('d', 'daemonize', False,
+    ...          'daemonize process'),
+    ...         ('', 'pid-file', '',
+    ...          'name of file to write process ID to')]
+    >>> print parse(['-l', '0.0.0.0', '--pi', 'test', 'all'], opts)
+    ({'pid_file': 'test', 'daemonize': False, 'port': 8000, 'listen': '0.0.0.0'}, ['all'])
+
+    '''
+    argmap, defmap, state = {}, {}, {}
+    shortlist, namelist = '', []
+
+    for short, name, default, comment in options:
+        # change name to match Python styling
+        pyname = name.replace('-', '_')
+        argmap['-' + short] = argmap['--' + name] = pyname
+        defmap[pyname] = default
+
+        # copy defaults to state
+        if isinstance(default, list):
+            state[pyname] = default[:]
+        elif callable(default):
+            state[pyname] = None
+        else:
+            state[pyname] = default
+
+        # getopt wants indication that it takes a parameter
+        if not (default is None or default is True or default is False):
+            if short: short += ':'
+            if name: name += '='
+        if short:
+            shortlist += short
+        if name:
+            namelist.append(name)
+
+    opts, args = getopt.gnu_getopt(args, shortlist, namelist)
+
+    # transfer result to state
+    for opt, val in opts:
+        name = argmap[opt]
+        t = type(defmap[name])
+        if t is types.FunctionType:
+            state[name] = defmap[name](val)
+        elif t is types.IntType:
+            state[name] = int(val)
+        elif t is types.StringType:
+            state[name] = val
+        elif t is types.ListType:
+            state[name].append(val)
+        elif t in (types.NoneType, types.BooleanType):
+            state[name] = not defmap[name]
+
+    return state, args
+
+
+# --------
+# Subcommand system
+# --------
+
+def _dispatch(args, cmdtable, globalopts):
+    cmd, func, args, options, globaloptions = cmdparse(args, cmdtable,
+                                                       globalopts)
+
+    if globaloptions['help']:
+        return 'help', cmdtable['help'][0], [cmd], {}
+    elif not cmd:
+        return 'help', cmdtable['help'][0], ['shortlist'], {}
+
+    return cmd, func, args, options
+
+def cmdparse(args, cmdtable, globalopts):
+    # command is the first non-option
+    cmd = None
+    for arg in args:
+        if not arg.startswith('-'):
+            cmd = arg
+            break
+
+    if cmd:
+        args.pop(args.index(cmd))
+
+        aliases, info = findcmd(cmd, cmdtable)
+        cmd = aliases[0]
+        possibleopts = list(info[1])
+    else:
+        possibleopts = []
+
+    possibleopts.extend(globalopts)
+
+    try:
+        options, args = parse(args, possibleopts)
+    except getopt.GetoptError, e:
+        raise ParseError(cmd, e)
+
+    globaloptions = {}
+    for o in globalopts:
+        name = o[1]
+        globaloptions[name] = options.pop(name)
+
+    return (cmd, cmd and info[0] or None, args, options, globaloptions)
+
+def findpossible(cmd, table):
+    """
+    Return cmd -> (aliases, command table entry)
+    for each matching command.
+    """
+    choice = {}
+    for e in table.keys():
+        aliases = e.lstrip("^").split("|")
+        found = None
+        if cmd in aliases:
+            found = cmd
+        else:
+            for a in aliases:
+                if a.startswith(cmd):
+                    found = a
+                    break
+        if found is not None:
+            choice[found] = (aliases, table[e])
+
+    return choice
+
+def findcmd(cmd, table):
+    """Return (aliases, command table entry) for command string."""
+    choice = findpossible(cmd, table)
+
+    if cmd in choice:
+        return choice[cmd]
+
+    if len(choice) > 1:
+        clist = choice.keys()
+        clist.sort()
+        raise AmbiguousCommand(cmd, clist)
+
+    if choice:
+        return choice.values()[0]
+
+    raise UnknownCommand(cmd)
+
+# --------
+# Helpers
+# --------
+
+def guess_options(func):
+    args, varargs, varkw, defaults = inspect.getargspec(func)
+    for lname, (sname, default, hlp) in zip(args[-len(defaults):], defaults):
+        yield (sname, lname.replace('_', '-'), default, hlp)
+
+
+def catcher(target, help_func):
+    try:
+        return target()
+    except UnknownCommand, e:
+        err("unknown command: '%s'\n" % e)
+    except AmbiguousCommand, e:
+        err("command '%s' is ambiguous:\n    %s\n" %
+            (e.args[0], ' '.join(e.args[1])))
+    except ParseError, e:
+        err('%s: %s\n' % (e.args[0], e.args[1]))
+        help_func(e.args[0])
+    except getopt.GetoptError, e:
+        err('error: %s\n' % e)
+        help_func()
+    except KeyboardInterrupt:
+        err('interrupted!\n')
+    except SystemExit:
+        raise
+    except:
+        err('unknown exception encountered')
+        raise
+
+    raise Abort
+
+def call_cmd(name, func, *args, **kwargs):
+    try:
+        return func(*args, **kwargs)
+    except TypeError:
+        if len(traceback.extract_tb(sys.exc_info()[2])) == 1:
+            raise ParseError(name, "invalid arguments")
+        raise
+
+# --------
+# Exceptions
+# --------
+
+# Command exceptions
+class CommandException(Exception):
+    'Base class for command exceptions'
+
+class AmbiguousCommand(CommandException):
+    'Raised if command is ambiguous'
+
+class UnknownCommand(CommandException):
+    'Raised if command is unknown'
+
+class ParseError(CommandException):
+    'Raised on error in command line parsing'
+
+class SignatureError(CommandException):
+    'Raised if function signature does not correspond to arguments'
+
+class Abort(CommandException):
+    'Abort execution'
--- a/test.py	Mon Jul 13 00:48:07 2009 +0300
+++ b/test.py	Mon Jul 13 15:50:16 2009 +0300
@@ -2,7 +2,7 @@
 
 import sys
 
-from fancycmd import dispatch, command
+from finaloption import dispatch, command
 
 
 @command(usage='[-t]', shortlist=True)
--- a/test_opts.py	Mon Jul 13 00:48:07 2009 +0300
+++ b/test_opts.py	Mon Jul 13 15:50:16 2009 +0300
@@ -2,7 +2,7 @@
 
 import sys
 
-from fancycmd import command
+from finaloption import command
 
 opts = [('l', 'listen', 'localhost', 'ip to listen on'),
         ('p', 'port', 8000, 'port to listen on'),