Source code for mopidy.mpd.protocol.reflection
from __future__ import unicode_literals
from mopidy.mpd.exceptions import MpdPermissionError
from mopidy.mpd.protocol import handle_request, mpd_commands
@handle_request(r'config$', auth_required=False)
[docs]def config(context):
"""
*musicpd.org, reflection section:*
``config``
Dumps configuration values that may be interesting for the client. This
command is only permitted to "local" clients (connected via UNIX domain
socket).
"""
raise MpdPermissionError(command='config')
@handle_request(r'commands$', auth_required=False)
[docs]def commands(context):
"""
*musicpd.org, reflection section:*
``commands``
Shows which commands the current user has access to.
"""
if context.dispatcher.authenticated:
command_names = set([command.name for command in mpd_commands])
else:
command_names = set([
command.name for command in mpd_commands
if not command.auth_required])
# No one is permited to use 'config' or 'kill', rest of commands are not
# listed by MPD, so we shouldn't either.
command_names = command_names - set([
'config', 'kill', 'command_list_begin', 'command_list_ok_begin',
'command_list_ok_begin', 'command_list_end', 'idle', 'noidle',
'sticker'])
return [
('command', command_name) for command_name in sorted(command_names)]
@handle_request(r'decoders$')
[docs]def decoders(context):
"""
*musicpd.org, reflection section:*
``decoders``
Print a list of decoder plugins, followed by their supported
suffixes and MIME types. Example response::
plugin: mad
suffix: mp3
suffix: mp2
mime_type: audio/mpeg
plugin: mpcdec
suffix: mpc
*Clarifications:*
- ncmpcpp asks for decoders the first time you open the browse view. By
returning nothing and OK instead of an not implemented error, we avoid
"Not implemented" showing up in the ncmpcpp interface, and we get the
list of playlists without having to enter the browse interface twice.
"""
return # TODO
@handle_request(r'notcommands$', auth_required=False)
[docs]def notcommands(context):
"""
*musicpd.org, reflection section:*
``notcommands``
Shows which commands the current user does not have access to.
"""
if context.dispatcher.authenticated:
command_names = []
else:
command_names = [
command.name for command in mpd_commands if command.auth_required]
# No permission to use
command_names.append('config')
command_names.append('kill')
return [
('command', command_name) for command_name in sorted(command_names)]
@handle_request(r'tagtypes$')
[docs]def tagtypes(context):
"""
*musicpd.org, reflection section:*
``tagtypes``
Shows a list of available song metadata.
"""
pass # TODO
@handle_request(r'urlhandlers$')
[docs]def urlhandlers(context):
"""
*musicpd.org, reflection section:*
``urlhandlers``
Gets a list of available URL handlers.
"""
return [
('handler', uri_scheme)
for uri_scheme in context.core.uri_schemes.get()]