https://github.com/python/cpython/commit/8b34bcc6a750c35c05aeeb1beea1bad2e033b0f6
commit: 8b34bcc6a750c35c05aeeb1beea1bad2e033b0f6
branch: 3.14
author: Savannah Ostrowski <[email protected]>
committer: savannahostrowski <[email protected]>
date: 2026-02-23T17:35:04Z
summary:
[3.14] Update argparse `suggest_on_error` code snippet in docs (GH-144985)
(#145151)
Update argparse `suggest_on_error` code snippet in docs (#144985)
(cherry picked from commit 6194a552f2b010e1dcdd006996f613c956520124)
files:
M Doc/library/argparse.rst
diff --git a/Doc/library/argparse.rst b/Doc/library/argparse.rst
index df7a127eb6dfdf..b80f0d2900599e 100644
--- a/Doc/library/argparse.rst
+++ b/Doc/library/argparse.rst
@@ -604,13 +604,11 @@ subparser names, the feature can be enabled by setting
``suggest_on_error`` to
``True``. Note that this only applies for arguments when the choices specified
are strings::
- >>> parser = argparse.ArgumentParser(description='Process some integers.',
- suggest_on_error=True)
- >>> parser.add_argument('--action', choices=['sum', 'max'])
- >>> parser.add_argument('integers', metavar='N', type=int, nargs='+',
- ... help='an integer for the accumulator')
- >>> parser.parse_args(['--action', 'sumn', 1, 2, 3])
- tester.py: error: argument --action: invalid choice: 'sumn', maybe you
meant 'sum'? (choose from 'sum', 'max')
+ >>> parser = argparse.ArgumentParser(suggest_on_error=True)
+ >>> parser.add_argument('--action', choices=['debug', 'dryrun'])
+ >>> parser.parse_args(['--action', 'debugg'])
+ usage: tester.py [-h] [--action {debug,dryrun}]
+ tester.py: error: argument --action: invalid choice: 'debugg', maybe you
meant 'debug'? (choose from debug, dryrun)
If you're writing code that needs to be compatible with older Python versions
and want to opportunistically use ``suggest_on_error`` when it's available, you
_______________________________________________
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]
