S
Steven Bethard
=======================
Announcing argparse 0.8
=======================
The argparse module is an optparse-inspired command line parser that
improves on optparse by supporting:
* positional arguments
* sub-commands
* required options
* options with a variable number of args
* better usage messages
* a much simpler extension mechanism
and a number of other improvements on the optparse API.
Download argparse
=================
argparse home:
http://argparse.python-hosting.com/
argparse single module download:
http://argparse.python-hosting.com/file/trunk/argparse.py?format=raw
argparse bundled downloads at PyPI:
http://www.python.org/pypi/argparse/
Example argparse code
=====================
Here's a simple program that sums its the command-line arguments and
writes them to a file::
parser = argparse.ArgumentParser()
parser.add_argument('integers', nargs='+', type=int)
parser.add_argument('--log', default=sys.stdout,
type=argparse.FileType('w'))
args = parser.parse_args()
args.log.write('%s\n' % sum(args.integers))
args.log.close()
About this release
==================
This release adds support for options with different prefix
characters, a parser-level default for all arguments, and help
messages for subparser commands.
The deprecated 'outfile' type was finally removed in this release.
Please update your code to use the FileType factory.
New features
------------
* Options with different prefix characters, e.g. ``+foo`` or ``/bar``,
using the new ``prefix_chars=`` keyword argument to ArgumentParser.
* A parser-level argument default using the new ``argument_default=``
keyword argument to ArgumentParser.
* Support for ``help=`` in the ``add_parser()`` method of subparsers.
Bugs fixed
----------
* ``set_defaults()`` now correctly overrides defaults from
``add_argument()`` calls
* ``default=SUPPRESS`` now correctly suppresses the action for
positional arguments with ``nargs='?'`` or ``nargs='*'``.
Announcing argparse 0.8
=======================
The argparse module is an optparse-inspired command line parser that
improves on optparse by supporting:
* positional arguments
* sub-commands
* required options
* options with a variable number of args
* better usage messages
* a much simpler extension mechanism
and a number of other improvements on the optparse API.
Download argparse
=================
argparse home:
http://argparse.python-hosting.com/
argparse single module download:
http://argparse.python-hosting.com/file/trunk/argparse.py?format=raw
argparse bundled downloads at PyPI:
http://www.python.org/pypi/argparse/
Example argparse code
=====================
Here's a simple program that sums its the command-line arguments and
writes them to a file::
parser = argparse.ArgumentParser()
parser.add_argument('integers', nargs='+', type=int)
parser.add_argument('--log', default=sys.stdout,
type=argparse.FileType('w'))
args = parser.parse_args()
args.log.write('%s\n' % sum(args.integers))
args.log.close()
About this release
==================
This release adds support for options with different prefix
characters, a parser-level default for all arguments, and help
messages for subparser commands.
The deprecated 'outfile' type was finally removed in this release.
Please update your code to use the FileType factory.
New features
------------
* Options with different prefix characters, e.g. ``+foo`` or ``/bar``,
using the new ``prefix_chars=`` keyword argument to ArgumentParser.
* A parser-level argument default using the new ``argument_default=``
keyword argument to ArgumentParser.
* Support for ``help=`` in the ``add_parser()`` method of subparsers.
Bugs fixed
----------
* ``set_defaults()`` now correctly overrides defaults from
``add_argument()`` calls
* ``default=SUPPRESS`` now correctly suppresses the action for
positional arguments with ``nargs='?'`` or ``nargs='*'``.