spotify 0.0.0 → 7.0.0

data/LICENSE

@@ -0,0 +1,19 @@
+Copyright (c) 2011 Kim Burgestrand <kim@burgestrand.se>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.markdown

@@ -0,0 +1,25 @@
+libspotify FFI bindings for Ruby
+================================
+[libspotify](http://developer.spotify.com/en/libspotify/overview/) is a C library which allows developers to interact with the Spotify music streaming service. I wanted to be able to use this library in Ruby, and thus [Hallon](https://github.com/Burgestrand/Hallon) was born. Hallon, however, is more than just bindings to libspotify, it’s my attempt to make the API a joy to use. This is Ruby, after all!
+
+Hallon recently changed from being a C extension to using [Ruby FFI](https://github.com/ffi/ffi), and in the process I created libspotify for Ruby. I decided to extract that work into its’ own gem, and here it is.
+
+This is a very primitive library!
+---------------------------------
+There is no sugar-coating. When (if) you use this library you will practically be writing C, handling pointers and so on; only you’ll be doing it in Ruby.
+
+If you want a library that is easier to use, have a look at [Hallon](https://github.com/Burgestrand/Hallon).
+
+A note about versioning scheme
+------------------------------
+Given a version `X.Y.Z`, each segment corresponds to:
+
+- X reflects supported libspotify version (0.0.7 => 7)
+- Y is increased **only** on non-backwards-compatible bug fixes or feature additions
+- Z is increased on backwards-compatible bug fixes or feature additions
+
+When X increases (support for new libspotify versions) there are **no guarantees** of backwards-compatibility.
+
+License
+-------
+X11 license, see the LICENSE document for details.

data/Rakefile

@@ -1,3 +1,13 @@
 require 'bundler'
+Bundler::GemHelper.install_tasks
 
-Bundler::GemHelper.install_tasks
+require 'rake/testtask'
+Rake::TestTask.new do |spec|
+  spec.pattern = 'spec/*_spec.rb'
+end
+
+require 'yard'
+YARD::Rake::YardocTask.new
+
+task :spec => :test
+task :default => :test

data/lib/spotify.rb

@@ -1,7 +1,476 @@
+# coding: utf-8
 require 'ffi'
-
 require 'spotify/version'
 
+# FFI wrapper around libspotify.
+# 
+# See official documentation for more detailed documentation about
+# functions and their behavior.
+# 
+# @see http://developer.spotify.com/en/libspotify/docs/
 module Spotify
+  extend FFI::Library
+  ffi_lib ['libspotify', '/Library/Frameworks/libspotify.framework/libspotify']
+  
+  # libspotify API version
+  # @return [Fixnum]
+  API_VERSION = VERSION.split('.').first.to_i
+  
+  #
+  # Error
+  # 
+  # @see http://developer.spotify.com/en/libspotify/docs/group__error.html
+  enum :error, [:ok, :bad_api_version, :api_initialization_failed,
+               :track_not_playable, :resource_not_loaded,
+               :bad_application_key, :bad_username_or_password,
+               :user_banned, :unable_to_contact_server,
+               :client_too_old, :other_permanent, :bad_user_agent,
+               :missing_callback, :invalid_indata,
+               :index_out_of_range, :user_needs_premium,
+               :other_transient, :is_loading, :no_stream_available,
+               :permission_denied, :inbox_is_full, :no_cache,
+               :no_such_user]
+  
+  attach_function :error_message, :sp_error_message, [ :error ], :string
+  
+  #
+  # Audio
+  # 
+  # @see http://developer.spotify.com/en/libspotify/docs/group__session.html
+  enum :sampletype, [:int16_native_endian]
+  enum :bitrate, %w(160k 320k)
+  
+  # FFI::Struct for Audio Format.
+  # 
+  # @attr [:sampletype] sample_type
+  # @attr [Fixnum] sample_rate
+  # @attr [Fixnum] channels
+  class AudioFormat < FFI::Struct
+    layout :sample_type => :sampletype,
+           :sample_rate => :int,
+           :channels => :int
+  end
+
+  # FFI::Struct for Audio Buffer Stats.
+  # 
+  # @attr [Fixnum] samples
+  # @attr [Fixnum] stutter
+  class AudioBufferStats < FFI::Struct
+    layout :samples => :int,
+           :stutter => :int
+  end
+  
+  #
+  # Session
+  # 
+  # @see http://developer.spotify.com/en/libspotify/docs/group__session.html
+  enum :connectionstate, [:logged_out, :logged_in, :disconnected, :undefined]
+
+  attach_function :session_create, :sp_session_create, [ :pointer, :pointer ], :error
+  attach_function :session_release, :sp_session_release, [ :pointer ], :void
+  attach_function :session_login, :sp_session_login, [ :pointer, :string, :string ], :void
+  attach_function :session_user, :sp_session_user, [ :pointer ], :pointer
+  attach_function :session_logout, :sp_session_logout, [ :pointer ], :void
+  attach_function :session_connectionstate, :sp_session_connectionstate, [ :pointer ], :connectionstate
+  attach_function :session_userdata, :sp_session_userdata, [ :pointer ], :pointer
+  attach_function :session_set_cache_size, :sp_session_set_cache_size, [ :pointer, :size_t ], :void
+  attach_function :session_process_events, :sp_session_process_events, [ :pointer, :pointer ], :void
+  attach_function :session_player_load, :sp_session_player_load, [ :pointer, :pointer ], :error
+  attach_function :session_player_seek, :sp_session_player_seek, [ :pointer, :int ], :void
+  attach_function :session_player_play, :sp_session_player_play, [ :pointer, :bool ], :void
+  attach_function :session_player_unload, :sp_session_player_unload, [ :pointer ], :void
+  attach_function :session_player_prefetch, :sp_session_player_prefetch, [ :pointer, :pointer ], :error
+  attach_function :session_playlistcontainer, :sp_session_playlistcontainer, [ :pointer ], :pointer
+  attach_function :session_inbox_create, :sp_session_inbox_create, [ :pointer ], :pointer
+  attach_function :session_starred_create, :sp_session_starred_create, [ :pointer ], :pointer
+  attach_function :session_starred_for_user_create, :sp_session_starred_for_user_create, [ :pointer, :string ], :pointer
+  attach_function :session_publishedcontainer_for_user_create, :sp_session_publishedcontainer_for_user_create, [ :pointer, :string ], :pointer
+  attach_function :session_preferred_bitrate, :sp_session_preferred_bitrate, [ :pointer, :bitrate ], :void
+  attach_function :session_num_friends, :sp_session_num_friends, [ :pointer ], :int
+  attach_function :session_friend, :sp_session_friend, [ :pointer, :int ], :pointer
+
+  # FFI::Struct for Session callbacks.
+  # 
+  # @attr [callback(:pointer, :error):void] logged_in
+  # @attr [callback(:pointer):void] logged_out
+  # @attr [callback(:pointer):void] metadata_updated
+  # @attr [callback(:pointer, :error):void] connection_error
+  # @attr [callback(:pointer, :string):void] message_to_user
+  # @attr [callback(:pointer):void] notify_main_thread
+  # @attr [callback(:pointer, :pointer, :pointer, :int):int] music_delivery
+  # @attr [callback(:pointer):void] play_token_lost
+  # @attr [callback(:pointer, :string):void] log_message
+  # @attr [callback(:pointer):void] end_of_track
+  # @attr [callback(:pointer, :error):void] streaming_error
+  # @attr [callback(:pointer):void] userinfo_updated
+  # @attr [callback(:pointer):void] start_playback
+  # @attr [callback(:pointer):void] stop_playback
+  # @attr [callback(:pointer, :pointer):void] get_audio_buffer_stats
+  class SessionCallbacks < FFI::Struct
+    layout :logged_in => callback([ :pointer, :error ], :void),
+           :logged_out => callback([ :pointer ], :void),
+           :metadata_updated => callback([ :pointer ], :void),
+           :connection_error => callback([ :pointer, :error ], :void),
+           :message_to_user => callback([ :pointer, :string ], :void),
+           :notify_main_thread => callback([ :pointer ], :void),
+           :music_delivery => callback([ :pointer, :pointer, :pointer, :int ], :int),
+           :play_token_lost => callback([ :pointer ], :void),
+           :log_message => callback([ :pointer, :string ], :void),
+           :end_of_track => callback([ :pointer ], :void),
+           :streaming_error => callback([ :pointer, :error ], :void),
+           :userinfo_updated => callback([ :pointer ], :void),
+           :start_playback => callback([ :pointer ], :void),
+           :stop_playback => callback([ :pointer ], :void),
+           :get_audio_buffer_stats => callback([ :pointer, :pointer ], :void)
+  end
+
+  # FFI::Struct for Session configuration.
+  # 
+  # @attr [Fixnum] api_version
+  # @attr [Pointer] cache_location
+  # @attr [Pointer] settings_location
+  # @attr [size_t] application_key_size
+  # @attr [Pointer] user_agent
+  # @attr [Pointer] callbacks
+  # @attr [Pointer] userdata
+  # @attr [Fixnum] dont_save_metadata_for_playlists
+  # @attr [Fixnum] initially_unload_playlists
+  class SessionConfig < FFI::Struct
+    layout :api_version => :int,
+           :cache_location => :pointer,
+           :settings_location => :pointer,
+           :application_key => :pointer,
+           :application_key_size => :size_t,
+           :user_agent => :pointer,
+           :callbacks => :pointer,
+           :userdata => :pointer,
+           :compress_playlists => :int,
+           :dont_save_metadata_for_playlists => :int,
+           :initially_unload_playlists => :int    
+  end
+  
+  #
+  # Link
+  # 
+  # @see http://developer.spotify.com/en/libspotify/docs/group__link.html
+  enum :linktype, [:invalid, :track, :album, :artist, :search,
+                   :playlist, :profile, :starred, :localtrack]
+
+  attach_function :link_create_from_string, :sp_link_create_from_string, [ :string ], :pointer
+  attach_function :link_create_from_track, :sp_link_create_from_track, [ :pointer, :int ], :pointer
+  attach_function :link_create_from_album, :sp_link_create_from_album, [ :pointer ], :pointer
+  attach_function :link_create_from_artist, :sp_link_create_from_artist, [ :pointer ], :pointer
+  attach_function :link_create_from_search, :sp_link_create_from_search, [ :pointer ], :pointer
+  attach_function :link_create_from_playlist, :sp_link_create_from_playlist, [ :pointer ], :pointer
+  attach_function :link_create_from_user, :sp_link_create_from_user, [ :pointer ], :pointer
+  attach_function :link_as_string, :sp_link_as_string, [ :pointer, :buffer_out, :int ], :int
+  attach_function :link_type, :sp_link_type, [ :pointer ], :linktype
+  attach_function :link_as_track, :sp_link_as_track, [ :pointer ], :pointer
+  attach_function :link_as_track_and_offset, :sp_link_as_track_and_offset, [ :pointer, :pointer ], :pointer
+  attach_function :link_as_album, :sp_link_as_album, [ :pointer ], :pointer
+  attach_function :link_as_artist, :sp_link_as_artist, [ :pointer ], :pointer
+  attach_function :link_as_user, :sp_link_as_user, [ :pointer ], :pointer
+  attach_function :link_add_ref, :sp_link_add_ref, [ :pointer ], :void
+  attach_function :link_release, :sp_link_release, [ :pointer ], :void
+  
+  #
+  # Tracks
+  # 
+  # @see http://developer.spotify.com/en/libspotify/docs/group__track.html
+  attach_function :track_is_loaded, :sp_track_is_loaded, [ :pointer ], :bool
+  attach_function :track_error, :sp_track_error, [ :pointer ], :error
+  attach_function :track_is_available, :sp_track_is_available, [ :pointer, :pointer ], :bool
+  attach_function :track_is_local, :sp_track_is_local, [ :pointer, :pointer ], :bool
+  attach_function :track_is_autolinked, :sp_track_is_autolinked, [ :pointer, :pointer ], :bool
+  attach_function :track_is_starred, :sp_track_is_starred, [ :pointer, :pointer ], :bool
+  attach_function :track_set_starred, :sp_track_set_starred, [ :pointer, :pointer, :int, :bool ], :void
+  attach_function :track_num_artists, :sp_track_num_artists, [ :pointer ], :int
+  attach_function :track_artist, :sp_track_artist, [ :pointer, :int ], :pointer
+  attach_function :track_album, :sp_track_album, [ :pointer ], :pointer
+  attach_function :track_name, :sp_track_name, [ :pointer ], :string
+  attach_function :track_duration, :sp_track_duration, [ :pointer ], :int
+  attach_function :track_popularity, :sp_track_popularity, [ :pointer ], :int
+  attach_function :track_disc, :sp_track_disc, [ :pointer ], :int
+  attach_function :track_index, :sp_track_index, [ :pointer ], :int
+  attach_function :localtrack_create, :sp_localtrack_create, [ :string, :string, :string, :int ], :pointer
+  attach_function :track_add_ref, :sp_track_add_ref, [ :pointer ], :void
+  attach_function :track_release, :sp_track_release, [ :pointer ], :void
+  
+  #
+  # Albums
+  # 
+  # @see http://developer.spotify.com/en/libspotify/docs/group__album.html
+  enum :albumtype, [:album, :single, :compilation, :unknown]
+
+  attach_function :album_is_loaded, :sp_album_is_loaded, [ :pointer ], :bool
+  attach_function :album_is_available, :sp_album_is_available, [ :pointer ], :bool
+  attach_function :album_artist, :sp_album_artist, [ :pointer ], :pointer
+  attach_function :album_cover, :sp_album_cover, [ :pointer ], :pointer
+  attach_function :album_name, :sp_album_name, [ :pointer ], :string
+  attach_function :album_year, :sp_album_year, [ :pointer ], :int
+  attach_function :album_type, :sp_album_type, [ :pointer ], :albumtype
+  attach_function :album_add_ref, :sp_album_add_ref, [ :pointer ], :void
+  attach_function :album_release, :sp_album_release, [ :pointer ], :void
+  
+  #
+  # Album Browser
+  # 
+  # @see http://developer.spotify.com/en/libspotify/docs/group__albumbrowse.html
+  attach_function :albumbrowse_create, :sp_albumbrowse_create, [ :pointer, :pointer, callback([:pointer, :pointer], :void), :pointer ], :pointer
+  attach_function :albumbrowse_is_loaded, :sp_albumbrowse_is_loaded, [ :pointer ], :bool
+  attach_function :albumbrowse_error, :sp_albumbrowse_error, [ :pointer ], :error
+  attach_function :albumbrowse_album, :sp_albumbrowse_album, [ :pointer ], :pointer
+  attach_function :albumbrowse_artist, :sp_albumbrowse_artist, [ :pointer ], :pointer
+  attach_function :albumbrowse_num_copyrights, :sp_albumbrowse_num_copyrights, [ :pointer ], :int
+  attach_function :albumbrowse_copyright, :sp_albumbrowse_copyright, [ :pointer, :int ], :string
+  attach_function :albumbrowse_num_tracks, :sp_albumbrowse_num_tracks, [ :pointer ], :int
+  attach_function :albumbrowse_track, :sp_albumbrowse_track, [ :pointer, :int ], :pointer
+  attach_function :albumbrowse_review, :sp_albumbrowse_review, [ :pointer ], :string
+  attach_function :albumbrowse_add_ref, :sp_albumbrowse_add_ref, [ :pointer ], :void
+  attach_function :albumbrowse_release, :sp_albumbrowse_release, [ :pointer ], :void
+  
+  #
+  # Artists
+  # 
+  # @see http://developer.spotify.com/en/libspotify/docs/group__artist.html
+  attach_function :artist_name, :sp_artist_name, [ :pointer ], :string
+  attach_function :artist_is_loaded, :sp_artist_is_loaded, [ :pointer ], :bool
+  attach_function :artist_add_ref, :sp_artist_add_ref, [ :pointer ], :void
+  attach_function :artist_release, :sp_artist_release, [ :pointer ], :void
+  
+  #
+  # Artist Browsing
+  # 
+  # @see http://developer.spotify.com/en/libspotify/docs/group__artistbrowse.html
+  attach_function :artistbrowse_create, :sp_artistbrowse_create, [ :pointer, :pointer, callback([:pointer, :pointer], :void), :pointer ], :pointer
+  attach_function :artistbrowse_is_loaded, :sp_artistbrowse_is_loaded, [ :pointer ], :bool
+  attach_function :artistbrowse_error, :sp_artistbrowse_error, [ :pointer ], :error
+  attach_function :artistbrowse_artist, :sp_artistbrowse_artist, [ :pointer ], :pointer
+  attach_function :artistbrowse_num_portraits, :sp_artistbrowse_num_portraits, [ :pointer ], :int
+  attach_function :artistbrowse_portrait, :sp_artistbrowse_portrait, [ :pointer, :int ], :pointer
+  attach_function :artistbrowse_num_tracks, :sp_artistbrowse_num_tracks, [ :pointer ], :int
+  attach_function :artistbrowse_track, :sp_artistbrowse_track, [ :pointer, :int ], :pointer
+  attach_function :artistbrowse_num_albums, :sp_artistbrowse_num_albums, [ :pointer ], :int
+  attach_function :artistbrowse_album, :sp_artistbrowse_album, [ :pointer, :int ], :pointer
+  attach_function :artistbrowse_num_similar_artists, :sp_artistbrowse_num_similar_artists, [ :pointer ], :int
+  attach_function :artistbrowse_similar_artist, :sp_artistbrowse_similar_artist, [ :pointer, :int ], :pointer
+  attach_function :artistbrowse_biography, :sp_artistbrowse_biography, [ :pointer ], :string
+  attach_function :artistbrowse_add_ref, :sp_artistbrowse_add_ref, [ :pointer ], :void
+  attach_function :artistbrowse_release, :sp_artistbrowse_release, [ :pointer ], :void
+  
+  #
+  # Images
+  # 
+  # @see http://developer.spotify.com/en/libspotify/docs/group__image.html
+  enum :imageformat, [:unknown, -1, :jpeg]
+
+  callback :image_loaded, [ :pointer, :pointer ], :void
+  attach_function :image_create, :sp_image_create, [ :pointer, :uchar], :pointer
+  attach_function :image_add_load_callback, :sp_image_add_load_callback, [ :pointer, :image_loaded, :pointer ], :void
+  attach_function :image_remove_load_callback, :sp_image_remove_load_callback, [ :pointer, :image_loaded, :pointer ], :void
+  attach_function :image_is_loaded, :sp_image_is_loaded, [ :pointer ], :bool
+  attach_function :image_error, :sp_image_error, [ :pointer ], :error
+  attach_function :image_format, :sp_image_format, [ :pointer ], :imageformat
+  attach_function :image_data, :sp_image_data, [ :pointer, :pointer ], :pointer
+  attach_function :image_image_id, :sp_image_image_id, [ :pointer ], :pointer # string?
+  attach_function :image_add_ref, :sp_image_add_ref, [ :pointer ], :void
+  attach_function :image_release, :sp_image_release, [ :pointer ], :void
+  
+  #
+  # Searching
+  # 
+  # @see http://developer.spotify.com/en/libspotify/docs/group__search.html
+  enum :radio_genre, {
+    :alt_pop_rock => 0x1,
+    :blues        => 0x2,
+    :country      => 0x4,
+    :disco        => 0x8,
+    :funk         => 0x10,
+    :hard_rock    => 0x20,
+    :heavy_metal  => 0x40,
+    :rap          => 0x80,
+    :house        => 0x100,
+    :jazz         => 0x200,
+    :new_wave     => 0x400,
+    :rnb          => 0x800,
+    :pop          => 0x1000,
+    :punk         => 0x2000,
+    :reggae       => 0x4000,
+    :pop_rock     => 0x8000,
+    :soul         => 0x10000,
+    :techno       => 0x20000
+  }.flatten
+
+
+  attach_function :search_create, :sp_search_create, [ :pointer, :string, :int, :int, :int, :int, :int, :int, callback([:pointer, :pointer], :void), :pointer ], :pointer
+  attach_function :radio_search_create, :sp_radio_search_create, [ :pointer, :uint, :uint, :radio_genre, :pointer, :pointer ], :pointer
+  attach_function :search_is_loaded, :sp_search_is_loaded, [ :pointer ], :bool
+  attach_function :search_error, :sp_search_error, [ :pointer ], :error
+  attach_function :search_num_tracks, :sp_search_num_tracks, [ :pointer ], :int
+  attach_function :search_track, :sp_search_track, [ :pointer, :int ], :pointer
+  attach_function :search_num_albums, :sp_search_num_albums, [ :pointer ], :int
+  attach_function :search_album, :sp_search_album, [ :pointer, :int ], :pointer
+  attach_function :search_num_artists, :sp_search_num_artists, [ :pointer ], :int
+  attach_function :search_artist, :sp_search_artist, [ :pointer, :int ], :pointer
+  attach_function :search_query, :sp_search_query, [ :pointer ], :string
+  attach_function :search_did_you_mean, :sp_search_did_you_mean, [ :pointer ], :string
+  attach_function :search_total_tracks, :sp_search_total_tracks, [ :pointer ], :int
+  attach_function :search_total_albums, :sp_search_total_albums, [ :pointer ], :int
+  attach_function :search_total_artists, :sp_search_total_artists, [ :pointer ], :int
+  attach_function :search_add_ref, :sp_search_add_ref, [ :pointer ], :void
+  attach_function :search_release, :sp_search_release, [ :pointer ], :void
+  
+  #
+  # Playlists
+  # 
+  # @see http://developer.spotify.com/en/libspotify/docs/group__playlist.html
+  enum :playlist_type, [:playlist, :start_folder, :end_folder, :placeholder]
+
+  attach_function :playlist_is_loaded, :sp_playlist_is_loaded, [ :pointer ], :bool
+  attach_function :playlist_add_callbacks, :sp_playlist_add_callbacks, [ :pointer, :pointer, :pointer ], :void
+  attach_function :playlist_remove_callbacks, :sp_playlist_remove_callbacks, [ :pointer, :pointer, :pointer ], :void
+  attach_function :playlist_num_tracks, :sp_playlist_num_tracks, [ :pointer ], :int
+  attach_function :playlist_track, :sp_playlist_track, [ :pointer, :int ], :pointer
+  attach_function :playlist_track_create_time, :sp_playlist_track_create_time, [ :pointer, :int ], :int
+  attach_function :playlist_track_creator, :sp_playlist_track_creator, [ :pointer, :int ], :pointer
+  attach_function :playlist_track_seen, :sp_playlist_track_seen, [ :pointer, :int ], :bool
+  attach_function :playlist_track_set_seen, :sp_playlist_track_set_seen, [ :pointer, :int, :bool ], :error
+  attach_function :playlist_track_message, :sp_playlist_track_message, [ :pointer, :int ], :string
+  attach_function :playlist_name, :sp_playlist_name, [ :pointer ], :string
+  attach_function :playlist_rename, :sp_playlist_rename, [ :pointer, :string ], :error
+  attach_function :playlist_owner, :sp_playlist_owner, [ :pointer ], :pointer
+  attach_function :playlist_is_collaborative, :sp_playlist_is_collaborative, [ :pointer ], :bool
+  attach_function :playlist_set_collaborative, :sp_playlist_set_collaborative, [ :pointer, :bool ], :void
+  attach_function :playlist_set_autolink_tracks, :sp_playlist_set_autolink_tracks, [ :pointer, :bool ], :void
+  attach_function :playlist_get_description, :sp_playlist_get_description, [ :pointer ], :string
+  attach_function :playlist_get_image, :sp_playlist_get_image, [ :pointer, :uchar ], :bool
+  attach_function :playlist_has_pending_changes, :sp_playlist_has_pending_changes, [ :pointer ], :bool
+  attach_function :playlist_add_tracks, :sp_playlist_add_tracks, [ :pointer, :pointer, :int, :int, :pointer ], :error
+  attach_function :playlist_remove_tracks, :sp_playlist_remove_tracks, [ :pointer, :pointer, :int ], :error
+  attach_function :playlist_reorder_tracks, :sp_playlist_reorder_tracks, [ :pointer, :pointer, :int, :int ], :error
+  attach_function :playlist_num_subscribers, :sp_playlist_num_subscribers, [ :pointer ], :uint
+  attach_function :playlist_subscribers, :sp_playlist_subscribers, [ :pointer ], :pointer
+  attach_function :playlist_subscribers_free, :sp_playlist_subscribers_free, [ :pointer ], :void
+  attach_function :playlist_update_subscribers, :sp_playlist_update_subscribers, [ :pointer, :pointer ], :void
+  attach_function :playlist_is_in_ram, :sp_playlist_is_in_ram, [ :pointer, :pointer ], :bool
+  attach_function :playlist_set_in_ram, :sp_playlist_set_in_ram, [ :pointer, :pointer, :bool ], :void
+  attach_function :playlist_create, :sp_playlist_create, [ :pointer, :pointer ], :pointer
+  attach_function :playlist_add_ref, :sp_playlist_add_ref, [ :pointer ], :void
+  attach_function :playlist_release, :sp_playlist_release, [ :pointer ], :void
+
+  # FFI::Struct for Playlist callbacks.
+  # 
+  # @attr [callback(:pointer, :pointer, :int, :int, :pointer):void] tracks_added
+  # @attr [callback(:pointer, :pointer, :int, :pointer):void] tracks_removed
+  # @attr [callback(:pointer, :pointer, :int, :int, :pointer):void] tracks_moved
+  # @attr [callback(:pointer, :pointer):void] playlist_renamed
+  # @attr [callback(:pointer, :pointer):void] playlist_state_changed
+  # @attr [callback(:pointer, :bool, :pointer):void] playlist_update_in_progress
+  # @attr [callback(:pointer, :pointer):void] playlist_metadata_updated
+  # @attr [callback(:pointer, :int, :pointer, :int, :pointer):void] track_created_changed
+  # @attr [callback(:pointer, :int, :bool, :pointer):void] track_seen_changed
+  # @attr [callback(:pointer, :string, :pointer):void] description_changed
+  # @attr [callback(:pointer, :pointer, :pointer):void] image_changed
+  # @attr [callback(:pointer, :int, :string, :pointer):void] track_message_changed
+  # @attr [callback(:pointer, :pointer):void] subscribers_changed
+  class PlaylistCallbacks < FFI::Struct
+    layout :tracks_added => callback([ :pointer, :pointer, :int, :int, :pointer ], :void),
+           :tracks_removed => callback([ :pointer, :pointer, :int, :pointer ], :void),
+           :tracks_moved => callback([ :pointer, :pointer, :int, :int, :pointer ], :void),
+           :playlist_renamed => callback([ :pointer, :pointer ], :void),
+           :playlist_state_changed => callback([ :pointer, :pointer ], :void),
+           :playlist_update_in_progress => callback([ :pointer, :bool, :pointer ], :void),
+           :playlist_metadata_updated => callback([ :pointer, :pointer ], :void),
+           :track_created_changed => callback([ :pointer, :int, :pointer, :int, :pointer ], :void),
+           :track_seen_changed => callback([ :pointer, :int, :bool, :pointer ], :void),
+           :description_changed => callback([ :pointer, :string, :pointer ], :void),
+           :image_changed => callback([ :pointer, :pointer, :pointer ], :void),
+           :track_message_changed => callback([ :pointer, :int, :string, :pointer ], :void),
+           :subscribers_changed => callback([ :pointer, :pointer ], :void)
+  end
+
+  # FFI::Struct for Subscribers of a Playlist.
+  # 
+  # @attr [Fixnum] count
+  # @attr [Pointer<String>] subscribers
+  class Subscribers < FFI::Struct
+    layout :count => :uint,
+           :subscribers => :pointer # array of count strings
+  end
+
+  #
+  # Playlist Container
+  # 
+
+  attach_function :playlistcontainer_add_callbacks, :sp_playlistcontainer_add_callbacks, [ :pointer, :pointer, :pointer ], :void
+  attach_function :playlistcontainer_remove_callbacks, :sp_playlistcontainer_remove_callbacks, [ :pointer, :pointer, :pointer ], :void
+  attach_function :playlistcontainer_num_playlists, :sp_playlistcontainer_num_playlists, [ :pointer ], :int
+  attach_function :playlistcontainer_playlist, :sp_playlistcontainer_playlist, [ :pointer, :int ], :pointer
+  attach_function :playlistcontainer_playlist_type, :sp_playlistcontainer_playlist_type, [ :pointer, :int ], :int
+  attach_function :playlistcontainer_playlist_folder_name, :sp_playlistcontainer_playlist_folder_name, [ :pointer, :int, :string, :int ], :error
+  attach_function :playlistcontainer_playlist_folder_id, :sp_playlistcontainer_playlist_folder_id, [ :pointer, :int ], :uint64
+  attach_function :playlistcontainer_add_new_playlist, :sp_playlistcontainer_add_new_playlist, [ :pointer, :string ], :pointer
+  attach_function :playlistcontainer_add_playlist, :sp_playlistcontainer_add_playlist, [ :pointer, :pointer ], :pointer
+  attach_function :playlistcontainer_remove_playlist, :sp_playlistcontainer_remove_playlist, [ :pointer, :int ], :error
+  attach_function :playlistcontainer_move_playlist, :sp_playlistcontainer_move_playlist, [ :pointer, :int, :int, :bool ], :error
+  attach_function :playlistcontainer_add_folder, :sp_playlistcontainer_add_folder, [ :pointer, :int, :string ], :error
+  attach_function :playlistcontainer_owner, :sp_playlistcontainer_owner, [ :pointer ], :pointer
+  attach_function :playlistcontainer_add_ref, :sp_playlistcontainer_add_ref, [ :pointer ], :void
+  attach_function :playlistcontainer_release, :sp_playlistcontainer_release, [ :pointer ], :void
+
+  # FFI::Struct for the PlaylistContainer.
+  # 
+  # @attr [callback(:pointer, :pointer, :int, :pointer):void] playlist_added
+  # @attr [callback(:pointer, :pointer, :int, :pointer):void] playlist_removed
+  # @attr [callback(:pointer, :pointer, :int, :int, :pointer):void] playlist_moved
+  # @attr [callback(:pointer, :pointer):void] container_loaded
+  class PlaylistContainerCallbacks < FFI::Struct
+    layout :playlist_added => callback([ :pointer, :pointer, :int, :pointer ], :void),
+           :playlist_removed => callback([ :pointer, :pointer, :int, :pointer ], :void),
+           :playlist_moved => callback([ :pointer, :pointer, :int, :int, :pointer ], :void),
+           :container_loaded => callback([ :pointer, :pointer ], :void)
+  end
+  
+  #
+  # User handling
+  # 
+  # @see http://developer.spotify.com/en/libspotify/docs/group__user.html
+  enum :relation_type, [:unknown, :none, :unidirectional, :bidirectional]
+
+  attach_function :user_canonical_name, :sp_user_canonical_name, [ :pointer ], :string
+  attach_function :user_display_name, :sp_user_display_name, [ :pointer ], :string
+  attach_function :user_is_loaded, :sp_user_is_loaded, [ :pointer ], :bool
+  attach_function :user_full_name, :sp_user_full_name, [ :pointer ], :string
+  attach_function :user_picture, :sp_user_picture, [ :pointer ], :string
+  attach_function :user_relation_type, :sp_user_relation_type, [ :pointer, :pointer ], :relation_type
+  attach_function :user_add_ref, :sp_user_add_ref, [ :pointer ], :void
+  attach_function :user_release, :sp_user_release, [ :pointer ], :void
+  
+  #
+  # Toplists
+  # 
+  # @see http://developer.spotify.com/en/libspotify/docs/group__toplist.html
+  enum :toplisttype, [:artists, :albums, :tracks]
+  enum :toplistregion, [:everywhere, :user]
+
+  attach_function :toplistbrowse_create, :sp_toplistbrowse_create, [ :pointer, :toplisttype, :toplistregion, :string, callback([:pointer, :pointer], :void), :pointer ], :pointer
+  attach_function :toplistbrowse_is_loaded, :sp_toplistbrowse_is_loaded, [ :pointer ], :bool
+  attach_function :toplistbrowse_error, :sp_toplistbrowse_error, [ :pointer ], :error
+  attach_function :toplistbrowse_add_ref, :sp_toplistbrowse_add_ref, [ :pointer ], :void
+  attach_function :toplistbrowse_release, :sp_toplistbrowse_release, [ :pointer ], :void
+  attach_function :toplistbrowse_num_artists, :sp_toplistbrowse_num_artists, [ :pointer ], :int
+  attach_function :toplistbrowse_artist, :sp_toplistbrowse_artist, [ :pointer, :int ], :pointer
+  attach_function :toplistbrowse_num_albums, :sp_toplistbrowse_num_albums, [ :pointer ], :int
+  attach_function :toplistbrowse_album, :sp_toplistbrowse_album, [ :pointer, :int ], :pointer
+  attach_function :toplistbrowse_num_tracks, :sp_toplistbrowse_num_tracks, [ :pointer ], :int
+  attach_function :toplistbrowse_track, :sp_toplistbrowse_track, [ :pointer, :int ], :pointer
   
+  #
+  # Inbox
+  # 
+  # @see http://developer.spotify.com/en/libspotify/docs/group__inbox.html
+  attach_function :inbox_post_tracks, :sp_inbox_post_tracks, [ :pointer, :string, :pointer, :int, :string, callback([:pointer, :pointer], :void), :pointer ], :pointer
+  attach_function :inbox_error, :sp_inbox_error, [ :pointer ], :error
+  attach_function :inbox_add_ref, :sp_inbox_add_ref, [ :pointer ], :void
+  attach_function :inbox_release, :sp_inbox_release, [ :pointer ], :void
 end