aiospotify

Aiospotify is a request-agnostic wrapper for Spotify's Web API.


Keywords
aiospotify, aiohhtp, api, asyncio, python, spotify
License
MIT
Install
pip install aiospotify==0.1.0

Documentation

aiospotify PyPI version BuildStatus Coverage Status CodeFactor

A Python wrapper for Spotify's Web API. It's request-agnostic, so it should easily integrate into your project's design.

Install

This wrapper uses Python 3.6. You can download the release here.

$ pip install aiospotify

Usage

Each method requires a token, which can be obtained after creating a Spotify application and making an instance of Aiospotify with your app's credentials.

Using aiohttp:

from aiospotify import Aiospotify

client = Aiospotify(client_id='CLIENT_ID', client_secret='CLIENT_SECRET')    
token = await client.init_auth()

# Search for an album by its name
search_results = await client.search('abbey road', token, type='album')

# Search for a specific track by its Spotify ID
track = await client.search_track('3n3Ppam7vgaVa1iaRUc9Lp', token)

Using requests:

from aiospotify import Aiospotify, connectors

client = Aiospotify(client_id='CLIENT_ID', 
                    client_secret='CLIENT_SECRET', 
                    connector=connectors.ReqConnector())    
token = client.init_auth()

# Search for an artist by their name
search_results = client.search('death grips', token, type='artist')

Methods return dictionary objects defined by Spotify's object model.

Contribute

Feel free to open an Issue or submit PRs.