#!/usr/bin/python
# -*- coding: UTF8 -*
'''
This is mprisV2.1 documentation

http://www.mpris.org/2.1/spec/index.html

Also works as python lib.



Version 2.1
===========
Copyright © 2006-2010 the VideoLAN team(Mirsal Ennaime, Rafaël Carré, Jean-Paul Saman)

Copyright © 2005-2008 Milosz Derezynski

Copyright © 2008 Nick Welch

Copyright © 2010 Alex Merry

This library is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation; either version 2.1 of the License, or (at your option) any later version.

This library is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details.

You should have received a copy of the GNU Lesser General Public License along with this library; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.



About
=====
The Media Player Remote Interfacing Specification is a standard D-Bus interface which aims to provide a common programmatic API for controlling media players.

It provides a mechanism for compliant media players discovery, basic playback and media player state control as well as a tracklist interface which is used to add context to the current item.



Changes
=======
From 2.0 to 2.1:
    Added the optional org.mpris.MediaPlayer2.Playlists interface.



Bus Name Policy
===============
Each media player *must* request a unique bus name which begins with *org.mpris.MediaPlayer2*. For example:

* org.mpris.MediaPlayer2.audacious
* org.mpris.MediaPlayer2.vlc
* org.mpris.MediaPlayer2.bmp
* org.mpris.MediaPlayer2.xmms2

This allows clients to list available media players (either already running or which can be started via D-Bus activation)

In the case where the media player allows multiple instances running simultaneously, each additional instance should request a unique bus name, adding a dot and a unique identifier (such as a UNIX process id) to its usual bus name. For example, this could be

* org.mpris.MediaPlayer2.vlc.7389


Entry point
===========
The media player *must* expose the */org/mpris/MediaPlayer2* object path, which *must* implement the following interfaces:

* org.mpris.MediaPlayer2
* org.mpris.MediaPlayer2.Player

The */org/mpris/MediaPlayer2* object may implement the *org.mpris.MediaPlayer2.TrackList* interface.

The */org/mpris/MediaPlayer2* object may implement the *org.mpris.MediaPlayer2.Playlists* interface.


The PropertiesChanged signal
============================
The MPRIS uses the org.freedesktop.DBus.Properties.PropertiesChanged signal to notify clients of changes in the media player state. If a client implementation uses D-Bus bindings which do not support this signal, then it should connect to it manually. If a media player implementation uses D-Bus bindings which do not support this signal, then it should send it manually


Corrections
===========
2010-09-26: Added EmitsChangedSignal annotation to Volume property on the Player interface.

2011-01-26: Added PlaylistChanged signal to the Playlists interface.


Interfaces
==========
* org.mpris.MediaPlayer2
* org.mpris.MediaPlayer2.TrackList
* org.mpris.MediaPlayer2.Player
* org.mpris.MediaPlayer2.Playlists


'''
from __future__ import print_function
from __future__ import absolute_import

from .interfaces import Interfaces
from .mediaplayer2 import MediaPlayer2
from .player import Player
from .playlists import Playlists
from .tracklist import TrackList

from . import types as types
from . import utils as utils

if __name__ == '__main__':
    print(Interfaces)
    print(MediaPlayer2)
    print(Player)
    print(Playlists)
    print(TrackList)
    print(types)
    print(utils)
