Metadata-Version: 1.1
Name: ampd
Version: 0.2.8
Summary: Asynchronous MPD client library
Home-page: http://math.univ-lyon1.fr/~begnac
Author: Itaï BEN YAACOV
Author-email: candeb@free.fr
License: GPLv3+
Download-URL: http://math.univ-lyon1.fr/~begnac/debian/gampc
Description: ===============================
        Asynchronous MPD client library
        ===============================
        
        Uses python asyncio for asynchronous communication with a Music Player Daemon server.
        
        Connection is established by a client object.
        Requests (MPD commands) are executed in asyncio coroutines, referred to here as "tasks".
        Requests are generated by an executor object.
        Each client has a root executor, and sub-executors can be constructed (for grouping related tasks).
        
        
        Tasks
        -----
        
        An AMPD task is, essentially, an asyncio coroutine.
        The ``@task`` decorator makes the coroutine execute immediately via asyncio.ensure_future.
        In addition, it wraps it so cancellation and disconnect exceptions are considered normal termination::
        
          @task
          async def task_example():
              ...
              reply = await executor.request1(a, b)
              ...
              reply = await executor.request2()
              ...
        
        The request can be:
        
        a. An MPD command [1]_ (other than ``idle`` and ``noidle``).
           Returns when the server's reply arrives::
        
             await executor.play(5)
             reply = await executor.status()
        
        b. Idle request::
        
             reply = await executor.idle(event_mask, timeout=None)
        
           This emulates MPD's ``idle`` command, with some improvements.
           The timeout is given in seconds.
           Possible event flags are:
        
           - ``Event.*SUBSYSTEM*`` (in uppercase) or ``ANY`` to match any subsystem.
           - ``Event.CONNECT`` - client is connected to server.
           - ``Event.IDLE`` - client is idle.
        
           Returns the mask of events which actually occurred, or ``Event.TIMEOUT`` if timeout occurred.
        
        c. Command list: ``executor.command_list(iterable)``.
        
        
        .. [1] For MPD commands and subsystems see http://www.musicpd.org/doc/protocol/command_reference.html
        
        .. Local Variables:
        .. ispell-local-dictionary: "british"
        .. End:
        
Keywords: mpd,Music Player Deamon,asynchronous
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.5
Classifier: Topic :: Multimedia :: Sound/Audio
Classifier: Topic :: Software Development :: Libraries :: Python Modules
