Issue 32833: argparse doesn't recognise two option aliases as equal (original) (raw)

Step to reproduce:

import argparse ap=argparse.ArgumentParser() ap.add_argument("--a-b", "--ab") v1=ap.parse_args(["--ab", "xx"]) print(v1)

v1==Namespace(a_b='xx')

v2=ap.parse_args(["--a", "xx"])

v2 should be equal to v1 but instead it raises an error, in spite that --a-b and --ab are aliases

To be clear, the specific error is:

error: ambiguous option: --a could match --a-b, --ab

which makes sense if they're separate switches, but doesn't make sense when both expansions are aliases of one another.

Subparsers have aliases, argument option strings don't, at least not formally. Once an argument is added, its flags are entered in several lists. One list belongs to the Action itself, another belongs to the parser (it might actually be a dictionary). The code could check that '--a-b' and '--ab' belong to the same Action, but I suspect it doesn't, at least not at the point where it is checking for ambiguity.

We can look at the code to verify this. It is also entirely likely that this issue has already been raised. There are other issues regarding how it checks for abbreviations (and how to disable abbreviations).

When I run your setup in ipython, I see a display of the newly added Action:

Out[2]: _StoreAction(option_strings=['--a-b', '--ab'], dest='a_b', nargs=None, const=None, default=None, type=None, choices=None, help=None, metavar=None)

Note the 'option_strings' list.

This strings are also entered as keys in a parser dictionary:

In [6]: list(ap._option_string_actions.keys())
Out[6]: ['--a-b', '--help', '--ab', '-h']

The values are the corresponding Actions, in this case the default 'help' one, and the newly added 'StoreAction'. So the parser can only tell if two keys are 'aliases' by checking for matching values.

The abbreviation ambiguity error is raised in 'parser._parse_optional'. If 'ap.allow_abbrev' is does

ap._get_option_tuples('--a')

and raises the error if this returns more than one Action. It does not check whether the multiple actions has the same ID. I suppose it could, but it doesn't.

The option string is passed to the Action.call:

def __call__(self, parser, namespace, values, option_string=None):
    setattr(namespace, self.dest, values)

None of the defined Action subclasses makes use of the this 'option_string' parameter (that I recall). But I can easily imagine writing a custom Action class that does make use of this parameter.

Are aliases like this needed? Seems they just clutter the help:

usage: ipython3 [-h] [--a-b A_B]

optional arguments:
    -h, --help           show this help message and exit
    --a-b A_B, --ab A_B

The clutter will be more obvious with longer realistic flags.

Here the aliases end up disabling the '--a' abbreviation. '--a-' still works.