summaryrefslogtreecommitdiff
path: root/doc/source/add_argument.rst
diff options
context:
space:
mode:
Diffstat (limited to 'doc/source/add_argument.rst')
-rw-r--r--doc/source/add_argument.rst8
1 files changed, 8 insertions, 0 deletions
diff --git a/doc/source/add_argument.rst b/doc/source/add_argument.rst
index bc7a2a3..4bdc43e 100644
--- a/doc/source/add_argument.rst
+++ b/doc/source/add_argument.rst
@@ -85,6 +85,14 @@ action
>>> parser.parse_args('--str --int'.split())
Namespace(types=[<type 'str'>, <type 'int'>])
+* ``'version'`` - This expects a ``version=`` keyword argument in the :meth:`add_argument` call, and prints version information and exits when invoked. This can be used when the default :class:`ArgumentParser` version flags ``-v, --version`` are not appropriate for your program.
+
+ >>> import argparse
+ >>> parser = argparse.ArgumentParser(prog='PROG')
+ >>> parser.add_argument('-V', action='version', version='%(prog)s 2.0')
+ >>> parser.parse_args(['-V'])
+ PROG 2.0
+
You can also specify an arbitrary action by passing an object that implements the Action API. The easiest way to do this is to extend ``argparse.Action``, supplying an appropriate ``__call__`` method. The ``__call__`` method accepts four parameters:
* ``parser`` - The ArgumentParser object which contains this action.