mopidy.commands — Commands API

class mopidy.commands.Command

Command parser and runner for building trees of commands.

This class provides a wraper around argparse.ArgumentParser for handling this type of command line application in a better way than argprases own sub-parser handling.

add_argument(*args, **kwargs)

Add an argument to the parser.

This method takes all the same arguments as the argparse.ArgumentParser version of this method.

add_child(name, command)

Add a child parser to consider using.

Parameters:

name (string) – name to use for the sub-command that is being added.

exit(status_code=0, message=None, usage=None)

Optionally print a message and exit.

format_help(prog=None)

Format help for current parser and children.

format_usage(prog=None)

Format usage for current parser.

parse(args, prog=None)

Parse command line arguments.

Will recursively parse commands until a final parser is found or an error occurs. In the case of errors we will print a message and exit. Otherwise, any overrides are applied and the current parser stored in the command attribute of the return value.

Parameters:

• args (list of strings) – list of arguments to parse

• prog (string) – name to use for program

Return type:

argparse.Namespace

run(*args, **kwargs)

Run the command.

Must be implemented by sub-classes that are not simply an intermediate in the command namespace.

set(**kwargs)

Override a value in the finaly result of parsing.

class mopidy.commands.ConfigCommand

run(config, errors, schemas)

Run the command.

Must be implemented by sub-classes that are not simply an intermediate in the command namespace.

class mopidy.commands.DepsCommand

run()

Run the command.

Must be implemented by sub-classes that are not simply an intermediate in the command namespace.

class mopidy.commands.RootCommand

run(args, config)

Run the command.

Must be implemented by sub-classes that are not simply an intermediate in the command namespace.