twisted.python._shellcomp.ZshArgumentsGenerator(object) class documentationtwisted.python._shellcomp
View Source
(View In Hierarchy)
Generate a call to the zsh _arguments completion function based on data in a usage.Options instance
The first three instance variables are populated based on constructor
arguments. The remaining non-constructor variables are populated by this
class with data gathered from the Options instance passed in,
and its base classes.
| Instance Variable | options | The twisted.python.usage.Options
instance to generate for (type: twisted.python.usage.Options) |
| Instance Variable | cmdName | The name of the command we're generating completions for. (type: str) |
| Instance Variable | file | The file to write the completion function to. The
file must have bytes
I/O semantics. (type: file) |
| Instance Variable | descriptions | A dict mapping long option names to alternate descriptions. When this
variable is defined, the descriptions contained here will override those
descriptions provided in the optFlags and optParameters variables. (type: dict) |
| Instance Variable | multiUse | An iterable containing those long option names which may appear on the
command line more than once. By default, options will only be completed one
time. (type: list) |
| Instance Variable | mutuallyExclusive | A sequence of sequences, with each sub-sequence containing those long
option names that are mutually exclusive. That is, those options that
cannot appear on the command line together. (type: list of tuple) |
| Instance Variable | optActions | A dict mapping long option names to shell "actions". These
actions define what may be completed as the argument to the given option,
and should be given as instances of twisted.python.usage.Completer.
Callables may instead be given for the values in this dict. The callable
should accept no arguments, and return a dict) |
| Instance Variable | extraActions | Extra arguments are those arguments typically appearing at the end of the
command-line, which are not associated with any particular named option.
That is, the arguments that are given to the parseArgs() method of your
usage.Options subclass. (type: list of twisted.python.usage.Completer) |
| Method | __init__ | Undocumented |
| Method | write | Write the zsh completion code to the file given to __init__ @return: None |
| Method | writeHeader | This is the start of the code that calls _arguments @return: None |
| Method | writeOptions | Write out zsh code for each option in this command @return: None |
| Method | writeExtras | No summary |
| Method | writeFooter | Write the last bit of code that finishes the call to _arguments @return:
None |
| Method | verifyZshNames | Ensure that none of the option names given in the metadata are typoed
@return: None
@raise ValueError: Raised if unknown option names have been found. |
| Method | excludeStr | Generate an "exclusion string" for the given option |
| Method | makeExcludesDict | |
| Method | writeOpt | Write out the zsh code for the given argument. This is just part of the one big call to _arguments |
| Method | getAction | Return a zsh "action" string for the given argument @return:
str |
| Method | getDescription | Return the description to be used for this argument @return:
str |
| Method | getShortOption | Return the short option letter or None @return: str or None |
| Method | addAdditionalOptions | Add additional options to the optFlags and optParams lists. These will
be defined by 'opt_foo' methods of the Options subclass @return: None |
twisted.python.usage.Options
instance to generate for (type: twisted.python.usage.Options)
dict)
list)
list of tuple)
twisted.python.usage.Completer.
Callables may instead be given for the values in this dict. The callable
should accept no arguments, and return a Completer instance
used as the action.
dict)
list of twisted.python.usage.Completer)
Write out completion information for extra arguments appearing on the command-line. These are extra positional arguments not associated with a named option. That is, the stuff that gets passed to Options.parseArgs().
| Returns | None | |
| Raises | ValueError: if Completer with repeat=True is
found and is not the last item in the extraActions list. | |
Write the last bit of code that finishes the call to _arguments
| Returns | None | |
Ensure that none of the option names given in the metadata are typoed
| Returns | None | |
| Raises | ValueError | Raised if unknown option names have been found. |
Generate an "exclusion string" for the given option
| Parameters | longname | The long option name (e.g. "verbose" instead of "v") (type: str) |
| buildShort | May be True to indicate we're building an excludes string for the short
option that corresponds to the given long opt. (type: bool) | |
| Returns | The generated str | |
| Returns | A dict that maps each option name appearing in
self.mutuallyExclusive to a list of those option names that is it mutually
exclusive with (can't appear on the cmd line with). | |
Write out the zsh code for the given argument. This is just part of the one big call to _arguments
| Parameters | longname | The long option name (e.g. "verbose" instead of "v") (type: str) |
| Returns | None | |
Return a zsh "action" string for the given argument
| Returns | str | |
Return the description to be used for this argument
| Returns | str | |