Metadata-Version: 1.1
Name: lastfmclient
Version: 0.0.3
Summary: Python client for the Last.fm API with a pythonic interface to all methods,
including auth, etc. An async, Tornado-based client included as well.
Home-page: https://github.com/jakubroztocil/lastfmclient
Author: UNKNOWN
Author-email: BSD
License: BSD
Download-URL: https://github.com/jakubroztocil/lastfmclient
Description: ``lastfmclient``
        ################
        
        Python client for the `Last.fm API <http://www.last.fm/api>`_ with a
        pythonic interface. Also includes an async variant of the client for
        `Tornado <https://github.com/facebook/tornado>`_.
        
        
        Usage
        =====
        
        Regular
        -------
        
        .. code-block:: python
        
            from lastfmclient import LastfmClient
        
            api = LastfmClient(
                api_key=KEY,
                api_secret=SECRET,
                session_key=session_key
            )
        
            resp = api.track.update_now_playing(
                track='Paranoid Android',
                artist='Radiohead',
                album='OK Computer',
            )
        
            print resp
        
        
        Asynchronous (uses ``tornado.httpclient.AsyncHTTPClient``)
        ----------------------------------------------------------
        
        .. code-block:: python
        
            import tornado.web
            import tornado.gen
            from lastfmclient.async import AsyncLastfmClient
        
            class Scrobbler(tornado.web.RequestHandler):
        
                @tornado.gen.coroutine
                def post(self):
                    api = AsyncLastfmClient(
                        api_key=KEY,
                        api_secret=SECRET,
                        session_key=session_key
                    )
        
                    resp = yield api.track.update_now_playing(
                        track='Paranoid Android',
                        artist='Radiohead',
                        album='OK Computer',
                    )
                    self.finish(resp)
        
        
        See also `examples <https://github.com/jakubroztocil/lastfmclient/tree/master/examples>`_.
        
        
        Client methods
        ==============
        
        All the methods the Last.fm API provides are mirrored in the client with
        rich docstrings and arguments description. This code is actually generated
        directly from the online API documentation pages
        (see ``./generate.py``, ``./api.json``, and ``./lastfmclient/api.py``).
        
        The defined methods be updated to the current version of the documentation via:
        
        
        .. code-block:: bash
        
            $ pip install -r requirements.txt lxml
        
            # 1. Generate fresh api.json from docs at http://www.last.fm/api:
            $ make spec
        
            # 2. Generate `lastfm/api.py` from `api.json`:
            $ make code
        
            # Or, all the above in one step:
            $ make
        
        
        Contact
        =======
        
        Jakub Roztočil
        
        * http://github.com/jakubroztocil
        * http://twitter.com/jakubroztocil
        * jakub@subtleapps.com
        
        
Platform: UNKNOWN
