Skip to main content

A friendly wrapper library for the Deezer API

Project description

deezer-python

Build status Test coverage percentage Documentation Status PyPi Status Code issues Code Health

A friendly wrapper around the Deezer API.

Installation

The package is published on the Python index simply run the following:

pip install deezer-python

And that’s it!

Basic Use

So far you can only retrieve the data for the public objects, for which no login is required. The objects are translated to python resources, which are basically python objects encapsulating the json dictionary returned by the API.

>>> client = deezer.Client()
>>> client.get_album(12).title
u'Monkey Business'

You also can use AsyncClient with tornado.

>>> from tornado.gen import coroutine
>>> from tornado.ioloop import IOLoop
>>> from deezer import AsyncClient
>>>
>>>
>>> @coroutine
... def main():
...     client = AsyncClient()
...     album = yield client.get_album(12)
...     print(album.title)
...
>>> IOLoop.instance().run_sync(main)
Monkey Business

See the whole API on the Sphinx generated documentation.

Authentication

Not supported yet, only public API accessible

Running Tests

The unit tests are using python unittest framework, just run:

% python -m unittest discover
......
----------------------------------------------------------------------
Ran 6 tests in 0.448s

OK

Create a New Release

This project is configured to use bumpversion, only prerequisite is to have it installed. When the tests have passed and you’re happy with the code base, just need to run:

$ bumpversion [major|minor|patch]

Depending on which digit of the version needs to be updated, and then push with tags:

$ git push --tags

Travis will take care of creating the release, and upload it to PyPi.

History

0.2.0 (2015-01-31)

  • Enriching the API for resources to get artists for a genre, top tracks of an artist, etc… Thanks to Misuzu

0.1.0 (2014-11-22)

  • Initial release.

Credits

“deezer-python” is written and maintained by Bruno Alla.

Contributors

Other people contributed to this project:

Please add yourself here alphabetically when you submit your first pull request.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

deezer-python-0.3.0.tar.gz (35.9 kB view hashes)

Uploaded Source

Built Distribution

deezer_python-0.3.0-py2-none-any.whl (10.4 kB view hashes)

Uploaded Python 2

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page