Metadata-Version: 1.1
Name: python-musicpd
Version: 0.4.0
Summary: An MPD (Music Player Daemon) client library written in pure Python.
Home-page: http://kaliko.me/code/python-musicpd
Author: Kaliko Jack
Author-email: kaliko@azylum.org
License: Copyright (C) 2008-2010  J. Alexander Treuman <jat@spatialrift.net>
Copyright (C) 2012-2013  Kaliko Jack <kaliko@azylum.org>

python-musicpd 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 3 of the License, or
(at your option) any later version.

python-musicpd 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 python-musicpd.  If not, see <http://www.gnu.org/licenses/>.
Download-URL: http://pypi.python.org/pypi/python-musicpd/
Description: ==============
        python-musicpd
        ==============
        
        Getting python-musicpd
        ----------------------
        
        The latest release of python-musicpd can be found at
        http://pypi.python.org/pypi/python-musicpd.
        
        
        Getting the latest source code
        ------------------------------
        
        If you would instead like to use the latest source code, you can grab a copy
        of the development version from git by running the command:
        
          git clone git://git.kaliko.me/python-musicpd.git
        
        
        Installing from source
        ----------------------
        
        To install python-musicpd from source, simply run the command::
        
          python3 setup.py install
        
        You can use the `--help` switch to `setup.py` for a complete list of commands
        and their options.  See the `Installing Python Modules`_ document for more details.
        
        
        Using the client library
        ------------------------
        
        The client library can be used as follows::
        
            client = musicpd.MPDClient()       # create client object
            client.connect('localhost', 6600)  # connect to localhost:6600
            print client.mpd_version           # print the mpd version
            print client.cmd('one', 2)         # print result of the command "cmd one 2"
            client.close()                     # send the close command
            client.disconnect()                # disconnect from the server
        
        A list of supported commands, their arguments (as MPD currently understands
        them), and the functions used to parse their responses can be found in
        `doc/commands.txt`.  See the `MPD protocol documentation`_ for more
        details.
        
        Command lists are also supported using `command_list_ok_begin()` and
        `command_list_end()` ::
        
            client.command_list_ok_begin()       # start a command list
            client.update()                      # insert the update command into the list
            client.status()                      # insert the status command into the list
            results = client.command_list_end()  # results will be a list with the results
        
        
        Commands may also return iterators instead of lists if `iterate` is set to
        `True`::
        
            client.iterate = True
            for song in client.playlistinfo():
                print song['file']
        
        
        Contacting authors
        ------------------
        
        You can contact the original author by emailing J. Alexander Treuman
        <jat⊘spatialrift.net>.  He can also be found idling in #mpd on
        irc.freenode.net as jat.
        
        The current maintainer can be found on xmpp chat room <kaliko.me⊘conf.azylum.org>
        or you can contact him by email/xmpp <kaliko⊘azylum.org>.
        
         .. _Installing Python Modules: http://docs.python.org/3/install/
         .. _MPD protocol documentation: http://www.musicpd.org/doc/protocol/
        
Keywords: mpd
Platform: Independant
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: GNU Library or Lesser General Public License (LGPL)
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Software Development :: Libraries :: Python Modules
