https://github.com/python/cpython/commit/0d80777981f95bbc79b146fc78b2189c82521ab9
commit: 0d80777981f95bbc79b146fc78b2189c82521ab9
branch: main
author: Erlend E. Aasland <[email protected]>
committer: erlend-aasland <[email protected]>
date: 2024-11-04T09:27:25+01:00
summary:
Docs: turn getopt examples into doctests (#126377)
files:
M Doc/library/getopt.rst
diff --git a/Doc/library/getopt.rst b/Doc/library/getopt.rst
index d43d3250732306..3ab44b9fc56108 100644
--- a/Doc/library/getopt.rst
+++ b/Doc/library/getopt.rst
@@ -97,6 +97,8 @@ exception:
An example using only Unix style options:
+.. doctest::
+
>>> import getopt
>>> args = '-a -b -cfoo -d bar a1 a2'.split()
>>> args
@@ -109,6 +111,8 @@ An example using only Unix style options:
Using long option names is equally easy:
+.. doctest::
+
>>> s = '--condition=foo --testing --output-file abc.def -x a1 a2'
>>> args = s.split()
>>> args
@@ -120,7 +124,9 @@ Using long option names is equally easy:
>>> args
['a1', 'a2']
-In a script, typical usage is something like this::
+In a script, typical usage is something like this:
+
+.. testcode::
import getopt, sys
@@ -150,7 +156,9 @@ In a script, typical usage is something like this::
main()
Note that an equivalent command line interface could be produced with less code
-and more informative help and error messages by using the :mod:`argparse`
module::
+and more informative help and error messages by using the :mod:`argparse`
module:
+
+.. testcode::
import argparse
_______________________________________________
Python-checkins mailing list -- [email protected]
To unsubscribe send an email to [email protected]
https://mail.python.org/mailman3/lists/python-checkins.python.org/
Member address: [email protected]