Skip to content
Command line parsing speedster
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
docs
.hgignore
README
finaloption.py
setup.py
test.py
test_opts.py

README

.. -*- mode: rst -*-

=============
 Finaloption
=============

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, featured in epigraph.

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'
      sys.stdout.write(message)
      if not nonewline:
          sys.stdout.write('\n')

  if __name__ == '__main__':
      main()

Running this program will print the help::

  echo.py [-n] MESSAGE

  Simple echo program

  options:

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

I think this mostly describes what's going to. To learn more, read
`documentation`_.

.. _documentation: http://hg.piranha.org.ua/finaloption/docs/
Something went wrong with that request. Please try again.