nickdelnano/spotipy

A Python library for the Spotify Web API; forked to add MySQL integration

ndelnano-spotipy - a Python client for The Spotify Web API, which fetches and saves OAuth tokens in MySQL.

pip install ndelnano-spotipy

Description

ndelnano-spotipy is a fork of spotipy, which is a thin client library for the Spotify Web API.

Differences in this fork!

Currently two things:

• Batching data to endpoints used in the recently-played-playlists. So far these endpoints include: checking saved tracks in user library, adding tracks to a user's playlist. There is likely more to come as that project progresses.
• Support for refreshing and storing user's OAuth tokens in MySQL. When an API call fails due to an expired token, ndelnano-spotipy refreshed the token, stores the new token in MySQL, and retries. See the schema of recently-played-playlists in its root directory.

To get started:

def get_spotify_client_for_username(username):
    credentials = SpotifyClientCredentials(
        username,
        db_creds=db.db.get_db_creds(),
        spotify_app_creds=get_spotify_app_creds()
    )

return spotipy.Spotify(client_credentials_manager=credentials)

All you need is the username UNIQUE KEY from the users table to get an API client!

db_creds - dict of form: { 'DB_HOST' : '', 'DB_USER' : '', 'DB_PASS' : '', 'DB_NAME' : '' }

spotify_app_creds - dict of form: { 'SPOTIFY_CLIENT_ID' : '', 'SPOTIFY_CLIENT_SECRET : '' } These are credentials from your Spotify developer application.

## Documentation

Spotipy's full documentation is online at [Spotipy Documentation](http://spotipy.readthedocs.org/).


## Installation
If you already have [Python](http://www.python.org/) on your system you can install the library simply by downloading the distribution, unpack it and install in the usual fashion:

```bash
python setup.py install

You can also install it using a popular package manager with

pip install ndelnano_spotipy

or

easy_install ndelnano_spotipy

Dependencies

• Requests - ndelnano_spotipy requires the requests package to be installed

Quick Start

To get started, simply install spotipy, create a Spotify object and call methods:

import spotipy
sp = spotipy.Spotify()

results = sp.search(q='weezer', limit=20)
for i, t in enumerate(results['tracks']['items']):
    print ' ', i, t['name']

A full set of examples can be found in the online documentation and in the Spotipy examples directory.

Reporting Issues

If you have suggestions, bugs or other issues specific to this library, file them here. Or just send me a pull request.

Version

TODO when official release is ready