[Python-checkins] cpython (3.2): Issue #10772: add count and help argparse action; patch by Marc Sibson

[sandro.tosi]

http://hg.python.org/cpython/rev/326f755962e3
changeset:   74273:326f755962e3
branch:      3.2
parent:      74265:86141d28b20d
user:        Sandro Tosi <sandro.tosi at gmail.com>
date:        Wed Jan 04 23:25:04 2012 +0100
summary:
  Issue #10772: add count and help argparse action; patch by Marc Sibson

files:
  Doc/library/argparse.rst |  13 +++++++++++++
  1 files changed, 13 insertions(+), 0 deletions(-)


diff --git a/Doc/library/argparse.rst b/Doc/library/argparse.rst
--- a/Doc/library/argparse.rst
+++ b/Doc/library/argparse.rst
@@ -705,6 +705,19 @@
     >>> parser.parse_args('--str --int'.split())
     Namespace(types=[<class 'str'>, <class 'int'>])
 
+* ``'count'`` - This counts the number of times a keyword argument occurs. For
+  example, this is useful for increasing verbosity levels::
+
+    >>> parser = argparse.ArgumentParser()
+    >>> parser.add_argument('--verbose', '-v', action='count')
+    >>> parser.parse_args('-vvv'.split())
+    Namespace(verbose=3)
+
+* ``'help'`` - This prints a complete help message for all the options in the
+  current parser and then exits. By default a help action is automatically
+  added to the parser. See :class:`ArgumentParser` for details of how the
+  output is created.
+
 * ``'version'`` - This expects a ``version=`` keyword argument in the
   :meth:`~ArgumentParser.add_argument` call, and prints version information
   and exits when invoked.

-- 
Repository URL: http://hg.python.org/cpython