archive/spotipy
1
0
Fork 0
mirror of https://github.com/c0de-archive/spotipy.git synced 2024-11-14 02:57:27 +00:00
Code Issues Projects Releases Wiki Activity
A light weight Python library for the Spotify Web API
277 Commits 1 Branch 0 Tags 607 KiB
Python 100%
6c3c384bf0
Go to file
Thomas Hooper 6c3c384bf0 Add show_dialog auth url option 
Optional. Whether or not to force the user to approve the app again if they’ve already done so. If false (default), a user who has already approved the application may be automatically redirected to the URI specified by redirect_uri. If true, the user will not be automatically redirected and will have to approve the app again.

From https://developer.spotify.com/web-api/authorization-guide/
2017-08-02 10:36:10 +01:00
docs Add me to the contributors list 2017-01-07 16:22:03 +00:00
examples Added read_a_playlist example 2017-01-18 17:55:05 -05:00
spotipy Add show_dialog auth url option 2017-08-02 10:36:10 +01:00
tests Add show_dialog auth url option 2017-08-02 10:36:10 +01:00
.gitignore Clean up of examples 2014-08-22 13:48:31 -04:00
.travis.yml Run the examples (without coverage) 2014-04-05 22:00:47 +03:00
CHANGES.txt offset/limit only makes sense for album_tracks 2015-06-03 21:16:12 -07:00
deploy Added playlist tracks method. Updated tests. 2014-11-15 07:20:11 -05:00
LICENSE.txt Packaging tweaks 2014-06-16 13:39:32 -04:00
MANIFEST.in Packaging tweaks 2014-06-16 13:39:32 -04:00
README.md bumped version 2017-01-05 06:23:58 -05:00
redirect_page.md Create redirect_page.md 2014-08-22 13:31:06 -04:00
requirements.txt Use six to simplify python 2/3 compatibilty code where possible 2017-01-07 15:18:46 +00:00
setup.py Proper requests version 2017-01-18 17:35:38 -05:00
tox.ini Use six to simplify python 2/3 compatibilty code where possible 2017-01-07 15:18:46 +00:00

README.md

Spotipy - a Python client for The Spotify Web API

Description

Spotipy is a thin client library for the Spotify Web API.

Documentation

Spotipy's full documentation is online at Spotipy Documentation

Installation

If you already have Python on your system you can install the library simply by downloading the distribution, unpack it and install in the usual fashion:

python setup.py install

You can also install it using a popular package manager with

pip install spotipy

or

easy_install spotipy

Dependencies

  • Requests - 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

  • 1.0 - 04/05/2014 - Initial release
  • 1.1 - 05/18/2014 - Repackaged for saner imports
  • 1.4.1 - 06/17/2014 - Updates to match released API
  • 1.4.2 - 06/21/2014 - Added support for retrieving starred playlists
  • v1.40, June 12, 2014 -- Initial public release.
  • v1.42, June 19, 2014 -- Removed dependency on simplejson
  • v1.43, June 27, 2014 -- Fixed JSON handling issue
  • v1.44, July 3, 2014 -- Added show tracks.py example
  • v1.45, July 7, 2014 -- Support for related artists endpoint. Don't use cache auth codes when scope changes
  • v1.49, July 23, 2014 -- Support for "Your Music" tracks (add, delete, get), with examples
  • v1.50, August 14, 2014 -- Refactored util out of examples and into the main package
  • v1.301, August 19, 2014 -- Upgraded version number to take precedence over previously botched release (sigh)
  • v1.310, August 20, 2014 -- Added playlist replace and remove methods. Added auth tests. Improved API docs
  • v2.0 - August 22, 2014 -- Upgraded APIs and docs to make it be a real library
  • v2.0.2 - August 25, 2014 -- Moved to spotipy at pypi
  • v2.1.0 - October 25, 2014 -- Added support for new_releases and featured_playlists
  • v2.2.0 - November 15, 2014 -- Added support for user_playlist_tracks
  • v2.3.0 - January 5, 2015 -- Added session support added by akx.
  • v2.3.2 - March 31, 2015 -- Added auto retry logic
  • v2.3.3 - April 1, 2015 -- added client credential flow
  • v2.3.5 - April 28, 2015 -- Fixed bug in auto retry logic
  • v2.3.6 - June 3, 2015 -- Support for offset/limit with album_tracks API
  • v2.3.7 - August 10, 2015 -- Added current_user_followed_artists
  • v2.3.8 - March 30, 2016 -- Added recs, audio features, user top lists
  • v2.4.0 - December 31, 2016 -- Incorporated a number of PRs
  • v2.4.1 - January 2, 2017 -- Incorporated proxy support
  • v2.4.2 - January 2, 2017 -- support getting audio features for a single track
  • v2.4.3 - January 2, 2017 -- fixed proxy issue in standard auth flow
  • v2.4.4 - January 4, 2017 -- python 3 fix