SpotifyEx

Elixir Wrapper for the Spotify Web API

Documentation

Installation

1. Add spotify_ex to your list of dependencies in mix.exs:

def deps do
 [{:spotify_ex, "~> 2.2.1"}]
end

2. Ensure spotify_ex is started before your application:

def application do
  [applications: [:spotify_ex]]
end

What does this wrapper cover?

This wrapper covers the Spotify Web API.

Follow the abovementioned link. On the left you'll notice that the API is broken into sections, such as Artists, Albums, Playlists, etc. This wrapper does its best to keep endpoints in modules mapped to their corresponding section. However, Spotify duplicates many of its endpoints. For example, there is an endpoint to obtain an artist's albums that is listed under both Artists and Albums. The endpoints are not duplicated in this wrapper, so if you don't see an endpoint, it can be found in a module that's also related to that endpoint i.e, if you don't see that endpoint in the Artist module, check Albums.

These duplicate endpoints may get aliased in the future to have a 1-1 mapping with the docs.

Usage

docs

A basic Phoenix example can be found at SpotifyExTest

OAuth

Oauth README

Scopes

Scopes README

Contributing

All contributions are more than welcome! I will not accept a PR without tests if it looks like something that should be tested (which is pretty much everything.) Development is done on the development branch, and moved to master for release on hexpm. Code must be formatted using hex format.