List possible path completions for fragment.
List possible command completions for fragment.
command argument is not used.
List possible path completions for fragment.
This function allows the user to select values from a list of possible values. The default is to select all the values:
>>> select_values(None, ['abc', 'def', 'hij'])
['abc', 'def', 'hij']
The user selects values with a comma-separated limit_string. Prepending a minus sign to such a list denotes blacklist mode:
>>> select_values('-abc,hij', ['abc', 'def', 'hij'])
['def']
Without the leading -, the selection is in whitelist mode:
>>> select_values('abc,hij', ['abc', 'def', 'hij'])
['abc', 'hij']
In either case, appropriate errors are raised if on of the user-values is not in the list of possible values. The name parameter lets you make the error message more clear:
>>> select_values('-xyz,hij', ['abc', 'def', 'hij'], name="foobar")
Traceback (most recent call last):
...
UserError: Invalid foobar xyz
['abc', 'def', 'hij']
>>> select_values('xyz,hij', ['abc', 'def', 'hij'], name="foobar")
Traceback (most recent call last):
...
UserError: Invalid foobar xyz
['abc', 'def', 'hij']