author Alexander Solovyov <>
Sun, 02 Aug 2009 15:26:29 +0300
changeset 66 f56569645dae
parent 53 1d0173e1b412
child 68 36ce7dcfe7c0
permissions -rw-r--r--
Added tag 0.9.5 for changeset e9678adf8bb1

.. -*- mode: rst -*-


Finaloption is a command line parser, intended to make writing command line
applications easy and painless. It uses built-in Python types (lists,
dictionaries, etc) to define options, which makes configuration clear and
concise. Additionally it contains possibility to handle subcommands (i.e.
``hg commit`` or ``svn update``).

JFYI: name is derived from Die Krupps' song Final Option.

Quick example

That's simple example to show you example of an option definition::

  import sys
  from finaloption import command

  @command(usage='%name [-n] MESSAGE')
  def main(message,
           nonewline=('n', False, 'don\'t print a newline')):
      'Simple echo program'
      if not nonewline:

  if __name__ == '__main__':

Running this program will print the help:: [-n] MESSAGE

  Simple echo program


   -n --nonewline  don't print a newline
   -h --help       show help

I think this mostly describes what's going on, except that I'd like to mention
one interesting feature - if you are using long name for option, you can use
only partial name, for example ``./ --nonew`` a is valid command
line. This is also true for subcommands: read about that and everything else
you'd like to know in `documentation`_.

.. _documentation: