class MultiCommand(Command): (source)
Known subclasses: click.core.CommandCollection
, click.core.Group
A multi command is the basic implementation of a command that dispatches to subcommands. The most common version is the :class:`Group`. :param invoke_without_command: this controls how the multi command itself is invoked. By default it's only invoked if a subcommand is provided. :param no_args_is_help: this controls what happens if no arguments are provided. This option is enabled by default if `invoke_without_command` is disabled or disabled if it's enabled. If enabled this will add ``--help`` as argument if no arguments are passed. :param subcommand_metavar: the string that is used in the documentation to indicate the subcommand place. :param chain: if this is set to `True` chaining of multiple subcommands is enabled. This restricts the form of commands in that they cannot have optional arguments but it allows multiple commands to be chained together. :param result_callback: The result callback to attach to this multi command. This can be set or changed later with the :meth:`result_callback` decorator.
Method | __init__ |
Undocumented |
Method | collect |
Returns all the pieces that go into the usage line and returns it as a list of strings. |
Method | format |
Extra format methods for multi methods that adds all the commands after the options. |
Method | format |
Writes all the options into the formatter if they exist. |
Method | get |
Given a context and a command name, this returns a :class:`Command` object if it exists or returns `None`. |
Method | invoke |
Given a context, this invokes the attached callback (if it exists) in the right way. |
Method | list |
Returns a list of subcommand names in the order they should appear. |
Method | parse |
Given a context and a list of arguments this creates the parser and parses the arguments, then modifies the context as necessary. This is automatically invoked by :meth:`make_context`. |
Method | resolve |
Undocumented |
Method | result |
Adds a result callback to the command. By default if a result callback is already registered this will chain them but this can be disabled with the `replace` parameter. The result callback is invoked with the return value of the subcommand (or the list of return values from all subcommands if chaining is enabled) as well as the parameters as they would be passed to the main callback. |
Method | shell |
Return a list of completions for the incomplete value. Looks at the names of options, subcommands, and chained multi-commands. |
Method | to |
Gather information that could be useful for a tool generating user-facing documentation. This traverses the entire structure below this command. |
Class Variable | allow |
Undocumented |
Class Variable | allow |
Undocumented |
Instance Variable | chain |
Undocumented |
Instance Variable | invoke |
Undocumented |
Instance Variable | no |
Undocumented |
Instance Variable | subcommand |
Undocumented |
Instance Variable | _result |
Undocumented |
Inherited from Command
:
Method | format |
Writes the epilog into the formatter if it exists. |
Method | format |
Writes the help into the formatter if it exists. |
Method | format |
Writes the help text to the formatter if it exists. |
Method | format |
Writes the usage line into the formatter. |
Method | get |
Formats the help into a string and returns it. |
Method | get |
Returns the help option object. |
Method | get |
Returns the names for the help option. |
Method | get |
Undocumented |
Method | get |
Gets short help for the command or makes it by shortening the long help string. |
Method | get |
Formats the usage line into a string and returns it. |
Method | make |
Creates the underlying option parser for this command. |
Instance Variable | add |
Undocumented |
Instance Variable | callback |
Undocumented |
Instance Variable | deprecated |
Undocumented |
Instance Variable | epilog |
Undocumented |
Instance Variable | help |
Undocumented |
Instance Variable | hidden |
Undocumented |
Instance Variable | options |
Undocumented |
Instance Variable | params |
Undocumented |
Instance Variable | short |
Undocumented |
Inherited from BaseCommand
(via Command
):
Method | __call__ |
Alias for :meth:`main`. |
Method | __repr__ |
Undocumented |
Method | main |
This is the way to invoke a script with all the bells and whistles as a command line application. This will always terminate the application after a call. If this is not wanted, ``SystemExit`` needs to be caught. |
Method | make |
This function when given an info name and arguments will kick off the parsing and create a new :class:`Context`. It does not invoke the actual command callback though. |
Class Variable | ignore |
Undocumented |
Instance Variable | context |
Undocumented |
Instance Variable | name |
Undocumented |
Method | _main |
Check if the shell is asking for tab completion, process that, then exit early. Called from :meth:`main` before the program is invoked. |
click.core.Command.__init__
click.core.CommandCollection
, click.core.Group
Undocumented
Parameters | |
name:t.Optional[ | Undocumented |
invokebool | Undocumented |
not.Optional[ | Undocumented |
subcommandt.Optional[ | Undocumented |
chain:bool | Undocumented |
resultt.Optional[ | Undocumented |
**attrs:t.Any | Undocumented |
Extra format methods for multi methods that adds all the commands after the options.
Parameters | |
ctx:Context | Undocumented |
formatter:HelpFormatter | Undocumented |
click.core.Command.format_options
Writes all the options into the formatter if they exist.
Parameters | |
ctx:Context | Undocumented |
formatter:HelpFormatter | Undocumented |
click.core.CommandCollection
, click.core.Group
Given a context and a command name, this returns a :class:`Command` object if it exists or returns `None`.
Parameters | |
ctx:Context | Undocumented |
cmdstr | Undocumented |
Returns | |
t.Optional[ | Undocumented |
Undocumented
Parameters | |
ctx:Context | Undocumented |
args:t.List[ | Undocumented |
Returns | |
t.Tuple[ | Undocumented |
Adds a result callback to the command. By default if a result callback is already registered this will chain them but this can be disabled with the `replace` parameter. The result callback is invoked with the return value of the subcommand (or the list of return values from all subcommands if chaining is enabled) as well as the parameters as they would be passed to the main callback. Example:: @click.group() @click.option('-i', '--input', default=23) def cli(input): return 42 @cli.result_callback() def process_result(result, input): return result + input :param replace: if set to `True` an already existing result callback will be removed. .. versionchanged:: 8.0 Renamed from ``resultcallback``. .. versionadded:: 3.0
Parameters | |
replace:bool | Undocumented |
Returns | |
t.Callable[ | Undocumented |
click.core.Command.shell_complete
Return a list of completions for the incomplete value. Looks at the names of options, subcommands, and chained multi-commands. :param ctx: Invocation context for this command. :param incomplete: Value being completed. May be empty. .. versionadded:: 8.0
Parameters | |
ctx:Context | Undocumented |
incomplete:str | Undocumented |
Returns | |
t.List[ | Undocumented |
click.core.Command.to_info_dict
Gather information that could be useful for a tool generating user-facing documentation. This traverses the entire structure below this command. Use :meth:`click.Context.to_info_dict` to traverse the entire CLI structure. :param ctx: A :class:`Context` representing this command. .. versionadded:: 8.0
Parameters | |
ctx:Context | Undocumented |
Returns | |
t.Dict[ | Undocumented |