This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

Title: argparse: combine subparsers with global positional args
Type: enhancement Stage: resolved
Components: Library (Lib) Versions: Python 3.2
Status: closed Resolution: duplicate
Dependencies: Superseder: argparse: optional subparsers
View: 9253
Assigned To: Nosy List: bethard, elsdoerfer, r.david.murray
Priority: normal Keywords:

Created on 2010-08-08 01:26 by elsdoerfer, last changed 2022-04-11 14:57 by admin. This issue is now closed.

Messages (2)
msg113229 - (view) Author: Michael.Elsdörfer (elsdoerfer) Date: 2010-08-08 01:26
>>> parser = argparse.ArgumentParser()
>>> subparsers = parser.add_subparsers(title="commands")
>>> subparser = subparsers.add_parser('make')
>>> parser.add_argument('jobs', nargs='*')
>>> parser.print_help()
usage: [-h] {make} ... [jobs [jobs ...]]

While the printed usage looks innocuous enough, argparser isn't actually able to parse this the way I expect: The positional argument never get's to handle any jobs given, as apparently everything after the command is handled by the subparser:

>>> parser.parse_args(['make', 'something'])
usage:  make [-h]
 make: error: unrecognized arguments: something

It seems that argparse, upon determining that the subparser can't handle a positional argument, could break out of the subparser, and let the parent parser continue. If necessary, as further help for argparse on how to resolve such situations, a parameter could be added to add_subparsers() which would allow the user to indicate that this group of subparsers should not support positional arguments.

The usage string should then print as:

>>> parser.print_help()
usage: [-h] {make} [jobs [jobs ...]]

That is, without the "..." after the command.

Finally, if it is decided that the feature will not be added, argparse should not allow the user to add positional arguments after a subparser.
msg113266 - (view) Author: R. David Murray (r.david.murray) * (Python committer) Date: 2010-08-08 14:26
This is almost a duplicate of issue 9253. Your proposed semantics are different, but it would be better to carry on a discussion of the "correct" semantics in that ticket rather than have two separate and conflicting ones, so I'm closing this as duplicate.
Date User Action Args
2022-04-11 14:57:05adminsetgithub: 53749
2010-08-08 14:26:54r.david.murraysetstatus: open -> closed

superseder: argparse: optional subparsers
versions: - Python 3.1, Python 2.7, Python 3.3
nosy: + r.david.murray, bethard

messages: + msg113266
resolution: duplicate
stage: resolved
2010-08-08 01:26:44elsdoerfercreate