spotify 9.1.0 → 10.0.0

data/lib/spotify.rb

@@ -70,7 +70,15 @@ module Spotify
                :index_out_of_range, :user_needs_premium,
                :other_transient, :is_loading, :no_stream_available,
                :permission_denied, :inbox_is_full, :no_cache,
-               :no_such_user, :no_credentials]
+               :no_such_user, :no_credentials,
+
+               :network_disabled, :invalid_device_id,
+               :cant_open_trace_file, :application_banned,
+
+               :offline_too_many_tracks, 31,
+               :offline_disk_cache, :offline_expired,
+               :offline_not_allowed, :offline_license_lost,
+               :offline_license_error]
 
   # @macro [attach] attach_function
   #
@@ -154,7 +162,8 @@ module Spotify
            :start_playback, callback([ :session ], :void),
            :stop_playback, callback([ :session ], :void),
            :get_audio_buffer_stats, callback([ :session, AudioBufferStats ], :void),
-           :offline_status_updated, callback([ :session ], :void)
+           :offline_status_updated, callback([ :session ], :void),
+           :offline_error, callback([ :session, :error ], :void)
   end
 
   # FFI::Struct for Session configuration.
@@ -179,7 +188,9 @@ module Spotify
            :userdata, :userdata,
            :compress_playlists, Bool,
            :dont_save_metadata_for_playlists, Bool,
-           :initially_unload_playlists, Bool
+           :initially_unload_playlists, Bool,
+           :device_id, :pointer,
+           :tracefile, :pointer
   end
 
   # FFI::Struct for Offline Sync Status
@@ -242,8 +253,6 @@ module Spotify
   attach_function :session_starred_for_user_create, :sp_session_starred_for_user_create, [ :session, :string ], :playlist
   attach_function :session_publishedcontainer_for_user_create, :sp_session_publishedcontainer_for_user_create, [ :playlist, :string ], :playlistcontainer
   attach_function :session_preferred_bitrate, :sp_session_preferred_bitrate, [ :session, :bitrate ], :void
-  attach_function :session_num_friends, :sp_session_num_friends, [ :session ], :int
-  attach_function :session_friend, :sp_session_friend, [ :session, :int ], :user
 
   attach_function :session_set_connection_type, :sp_session_set_connection_type, [ :session, :connection_type ], :void
   attach_function :session_set_connection_rules, :sp_session_set_connection_rules, [ :session, :connection_rules ], :void
@@ -256,6 +265,9 @@ module Spotify
   attach_function :session_user_country, :sp_session_user_country, [ :session ], :int
   attach_function :session_preferred_offline_bitrate, :sp_session_preferred_offline_bitrate, [ :session, :bitrate, :bool ], :void
 
+  attach_function :session_set_volume_normalization, :sp_session_set_volume_normalization, [ :session, :bool ], :void
+  attach_function :session_get_volume_normalization, :sp_session_get_volume_normalization, [ :session ], :bool
+
   #
   # Link
   #
@@ -292,10 +304,15 @@ module Spotify
   #
   # @see http://developer.spotify.com/en/libspotify/docs/group__track.html
 
+  enum :availability, [:unavailable, :available, :not_streamable, :banned_by_artist]
+  typedef :availability, :track_availability
+
+  enum :track_offline_status, [:no, :waiting, :downloading, :done, :error, :done_expired, :limit_exceeded, :done_resync]
+
   #
   attach_function :track_is_loaded, :sp_track_is_loaded, [ :track ], :bool
   attach_function :track_error, :sp_track_error, [ :track ], :error
-  attach_function :track_is_available, :sp_track_is_available, [ :session, :track ], :bool
+  attach_function :track_get_availability, :sp_track_get_availability, [ :session, :track ], :track_availability
   attach_function :track_is_local, :sp_track_is_local, [ :session, :track ], :bool
   attach_function :track_is_autolinked, :sp_track_is_autolinked, [ :session, :track ], :bool
   attach_function :track_is_starred, :sp_track_is_starred, [ :session, :track ], :bool
@@ -308,6 +325,10 @@ module Spotify
   attach_function :track_popularity, :sp_track_popularity, [ :track ], :int
   attach_function :track_disc, :sp_track_disc, [ :track ], :int
   attach_function :track_index, :sp_track_index, [ :track ], :int
+  attach_function :track_is_placeholder, :sp_track_is_placeholder, [ :track ], :bool
+
+  attach_function :track_offline_get_status, :sp_track_offline_get_status, [ :track ], :track_offline_status
+
   attach_function :localtrack_create, :sp_localtrack_create, [ :string, :string, :string, :int ], :track
 
   attach_function :track_add_ref, :sp_track_add_ref, [ :track ], :void
@@ -349,6 +370,7 @@ module Spotify
   attach_function :albumbrowse_num_tracks, :sp_albumbrowse_num_tracks, [ :albumbrowse ], :int
   attach_function :albumbrowse_track, :sp_albumbrowse_track, [ :albumbrowse, :int ], :track
   attach_function :albumbrowse_review, :sp_albumbrowse_review, [ :albumbrowse ], :string
+  attach_function :albumbrowse_backend_request_duration, :sp_albumbrowse_backend_request_duration, [ :albumbrowse ], :int
 
   attach_function :albumbrowse_add_ref, :sp_albumbrowse_add_ref, [ :albumbrowse ], :void
   attach_function :albumbrowse_release, :sp_albumbrowse_release, [ :albumbrowse ], :void
@@ -361,6 +383,7 @@ module Spotify
   #
   attach_function :artist_name, :sp_artist_name, [ :artist ], :string
   attach_function :artist_is_loaded, :sp_artist_is_loaded, [ :artist ], :bool
+  attach_function :artist_portrait, :sp_artist_portrait, [ :artist ], :image_id
 
   attach_function :artist_add_ref, :sp_artist_add_ref, [ :artist ], :void
   attach_function :artist_release, :sp_artist_release, [ :artist ], :void
@@ -370,9 +393,11 @@ module Spotify
   #
   # @see http://developer.spotify.com/en/libspotify/docs/group__artistbrowse.html
 
+  enum :artistbrowse_type, [:full, :no_tracks, :no_albums]
+
   #
   callback :artistbrowse_complete_cb, [:artistbrowse, :userdata], :void
-  attach_function :artistbrowse_create, :sp_artistbrowse_create, [ :session, :artist, :artistbrowse_complete_cb, :userdata ], :artistbrowse
+  attach_function :artistbrowse_create, :sp_artistbrowse_create, [ :session, :artist, :artistbrowse_type, :artistbrowse_complete_cb, :userdata ], :artistbrowse
   attach_function :artistbrowse_is_loaded, :sp_artistbrowse_is_loaded, [ :artistbrowse ], :bool
   attach_function :artistbrowse_error, :sp_artistbrowse_error, [ :artistbrowse ], :error
   attach_function :artistbrowse_artist, :sp_artistbrowse_artist, [ :artistbrowse ], :artist
@@ -385,6 +410,7 @@ module Spotify
   attach_function :artistbrowse_num_similar_artists, :sp_artistbrowse_num_similar_artists, [ :artistbrowse ], :int
   attach_function :artistbrowse_similar_artist, :sp_artistbrowse_similar_artist, [ :artistbrowse, :int ], :artist
   attach_function :artistbrowse_biography, :sp_artistbrowse_biography, [ :artistbrowse ], :string
+  attach_function :artistbrowse_backend_request_duration, :sp_artistbrowse_backend_request_duration, [ :artistbrowse ], :int
 
   attach_function :artistbrowse_add_ref, :sp_artistbrowse_add_ref, [ :artistbrowse ], :void
   attach_function :artistbrowse_release, :sp_artistbrowse_release, [ :artistbrowse ], :void
@@ -600,9 +626,6 @@ module Spotify
   attach_function :user_canonical_name, :sp_user_canonical_name, [ :user ], :string
   attach_function :user_display_name, :sp_user_display_name, [ :user ], :string
   attach_function :user_is_loaded, :sp_user_is_loaded, [ :user ], :bool
-  attach_function :user_full_name, :sp_user_full_name, [ :user ], :string
-  attach_function :user_picture, :sp_user_picture, [ :user ], :string
-  attach_function :user_relation_type, :sp_user_relation_type, [ :session, :user ], :relation_type
 
   attach_function :user_add_ref, :sp_user_add_ref, [ :user ], :void
   attach_function :user_release, :sp_user_release, [ :user ], :void
@@ -626,6 +649,7 @@ module Spotify
   attach_function :toplistbrowse_album, :sp_toplistbrowse_album, [ :toplistbrowse, :int ], :album
   attach_function :toplistbrowse_num_tracks, :sp_toplistbrowse_num_tracks, [ :toplistbrowse ], :int
   attach_function :toplistbrowse_track, :sp_toplistbrowse_track, [ :toplistbrowse, :int ], :track
+  attach_function :toplistbrowse_backend_request_duration, :sp_toplistbrowse_backend_request_duration, [ :toplistbrowse ], :int
 
   attach_function :toplistbrowse_add_ref, :sp_toplistbrowse_add_ref, [ :toplistbrowse ], :void
   attach_function :toplistbrowse_release, :sp_toplistbrowse_release, [ :toplistbrowse ], :void

data/lib/spotify/version.rb

@@ -1,4 +1,4 @@
 module Spotify
   # See README for versioning policy.
-  VERSION = [9, 1, 0].join('.')
+  VERSION = [10, 0, 0].join('.')
 end

data/spec/api.h

@@ -43,6 +43,8 @@ extern "C" {
 /* Includes */
 #include <stddef.h>
 
+//endif
+
 #ifdef _WIN32
 typedef unsigned __int64 sp_uint64;
 #else
@@ -116,6 +118,17 @@ typedef enum sp_error {
 	SP_ERROR_NO_CACHE                  = 21, ///< Cache is not enabled
 	SP_ERROR_NO_SUCH_USER              = 22, ///< Requested user does not exist
 	SP_ERROR_NO_CREDENTIALS            = 23, ///< No credentials are stored
+	SP_ERROR_NETWORK_DISABLED          = 24, ///< Network disabled
+	SP_ERROR_INVALID_DEVICE_ID         = 25, ///< Invalid device ID
+	SP_ERROR_CANT_OPEN_TRACE_FILE      = 26, ///< Unable to open trace file
+	SP_ERROR_APPLICATION_BANNED        = 27, ///< This application is no longer allowed to use the Spotify service
+//endif
+	SP_ERROR_OFFLINE_TOO_MANY_TRACKS   = 31, ///< Reached the device limit for number of tracks to download
+	SP_ERROR_OFFLINE_DISK_CACHE        = 32, ///< Disk cache is full so no more tracks can be downloaded to offline mode
+	SP_ERROR_OFFLINE_EXPIRED           = 33, ///< Offline key has expired, the user needs to go online again
+	SP_ERROR_OFFLINE_NOT_ALLOWED       = 34, ///< This user is not allowed to use offline mode
+	SP_ERROR_OFFLINE_LICENSE_LOST      = 35, ///< The license for this device has been lost. Most likely because the user used offline on three other device
+	SP_ERROR_OFFLINE_LICENSE_ERROR     = 36, ///< The Spotify license server does not respond correctly
 } sp_error;
 
 /**
@@ -147,7 +160,7 @@ SP_LIBEXPORT(const char*) sp_error_message(sp_error error);
  * returned from sp_session_create(). Future versions of the library will provide you with some kind of mechanism
  * to request an updated version of the library.
  */
-#define SPOTIFY_API_VERSION 9
+#define SPOTIFY_API_VERSION 10
 
 /**
  * Describes the current state of the connection
@@ -206,6 +219,30 @@ typedef enum sp_playlist_offline_status {
 	SP_PLAYLIST_OFFLINE_STATUS_WAITING     = 3, ///< Playlist is queued for download
 } sp_playlist_offline_status;
 
+/**
+ * Track availability
+ */
+typedef enum sp_availability {
+	SP_TRACK_AVAILABILITY_UNAVAILABLE = 0, ///< Track is not available
+	SP_TRACK_AVAILABILITY_AVAILABLE   = 1, ///< Track is available and can be played
+	SP_TRACK_AVAILABILITY_NOT_STREAMABLE = 2, ///< Track can not be streamed using this account
+	SP_TRACK_AVAILABILITY_BANNED_BY_ARTIST = 3, ///< Track not available on artist's reqeust
+} sp_track_availability;
+
+/**
+ * Track offline status
+ */
+typedef enum sp_track_offline_status {
+	SP_TRACK_OFFLINE_NO             = 0, ///< Not marked for offline
+	SP_TRACK_OFFLINE_WAITING        = 1, ///< Waiting for download
+	SP_TRACK_OFFLINE_DOWNLOADING    = 2, ///< Currently downloading
+	SP_TRACK_OFFLINE_DONE           = 3, ///< Downloaded OK and can be played
+	SP_TRACK_OFFLINE_ERROR          = 4, ///< Error during download
+	SP_TRACK_OFFLINE_DONE_EXPIRED   = 5, ///< Downloaded OK but not playable due to expiery
+	SP_TRACK_OFFLINE_LIMIT_EXCEEDED = 6, ///< Waiting because device have reached max number of allowed tracks
+	SP_TRACK_OFFLINE_DONE_RESYNC    = 7, ///< Downloaded OK and available but scheduled for re-download
+} sp_track_offline_status;
+
 /**
  * Buffer stats used by get_audio_buffer_stats callback
  */
@@ -249,6 +286,23 @@ typedef enum sp_connection_rules {
 } sp_connection_rules;
 
 
+/**
+ * Controls the type of data that will be included in artist browse queries
+ */
+typedef enum sp_artistbrowse_type {
+	SP_ARTISTBROWSE_FULL,         /**< All information */
+	SP_ARTISTBROWSE_NO_TRACKS,    /**< Only albums and data about them, no tracks.
+					   In other words, sp_artistbrowse_num_tracks() will return 0
+				      */
+	SP_ARTISTBROWSE_NO_ALBUMS,    /**< Only return data about the artist (artist name, similar artist
+					   biography, etc
+					   No tracks or album will be abailable.
+					   sp_artistbrowse_num_tracks() and sp_artistbrowse_num_albums()
+					   will both return 0
+				      */
+} sp_artistbrowse_type;
+
+
 /**
  * Offline sync status
  */
@@ -294,8 +348,6 @@ typedef struct sp_offline_sync_status {
 } sp_offline_sync_status;
 
 
-
-
 /**
  * Session callbacks
  *
@@ -496,6 +548,16 @@ typedef struct sp_session_callbacks {
 	 */
 	void (SP_CALLCONV *offline_status_updated)(sp_session *session);
 
+	/**
+	 * Called when offline synchronization status is updated
+	 *
+	 * @param[in]  session    Session
+	 * @param[in]  error      Offline error. Will be SP_ERROR_OK if the offline synchronization
+	 *                        error state has cleared
+	 */
+	void (SP_CALLCONV *offline_error)(sp_session *session, sp_error error);
+
+//endif
 } sp_session_callbacks;
 
 /**
@@ -539,6 +601,17 @@ typedef struct sp_session_config {
 	 * See sp_playlist_is_in_ram() for more details.
 	 */
 	bool initially_unload_playlists;
+
+	/**
+	 * Device ID for offline synchronization
+	 */
+	const char *device_id;
+
+	/**
+	 * Path to API trace file
+	 */
+	const char *tracefile;
+
 } sp_session_config;
 
 /**
@@ -560,6 +633,7 @@ typedef struct sp_session_config {
  *                        SP_ERROR_BAD_USER_AGENT
  *                        SP_ERROR_BAD_APPLICATION_KEY
  *                        SP_ERROR_API_INITIALIZATION_FAILED
+ *                        SP_ERROR_INVALID_DEVICE_ID
  */
 SP_LIBEXPORT(sp_error) sp_session_create(const sp_session_config *config, sp_session **sess);
 
@@ -583,11 +657,10 @@ SP_LIBEXPORT(void) sp_session_release(sp_session *sess);
  * @skip sp_session_login
  * @until }
  *
- * @param[in]   session      Your session object
- * @param[in]   username     The username to log in
- * @param[in]   password     The password for the specified username
- * @param[in]   remember_me  If set, the username / password will be remembered by libspotify
- *
+ * @param[in]   session             Your session object
+ * @param[in]   username            The username to log in
+ * @param[in]   password            The password for the specified username
+ * @param[in]   remember_me         If set, the username / password will be remembered by libspotify
  */
 SP_LIBEXPORT(void) sp_session_login(sp_session *session, const char *username, const char *password, bool remember_me);
 
@@ -831,26 +904,26 @@ SP_LIBEXPORT(void) sp_session_preferred_offline_bitrate(sp_session *session, sp_
 
 
 /**
- * Return number of friends in the currently logged in users friends list.
+ * Return status of volume normalization
  *
  * @param[in]  session        Session object
+ * 
+ * @return true iff volume normalization is enabled
  *
- * @return     Number of users in friends. Each user can be extracted using the sp_session_friend() method
- *             The number of users in the list will not be updated nor change order between calls to
- *             sp_session_process_events()
  */
-SP_LIBEXPORT(int) sp_session_num_friends(sp_session *session);
+SP_LIBEXPORT(bool) sp_session_get_volume_normalization(sp_session *session);
+
 
 /**
- * Retrun the given user from the currently logged in users list of friends
+ * Set volume normalization
  *
  * @param[in]  session        Session object
- * @param[in]  index          Index in list
+ * @param[in]  on             True iff volume normalization should be enabled
  *
- * @return     A user. The object is owned by the session so the caller should not release it.
  */
-SP_LIBEXPORT(sp_user *) sp_session_friend(sp_session *session, int index);
+SP_LIBEXPORT(void) sp_session_set_volume_normalization(sp_session *session, bool on);
 
+//endif
 
 /**
  * Set to true if the connection is currently routed over a roamed connectivity
@@ -932,7 +1005,6 @@ SP_LIBEXPORT(int) sp_offline_time_left(sp_session *session);
 SP_LIBEXPORT(int) sp_session_user_country(sp_session *session);
 
 
-
 /** @} */
 
 
@@ -1232,18 +1304,30 @@ SP_LIBEXPORT(bool) sp_track_is_loaded(sp_track *track);
  */
 SP_LIBEXPORT(sp_error) sp_track_error(sp_track *track);
 
+
+/**
+ * Return offline status for a track. sp_session_callbacks::metadata_updated() will be invoked when
+ * offline status of a track changes
+ *
+ * @param[in]   track      The track
+ *
+ * @return                 Stats as described by ::sp_track_offline_status
+ *
+ */
+SP_LIBEXPORT(sp_track_offline_status) sp_track_offline_get_status(sp_track *track);
+
 /**
- * Return true if the track is available for playback.
+ * Return availability for a track
  *
  * @param[in]   session    Session
  * @param[in]   track      The track
  *
- * @return                 True if track is available for playback, otherwise false.
+ * @return                 Availability status, see ::sp_track_availability
  *
- * @note The track must be loaded or this function will always return false.
+ * @note The track must be loaded or this function will always SP_TRACK_AVAILABILITY_UNAVAILABLE
  * @see sp_track_is_loaded()
  */
-SP_LIBEXPORT(bool) sp_track_is_available(sp_session *session, sp_track *track);
+SP_LIBEXPORT(sp_track_availability) sp_track_get_availability(sp_session *session, sp_track *track);
 
 /**
  * Return true if the track is a local file.
@@ -1271,6 +1355,24 @@ SP_LIBEXPORT(bool) sp_track_is_local(sp_session *session, sp_track *track);
  */
 SP_LIBEXPORT(bool) sp_track_is_autolinked(sp_session *session, sp_track *track);
 
+/**
+ * Return true if the track is a placeholder. Placeholder tracks are used
+ * to store other objects than tracks in the playlist. Currently this is
+ * used in the inbox to store artists, albums and playlists.
+ *
+ * Use sp_link_create_from_track() to get a link object that points
+ * to the real object this "track" points to.
+ *
+ * @param[in]   track      The track
+ *
+ * @return                 True if track is a placeholder
+ *
+ * @note Contrary to most functions the track does not have to be
+ *       loaded for this function to return correct value
+ */
+SP_LIBEXPORT(bool) sp_track_is_placeholder(sp_track *track);
+
+
 /**
  * Return true if the track is starred by the currently logged in user.
  *
@@ -1544,6 +1646,17 @@ SP_LIBEXPORT(const char *) sp_artist_name(sp_artist *artist);
  */
 SP_LIBEXPORT(bool) sp_artist_is_loaded(sp_artist *artist);
 
+/**
+ * Return portrait for artist
+ *
+ * @param[in]   artist       The artist object
+ *
+ * @return                 ID byte sequence that can be passed to sp_image_create()
+ *                         If the album has no image or the metadata for the album is not
+ *                         loaded yet, this function returns NULL.
+ *
+ */
+SP_LIBEXPORT(const byte *) sp_artist_portrait(sp_artist *artist);
 
 /**
  * Increase the reference count of a artist
@@ -1693,6 +1806,16 @@ SP_LIBEXPORT(sp_track *) sp_albumbrowse_track(sp_albumbrowse *alb, int index);
  */
 SP_LIBEXPORT(const char *) sp_albumbrowse_review(sp_albumbrowse *alb);
 
+/**
+ * Return the time (in ms) that was spent waiting for the Spotify backend to serve the request
+ *
+ * @param[in] alb         Album browse object
+ *
+ * @return                -1 if the request was served from the local cache
+ *                        If the result is not yet loaded the return value is undefined
+ */
+SP_LIBEXPORT(int) sp_albumbrowse_backend_request_duration(sp_albumbrowse *alb);
+
 
 /**
  * Increase the reference count of an album browse result
@@ -1742,6 +1865,7 @@ typedef void SP_CALLCONV artistbrowse_complete_cb(sp_artistbrowse *result, void
  *
  * @param[in] session         Session object
  * @param[in] artist          Artist to be browsed. The artist metadata does not have to be loaded
+ * @param[in] type            Type of data requested, see the sp_artistbrowse_type enum for details
  * @param[in] callback        Callback to be invoked when browsing has been completed. Pass NULL if you are not interested in this event.
  * @param[in] userdata        Userdata passed to callback.
  *
@@ -1749,7 +1873,7 @@ typedef void SP_CALLCONV artistbrowse_complete_cb(sp_artistbrowse *result, void
  *
  * @see ::artistbrowse_complete_cb
  */
-SP_LIBEXPORT(sp_artistbrowse *) sp_artistbrowse_create(sp_session *session, sp_artist *artist, artistbrowse_complete_cb *callback, void *userdata);
+SP_LIBEXPORT(sp_artistbrowse *) sp_artistbrowse_create(sp_session *session, sp_artist *artist, sp_artistbrowse_type type, artistbrowse_complete_cb *callback, void *userdata);
 
 /**
  * Check if an artist browse request is completed
@@ -1878,6 +2002,16 @@ SP_LIBEXPORT(sp_artist *) sp_artistbrowse_similar_artist(sp_artistbrowse *arb, i
  */
 SP_LIBEXPORT(const char *) sp_artistbrowse_biography(sp_artistbrowse *arb);
 
+/**
+ * Return the time (in ms) that was spent waiting for the Spotify backend to serve the request
+ *
+ * @param[in] arb         Artist browse object
+ *
+ * @return                -1 if the request was served from the local cache
+ *                        If the result is not yet loaded the return value is undefined
+ */
+SP_LIBEXPORT(int) sp_artistbrowse_backend_request_duration(sp_artistbrowse *arb);
+
 
 /**
  * Increase the reference count of an artist browse result
@@ -3141,33 +3275,7 @@ SP_LIBEXPORT(const char *) sp_user_display_name(sp_user *user);
  */
 SP_LIBEXPORT(bool) sp_user_is_loaded(sp_user *user);
 
-/**
- * Get a pointer to a string representing the user's full name as returned from social networks.
- *
- * @param[in]   user         The Spotify user whose displayable username you would like a string representation of
- *
- * @return                   A string, NULL if the full name is not known.
- */
-SP_LIBEXPORT(const char *) sp_user_full_name(sp_user *user);
-
-/**
- * Get a pointer to an URL for an picture representing the user
- *
- * @param[in]   user         The Spotify user whose displayable username you would like a string representation of
- *
- * @return                   A string, NULL if the URL is not known.
- */
-SP_LIBEXPORT(const char *) sp_user_picture(sp_user *user);
-
-/**
- * Get relation type for a given user
- *
- * @param[in]   session      Session
- * @param[in]   user         The Spotify user you want to query relation type for
- *
- * @return                   ::sp_relation_type 
- */
-SP_LIBEXPORT(sp_relation_type) sp_user_relation_type(sp_session *session, sp_user *user);
+//endif
 
 /**
  * Increase the reference count of an user
@@ -3350,6 +3458,16 @@ SP_LIBEXPORT(int) sp_toplistbrowse_num_tracks(sp_toplistbrowse *tlb);
  */
 SP_LIBEXPORT(sp_track *) sp_toplistbrowse_track(sp_toplistbrowse *tlb, int index);
 
+/**
+ * Return the time (in ms) that was spent waiting for the Spotify backend to serve the request
+ *
+ * @param[in]  tlb        Toplist object
+ *
+ * @return                -1 if the request was served from the local cache
+ *                        If the result is not yet loaded the return value is undefined
+ */
+SP_LIBEXPORT(int) sp_toplistbrowse_backend_request_duration(sp_toplistbrowse *tlb);
+
 
 /** @} */
 
@@ -3426,6 +3544,7 @@ SP_LIBEXPORT(void) sp_inbox_release(sp_inbox *inbox);
  */
 SP_LIBEXPORT(const char *) sp_build_id(void);
 
+//endif
 
 #ifdef __cplusplus
 }

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: spotify
 version: !ruby/object:Gem::Version
-  version: 9.1.0
+  version: 10.0.0
   prerelease: 
 platform: ruby
 authors:
@@ -9,11 +9,11 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2011-10-02 00:00:00.000000000Z
+date: 2011-11-01 00:00:00.000000000Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: ffi
-  requirement: &2153532820 !ruby/object:Gem::Requirement
+  requirement: &2160952820 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -21,10 +21,10 @@ dependencies:
         version: '1.0'
   type: :runtime
   prerelease: false
-  version_requirements: *2153532820
+  version_requirements: *2160952820
 - !ruby/object:Gem::Dependency
   name: yard
-  requirement: &2153532100 !ruby/object:Gem::Requirement
+  requirement: &2160952400 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -32,10 +32,10 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *2153532100
+  version_requirements: *2160952400
 - !ruby/object:Gem::Dependency
   name: rbgccxml
-  requirement: &2153531500 !ruby/object:Gem::Requirement
+  requirement: &2160951940 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -43,10 +43,10 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *2153531500
+  version_requirements: *2160951940
 - !ruby/object:Gem::Dependency
   name: gccxml_gem
-  requirement: &2153530920 !ruby/object:Gem::Requirement
+  requirement: &2160951440 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '!='
@@ -54,10 +54,10 @@ dependencies:
         version: 0.9.3
   type: :development
   prerelease: false
-  version_requirements: *2153530920
+  version_requirements: *2160951440
 - !ruby/object:Gem::Dependency
   name: minitest
-  requirement: &2153530280 !ruby/object:Gem::Requirement
+  requirement: &2160950940 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -65,10 +65,10 @@ dependencies:
         version: '2.0'
   type: :development
   prerelease: false
-  version_requirements: *2153530280
+  version_requirements: *2160950940
 - !ruby/object:Gem::Dependency
   name: bundler
-  requirement: &2153529780 !ruby/object:Gem::Requirement
+  requirement: &2160950480 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -76,7 +76,7 @@ dependencies:
         version: '1.0'
   type: :development
   prerelease: false
-  version_requirements: *2153529780
+  version_requirements: *2160950480
 description: 
 email:
 - kim@burgestrand.se
@@ -125,3 +125,4 @@ summary: Bare-bones Ruby bindings for libspotify
 test_files:
 - spec/api.h
 - spec/spotify_spec.rb
+has_rdoc: