Quickstart

Manual specification of arguments, no configuration:

import argv
argv.parse(['-i', 'input.txt', '-z', '--verbose'])
>>> {'i': 'input.txt', 'verbose': True, 'z': True}

Uses sys.argv (without the executable name) if no argument list is given:

import sys
sys.argv
>>> ['/usr/local/bin/bottler', 'exec', 'prog.py', '--debug']
argv.parse()
>>> {'_': ['exec', 'prog.py'], 'debug': True}

Configuration:

parser = argv.Parser()
parser.add('action')
parser.add('target')
parser.add('-d', '--debug')
parser.parse(['exec', 'prog.py', '--debug'])
>>> {'action': 'exec', 'd': True, 'debug': True, 'target': 'prog.py'}

Terminology:

• flag: a command line argument marked with a double dash or each component of a group denoted by a single dash. E.g.,

  • --verbose --logfile logs/app.txt has two flags: verbose and logfile.

  • -czf archive.tgz app/ has three flags: c, z, and f.

• token: a white-space separated command line item. E.g.,

  • `–input= –logfile logs/app.txt