A friendly wrapper library for the Deezer API
Project description
Deezer Python Client
A friendly wrapper around the Deezer API.
Installation
The package is published on PyPI and can be installed by running:
pip install deezer-python
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
'Monkey Business'See the whole API reference on the Sphinx generated documentation.
Asynchronous client
You also can use an AsyncClient with tornado, which requires an optional dependency. You should install with pip install deezer-python[tornado]. Then, making requests look like:
>>> from tornado.gen import coroutine
>>> from tornado.ioloop import IOLoop
>>> from deezer.contrib.tornado import AsyncClient
>>>
>>>
>>> @coroutine
... def main():
... client = AsyncClient()
... album = yield client.get_album(12)
... print(album.title)
...
>>> IOLoop.instance().run_sync(main)
Monkey BusinessAuthentication
Not supported by this package. There are excellent other python modules to handle that. There is the excellent Python Social Auth, which supports Deezer authentication.
History
1.0.0 (unreleased)
Breaking: drop support for Python 2.
0.9.0 (2019-02-10)
Add Client.advanced_search.
0.8.0 (2018-10-30)
Added index and limit to Client.search & Client.get_charts. Defaults are set to Deezer API defaults.
Changed tornado to be an optional requirement. If you want to use the asynchronous client, you need to install the library as follow pip install deezer-python[tornado].
Simplified a couple of things to rely more on six for Python compatibility.
Auto-format code using black.
0.7.0 (2018-10-03)
Breaking: the async module has been renamed asynchronous as it was breaking under Python 3.7, thanks Matheus Horstmann for the patch
Optimisation: the session is now stored internally by the client
0.6.1 (2017-06-19)
Added access token to the request kwargs. Thanks Nikolay Sheregeda for the patch.
Documentation update, thanks Khamaileon for the correction.
0.6.0 (2016-12-27)
0.5.0 (2016-12-26)
Python 3.6 support
Remove Python 3.2 classifier, support was dropped since 0.2.3
Updated docs and testing setup
0.4.0 (2016-12-08)
0.3.0 (2016-11-09)
Enriching the API for resources to get related resources as iterators. Thanks to Pascal.
0.2.3 (2016-11-07)
Drop support for Python 3.2. It should still work, but we are not testing it anymore, as this version as reached end of life.
0.2.2 (2015-09-14)
Python 3.5 support
Various doc updates
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.
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for deezer_python-1.0.0-py3-none-any.whl
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 3b80e0cd021f7cb9c8dadf5821a68e6c22ffab4d98699e4fbdfa92b238cbcb3b |
|
| MD5 | 30121f3be9f1e5b72f7058c59562f9db |
|
| BLAKE2b-256 | 743400059cb800bfda2b38f6f81ac4a923a3b3401a13fe82ca49df6f1dc12329 |
