Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

Simpler command line argument parsing

Project Description

Simpler command line argument parsing

In the spirit of `optimist <>`__: less magic, more flexibility.

pi install argv


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
>>> ['/usr/local/bin/bottler', 'exec', '', '--debug']
>>> {'_': ['exec', ''], 'debug': True}


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


Continuous integration:

Or run tests locally:

python test



  • 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


Copyright (c) 2013 Christopher Brown. MIT Licensed.

Release History

Release History

This version
History Node


Download Files

Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
argv-0.0.3.tar.gz (6.8 kB) Copy SHA256 Checksum SHA256 Source Nov 26, 2013

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting