If you want to learn how to make Mopidy extensions, read Extension development.
Base class for Mopidy extensions
The extension’s distribution name, as registered on PyPI
Example: Mopidy-Soundspot
The extension’s short name, as used in setup.py and as config section name
Example: soundspot
Get or create cache directory for the extension.
Parameters: | config – the Mopidy config object |
---|---|
Returns: | string |
Command to expose to command line users running mopidy.
Returns: | Instance of a Command class. |
---|
Get or create configuration directory for the extension.
Parameters: | config – the Mopidy config object |
---|---|
Returns: | string |
Get or create data directory for the extension.
Parameters: | config – the Mopidy config object |
---|---|
Returns: | string |
The extension’s default config as a bytestring
Returns: | bytes or unicode |
---|
Register the extension’s components in the extension Registry.
For example, to register a backend:
def setup(self, registry):
from .backend import SoundspotBackend
registry.add('backend', SoundspotBackend)
See Registry for a list of registry keys with a special meaning. Mopidy will instantiate and start any classes registered under the frontend and backend registry keys.
This method can also be used for other setup tasks not involving the extension registry.
Parameters: | registry (Registry) – the extension registry |
---|
Checks if the extension can run in the current environment.
Dependencies described by setup.py are checked by Mopidy, so you should not check their presence here.
If a problem is found, raise ExtensionError with a message explaining the issue.
Raises: | ExtensionError |
---|---|
Returns: | None |
The extension’s version
Should match the __version__ attribute on the extension’s main Python module and the version registered on PyPI.
ExtensionData(extension, entry_point, config_schema, config_defaults, command)
Alias for field number 4
Alias for field number 3
Alias for field number 2
Alias for field number 1
Alias for field number 0
Registry of components provided by Mopidy extensions.
Passed to the setup() method of all extensions. The registry can be used like a dict of string keys and lists.
Some keys have a special meaning, including, but not limited to:
Extensions can use the registry for allow other to extend the extension itself. For example the Mopidy-Local use the local:library key to allow other extensions to register library providers for Mopidy-Local to use. Extensions should namespace custom keys with the extension’s ext_name, e.g. local:foo or http:bar.