spotify 0.1.7

spotify.py is an asynchronous API wrapper for Spotify written in Python.

[](https://github.com/mental32/spotify.py/stargazers)
# spotify.py

An API library for the spotify client and the Spotify Web API written in Python.

spotify.py is 100% asyncronous meaning everything down to the HTTP library is designed to work with asyncio.<br>The library covers every endpoint in the Spotify web API and offers control over the local Spotify app.<br><br>As of v0.1.5 it is possible to use spotify.py in a syncronous manner. No await/async syntax required! To do this simply use

```py
from spotify.sync import spotify # and now no methods require the async/await syntax.
```

## Examples

Web API examples

drakes top tracks
```py
client = spotify.Client('someid', 'sometoken')

async def example():
drake = await client.get_artist('3TVXtAsR1Inumwj472S9r4')

for track in await drake.top_tracks():
print(repr(track))
```

backing up playlists
```py
import json
import time

client = spotify.Client('someid', 'sometoken')

async def backup():
user = await client.user_from_token('sometoken')
backup_data = []

for playlist in await user.get_playlists():
backup_data.append({'metadata': [playlist.name, playlist.public, playlist.collaborative, playlist.description], 'tracks': []})
for track in await playlist.get_tracks():
backup_data[-1]['tracks'].append(track.uri)

with open('spotify_playlists_%s_%s.json' % (user.id, int(time.time())), 'w') as file:
json.dump(backup_data, file)

async def restore(filename):
user = await client.user_from_token('sometoken')

with open(filename) as file:
data = json.load(file)

for playlist in data:
name, public, collab, desc = playlist['metadata']
playlist_obj = await user.create_playlist(name, public=public, collaborative=collab, description=desc)

await user.replace_tracks(playlist_obj, playlist['tracks'])
```

Local client example
```py
async with spotify.LocalClient() as local:
await local.play('spotify:track:2G7V7zsVDxg1yRsu7Ew9RJ')
```

## Resources

For resources look at the [examples](https://github.com/mental32/spotify.py/tree/master/examples) or ask in the [discord](https://discord.gg/k43FSFF)

## Installing

To install the library simply clone it and run setup.py
- `git clone https://github.com/mental32/spotify.py`
- `python3 setup.py install`

or use pypi

- `pip3 install spotify`
- `pip3 install -U git+https://github.com/mental32/spotify.py`

## Contributing
To contribute you must:
- have a presence in the [discord](https://discord.gg/k43FSFF) server
- fork and open a PR with changes.

> spotify.py is in beta, there may be bugs.