spotify 10.1.0 → 10.1.1

data/CHANGELOG.md

@@ -1,7 +1,26 @@
+[v10.1.1][]
+-----------
+- mark ALL libspotify functions as blocking
+
+[v10.1.0][]
+-----------
+- fix Spotify::Subscribers for empty subscribers
+- Up FFI version dependency to v1.0.11 (Spotify::Bool is no more)
+
+[v10.0.0][]
+-----------
+- upgrade to libspotify v10 (see changelog for details)
+
+[v9.1.0][]
+----------
+- Spotify::Subscribers now supports retrieving members by array index
+
 [v9.0.1][]
+----------
 - mark sp_session_player_load as blocking
 
 [v9.0.0][]
+----------
 - upgrade to libspotify 9
 - loosen up dependency version constraints
 
@@ -54,6 +73,10 @@ v0.0.0
 ------
 - release to register rubygems.org name
 
+[v10.1.1]: https://github.com/Burgestrand/libspotify-ruby/compare/v10.1.0...v10.1.1
+[v10.1.0]: https://github.com/Burgestrand/libspotify-ruby/compare/v10.0.0...v10.1.0
+[v10.0.0]: https://github.com/Burgestrand/libspotify-ruby/compare/v9.1.0...v10.0.0
+[v9.1.0]: https://github.com/Burgestrand/libspotify-ruby/compare/v9.0.1...v9.1.0
 [v9.0.1]: https://github.com/Burgestrand/libspotify-ruby/compare/v9.0.0...v9.0.1
 [v9.0.0]: https://github.com/Burgestrand/libspotify-ruby/compare/v8.0.5...v9.0.0
 [v8.0.5]: https://github.com/Burgestrand/libspotify-ruby/compare/v8.0.2...v8.0.5

data/README.markdown

@@ -6,12 +6,19 @@ Ruby FFI bindings for [libspotify][]
 
 [Spotify][] is a really nice music streaming service, and being able to interact with it in an API is awesome. However, because libspotify is a C library, writing applications with it is cumbersome and error-prone compared to doing it in Ruby. As I found myself needing to do this one day, knowing I’d rather not be writing it in C, this gem was born.
 
-Spotify, the gem, is a thin layer of Ruby atop the [libspotify][] C library. It allows developers to use libspotify without writing a line of C, thanks to [Ruby FFI](https://rubygems.org/gems/ffi). Do note that there is no sugar-coating, and no attempts of abstraction will be made. If you want a library that is easier to use, you should have a look at [Hallon](https://github.com/Burgestrand/Hallon).
+Spotify, the gem, is a thin layer of Ruby atop the [libspotify][] C library. It allows developers to use libspotify without writing a line of C, thanks to [Ruby FFI](https://rubygems.org/gems/ffi). Do note that there is no sugar-coating, and no attempts of abstraction will be made.
+
+You want easy-to-use Ruby bindings for libspotify?
+--------------------------------------------------
+Then you should check out [Hallon][]! While libspotify-ruby is just the simplest bindings to libspotify possible, Hallon works really hard to make libspotify a joy to use in Ruby.
+
+Finally, if you, for some reason, are having trouble deciding if you should use libspotify-ruby or Hallon, you should probably use Hallon.
 
 (anecdotal note: this code base was previously a part of Hallon, but I decided to extract it and make a gem out of it)
 
 [libspotify]: http://developer.spotify.com/en/libspotify/overview/
 [Spotify]: https://www.spotify.com/
+[Hallon]: https://github.com/Burgestrand/Hallon
 
 Need help installing libspotify?
 --------------------------------
@@ -29,4 +36,4 @@ When X increases (support for new libspotify versions) there are **no guarantees
 
 License
 -------
-X11 license, see the LICENSE document for details.
+X11 license, see the LICENSE document for details.

data/lib/spotify.rb

@@ -12,6 +12,18 @@ module Spotify
   extend FFI::Library
   ffi_lib ['libspotify', '/Library/Frameworks/libspotify.framework/libspotify']
 
+  # Override FFI::Library#attach_function to always add the `:blocking` option.
+  #
+  # The reason for this is that which libspotify functions may call callbacks
+  # is unspecified. And really… I don’t know of any drawbacks with this method.
+  def self.attach_function(*arguments, &block)
+    options = arguments.pop if arguments.last.is_a?(Hash)
+    options ||= {}
+    options = { blocking: true }.merge(options)
+    arguments << options
+    super(*arguments, &block)
+  end
+
   # libspotify API version
   # @return [Fixnum]
   API_VERSION = VERSION.split('.').first.to_i
@@ -210,11 +222,11 @@ module Spotify
                            :allow_sync_over_mobile, 0x4,
                            :allow_sync_over_wifi  , 0x8]
 
-  attach_function :session_create, :sp_session_create, [ SessionConfig, :buffer_out ], :error, :blocking => true
+  attach_function :session_create, :sp_session_create, [ SessionConfig, :buffer_out ], :error
   attach_function :session_release, :sp_session_release, [ :session ], :void
 
-  attach_function :session_process_events, :sp_session_process_events, [ :session, :buffer_out ], :void, :blocking => true
-  attach_function :session_login, :sp_session_login, [ :session, :string, :string, :bool ], :void, :blocking => true
+  attach_function :session_process_events, :sp_session_process_events, [ :session, :buffer_out ], :void
+  attach_function :session_login, :sp_session_login, [ :session, :string, :string, :bool ], :void
   attach_function :session_relogin, :sp_session_relogin, [ :session ], :error
   attach_function :session_forget_me, :sp_session_forget_me, [ :session ], :void
   attach_function :session_remembered_user, :sp_session_remembered_user, [ :session, :buffer_out, :size_t ], :int
@@ -224,7 +236,7 @@ module Spotify
   attach_function :session_connectionstate, :sp_session_connectionstate, [ :session ], :connectionstate
   attach_function :session_userdata, :sp_session_userdata, [ :session ], :userdata
   attach_function :session_set_cache_size, :sp_session_set_cache_size, [ :session, :size_t ], :void
-  attach_function :session_player_load, :sp_session_player_load, [ :session, :track ], :error, :blocking => true
+  attach_function :session_player_load, :sp_session_player_load, [ :session, :track ], :error
   attach_function :session_player_seek, :sp_session_player_seek, [ :session, :int ], :void
   attach_function :session_player_play, :sp_session_player_play, [ :session, :bool ], :void
   attach_function :session_player_unload, :sp_session_player_unload, [ :session ], :void
@@ -259,7 +271,7 @@ module Spotify
   enum :linktype, [:invalid, :track, :album, :artist, :search,
                    :playlist, :profile, :starred, :localtrack, :image]
 
-  attach_function :link_create_from_string, :sp_link_create_from_string, [ :string ], :link, :blocking => true
+  attach_function :link_create_from_string, :sp_link_create_from_string, [ :string ], :link
   attach_function :link_create_from_track, :sp_link_create_from_track, [ :track, :int ], :link
   attach_function :link_create_from_album, :sp_link_create_from_album, [ :album ], :link
   attach_function :link_create_from_artist, :sp_link_create_from_artist, [ :artist ], :link

data/lib/spotify/version.rb

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

data/spotify.gemspec

@@ -5,9 +5,9 @@ Gem::Specification.new do |gem|
   gem.name        = 'spotify'
   gem.summary     = 'Bare-bones Ruby bindings for libspotify'
   gem.description = <<-DESC
-    Spotify for Ruby is merely a very simple wrapper around libspotify
-    using Ruby FFI. If you wish for a simpler and (better) API, check
-    out Hallon (https://rubygems.org/gems/hallon)!
+    Spotify for Ruby is a primitive wrapper around libspotify using Ruby FFI.
+    If all you want is libspotify for Ruby, you should probably use at Hallon
+    instead: https://rubygems.org/gems/hallon
   DESC
 
   gem.homepage    = 'https://github.com/Burgestrand/libspotify-ruby'
@@ -24,6 +24,7 @@ Gem::Specification.new do |gem|
   gem.platform    = Gem::Platform::RUBY
 
   gem.add_dependency 'ffi', ['~> 1.0', '>= 1.0.11']
+  gem.add_development_dependency 'rake'
   gem.add_development_dependency 'yard'
   gem.add_development_dependency 'rbgccxml'
   gem.add_development_dependency 'gccxml_gem', '!= 0.9.3'

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: spotify
 version: !ruby/object:Gem::Version
-  version: 10.1.0
+  version: 10.1.1
   prerelease: 
 platform: ruby
 authors:
@@ -9,11 +9,11 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2011-11-20 00:00:00.000000000Z
+date: 2011-11-30 00:00:00.000000000Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: ffi
-  requirement: &2161376880 !ruby/object:Gem::Requirement
+  requirement: &70261854253800 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -24,10 +24,21 @@ dependencies:
         version: 1.0.11
   type: :runtime
   prerelease: false
-  version_requirements: *2161376880
+  version_requirements: *70261854253800
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: &70261854253120 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *70261854253120
 - !ruby/object:Gem::Dependency
   name: yard
-  requirement: &2161376140 !ruby/object:Gem::Requirement
+  requirement: &70261848428400 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -35,10 +46,10 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *2161376140
+  version_requirements: *70261848428400
 - !ruby/object:Gem::Dependency
   name: rbgccxml
-  requirement: &2161375620 !ruby/object:Gem::Requirement
+  requirement: &70261848427980 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -46,10 +57,10 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *2161375620
+  version_requirements: *70261848427980
 - !ruby/object:Gem::Dependency
   name: gccxml_gem
-  requirement: &2161375120 !ruby/object:Gem::Requirement
+  requirement: &70261848427480 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '!='
@@ -57,10 +68,10 @@ dependencies:
         version: 0.9.3
   type: :development
   prerelease: false
-  version_requirements: *2161375120
+  version_requirements: *70261848427480
 - !ruby/object:Gem::Dependency
   name: minitest
-  requirement: &2161374500 !ruby/object:Gem::Requirement
+  requirement: &70261848426980 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -68,10 +79,10 @@ dependencies:
         version: '2.0'
   type: :development
   prerelease: false
-  version_requirements: *2161374500
+  version_requirements: *70261848426980
 - !ruby/object:Gem::Dependency
   name: bundler
-  requirement: &2161374020 !ruby/object:Gem::Requirement
+  requirement: &70261848426520 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -79,10 +90,10 @@ dependencies:
         version: '1.0'
   type: :development
   prerelease: false
-  version_requirements: *2161374020
-description: ! "    Spotify for Ruby is merely a very simple wrapper around libspotify\n
-  \   using Ruby FFI. If you wish for a simpler and (better) API, check\n    out Hallon
-  (https://rubygems.org/gems/hallon)!\n"
+  version_requirements: *70261848426520
+description: ! "    Spotify for Ruby is a primitive wrapper around libspotify using
+  Ruby FFI.\n    If all you want is libspotify for Ruby, you should probably use at
+  Hallon\n    instead: https://rubygems.org/gems/hallon\n"
 email:
 - kim@burgestrand.se
 executables: []
@@ -122,7 +133,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 1.8.6
+rubygems_version: 1.8.10
 signing_key: 
 specification_version: 3
 summary: Bare-bones Ruby bindings for libspotify