spotify-search 0.0.2

checksums.yaml

@@ -0,0 +1,15 @@
+---
+!binary "U0hBMQ==":
+  metadata.gz: !binary |-
+    NDFlNTE4NGVmNmFlZjUzZTllZjg4NzdlNDMyZTk2NTk5YTI3NTVmMg==
+  data.tar.gz: !binary |-
+    ODdhNjRiMjgyOGU4M2FkOWU1ZTdiMDA3YWE0NGVkMjY5MTg2YWE5ZA==
+!binary "U0hBNTEy":
+  metadata.gz: !binary |-
+    ZmU0ZGQ5YzQyZjc0NzlkMzBhMTA1ODUwNzExMmIwOTYwYWM3YjIyNzg5NWJm
+    YWRlOTgwNmU1YjYxMjg3MjI4NWI4NGMxODE2NDk2ZWM2MTdhMTBjNWFhYmFj
+    N2U0YWM0Y2QwMWM2NWEwYjg1YjZkN2ViYjE2M2JkMmViMDZmYmI=
+  data.tar.gz: !binary |-
+    OTI2MmFlMjViMjRlZmM1MWVmZTZiNDU5OGJhMGRiYTk5Nzc4MmVjMzYxZThi
+    YzQ0NWY3NjhmZjI2NThjYjY4NGU0MDAyYzQ3ZjI3NTRiMmM2ZGYyM2JhNTUx
+    NmE0Mjg2NWQ3MmNiZjUwMTEyNDhjNThlNDFhZmZkMWJiNjYwNDY=

data/lib/spotify/api/base.rb

@@ -0,0 +1,20 @@
+module Spotify
+  module API
+    class Base
+
+      def initialize
+        raise(NotImplementedError, "Abstract class not meant to be instantiated directly.")
+      end
+
+      protected
+      def search(type, params)
+        request(type, params)
+      end
+
+      def request(base, params = {})
+        JSON.parse(RestClient.get("#{@uri}#{base}.json", {:params => params}).body)
+      end
+
+    end
+  end
+end

data/lib/spotify/api/lookup.rb

@@ -0,0 +1,46 @@
+require 'json'
+require 'rest_client'
+
+module Spotify
+  module API
+    class Lookup < Spotify::API::Base
+
+      def initialize
+        @uri = "http://ws.spotify.com/lookup/1/"
+      end
+
+      def artist(uri, level=nil)
+        params  = level == nil ? {} : { :extras => 'albumdetail' }
+        results = search(nil, params.merge(:uri => "spotify:artist:#{uri}"))
+
+        case level
+        when :detailed
+          artist = Resources::Lookup::ArtistDetailed.new(results['artist'])
+        else
+          artist = Resources::Lookup::ArtistBase.new(results['artist'])
+        end
+        Resources::Base.new(results['info'], artist)
+      end
+
+      def album(uri, level=nil)
+        params  = level == nil ? {} : { :extras => 'trackdetail' }
+        results = search(nil, params.merge(:uri => "spotify:album:#{uri}"))
+
+        case level
+        when :detailed
+          album = Resources::Lookup::AlbumDetailed.new(results['album'])
+        else
+          album = Resources::Lookup::AlbumBase.new(results['album'])
+        end
+        Resources::Base.new(results['info'], album)
+      end
+
+      def track(uri)
+        results = search(nil, :uri => "spotify:track:#{uri}")
+        track   = Resources::Lookup::TrackBase.new(results['track'])
+        Resources::Base.new(results['info'], track)
+      end
+
+    end
+  end
+end

data/lib/spotify/api/search.rb

@@ -0,0 +1,32 @@
+require 'json'
+require 'rest_client'
+
+module Spotify
+  module API
+    class Search < Spotify::API::Base
+
+      def initialize
+        @uri = "http://ws.spotify.com/search/1/"
+      end
+
+      def artists(query, params = {})
+        results = search('artist', params.merge(:q => query))
+        artists = results['artists'].map { |artist| Resources::Search::Artist.new(artist) }
+        Resources::Base.new(results['info'], artists)
+      end
+
+      def tracks(query, params = {})
+        results = search('track', params.merge(:q => query))
+        tracks  = results['tracks'].map { |track| Resources::Search::Track.new(track) }
+        Resources::Base.new(results['info'], tracks)
+      end
+
+      def albums(query, params = {})
+        results = search('album', params.merge(:q => query))
+        albums  = results['albums'].map { |album| Resources::Search::Album.new(album) }
+        Resources::Base.new(results['info'], albums)
+      end
+
+    end
+  end
+end

data/lib/spotify/api.rb

@@ -0,0 +1,3 @@
+require 'spotify/api/base'
+require 'spotify/api/lookup'
+require 'spotify/api/search'

data/lib/spotify/client.rb

@@ -0,0 +1,18 @@
+module Spotify
+
+  class Client
+
+    def initialize
+    end
+
+    def search
+      Spotify::API::Search.new
+    end
+
+    def lookup
+      Spotify::API::Lookup.new
+    end
+
+  end
+
+end

data/lib/spotify/resources/base.rb

@@ -0,0 +1,16 @@
+module Spotify
+  module Resources
+
+    class Base
+
+      attr_reader :info, :results
+
+      def initialize(info, results)
+        @info    = Spotify::Resources::Info.new(info)
+        @results = results
+      end
+
+    end
+
+  end
+end

data/lib/spotify/resources/info.rb

@@ -0,0 +1,39 @@
+module Spotify
+  module Resources
+
+    class Info
+
+      attr_reader :num_results, :limit, :offset, :query, :type, :page
+
+      def initialize(info)
+        @info = info
+      end
+
+      def num_results
+        @info['num_results']
+      end
+
+      def limit
+        @info['limit']
+      end
+
+      def offset
+        @info['offset']
+      end
+
+      def query
+        @info['query']
+      end
+
+      def type
+        @info['type']
+      end
+
+      def page
+        @info['page']
+      end
+
+    end
+
+  end
+end

data/lib/spotify/resources/lookup/album/base.rb

@@ -0,0 +1,41 @@
+module Spotify
+  module Resources
+    module Lookup
+      class AlbumBase
+
+        def initialize(body)
+          @body = body
+        end
+
+        def artist_id
+          @body['artist-id']
+        end
+
+        def name
+          @body['name']
+        end
+
+        def artist
+          @body['artist']
+        end
+
+        def external_ids
+          @body['external-ids']
+        end
+
+        def released
+          @body['released']
+        end
+
+        def href
+          @body['href']
+        end
+
+        def availability
+          @body['availability']
+        end
+
+      end
+    end
+  end
+end

data/lib/spotify/resources/lookup/album/details.rb

@@ -0,0 +1,17 @@
+module Spotify
+  module Resources
+    module Lookup
+      class AlbumDetails < Spotify::Resources::Lookup::AlbumBase
+
+        def initialize(body)
+          @body = body
+        end
+
+        def tracks
+          @body['tracks'].map { |track| Spotify::Resources::Lookup::TrackBase.new(track) }
+        end
+
+      end
+    end
+  end
+end

data/lib/spotify/resources/lookup/artist/base.rb

@@ -0,0 +1,21 @@
+module Spotify
+  module Resources
+    module Lookup
+      class ArtistBase
+
+        def initialize(body)
+          @body = body
+        end
+
+        def href
+          @body['href']
+        end
+
+        def name
+          @body['name']
+        end
+
+      end
+    end
+  end
+end

data/lib/spotify/resources/lookup/artist/details.rb

@@ -0,0 +1,17 @@
+module Spotify
+  module Resources
+    module Lookup
+      class ArtistDetailed < Spotify::Resources::Lookup::ArtistBase
+
+        def initialize(body)
+          @body = body
+        end
+
+        def albums
+          @body['albums'].map { |album| Spotify::Resources::Lookup::AlbumBase.new(album['album']) }
+        end
+
+      end
+    end
+  end
+end

data/lib/spotify/resources/lookup/track/base.rb

@@ -0,0 +1,50 @@
+module Spotify
+  module Resources
+    module Lookup
+      class TrackBase
+
+        # http://ws.spotify.com/lookup/1/.json?uri=spotify:track:6NmXV4o6bmp704aPGyTVVG
+        # and
+        # http://ws.spotify.com/lookup/1/.json?uri=spotify:album:6G9fHYDCoyEErUkHrFYfs4&extras=trackdetail
+        #
+        # do not returning the same 'track' object - We're leaving out 'disc-number', 'available', and
+        # 'availability.'
+        #
+        # TODO - Redefine the architecture where the correct values can be returned.
+
+        def initialize(body)
+          @body = body
+        end
+
+        def track_number
+          @body['track-number']
+        end
+
+        def popularity
+          @body['popularity']
+        end
+
+        def external_ids
+          @body['external-ids']
+        end
+
+        def length
+          @body['length']
+        end
+
+        def href
+          @body['href']
+        end
+
+        def artists
+          @body['artists'].map { |artist| Spotify::Resources::Lookup::ArtistBase.new(artist) }
+        end
+
+        def name
+          @body['name']
+        end
+
+      end
+    end
+  end
+end

data/lib/spotify/resources/search/album.rb

@@ -0,0 +1,40 @@
+module Spotify
+  module Resources
+    module Search
+
+      class Album
+
+        def initialize(body)
+          @body = body
+        end
+
+        def name
+          @body['name']
+        end
+
+        def popularity
+          @body['popularity']
+        end
+
+        def external_ids
+          @body['external-ids']
+        end
+
+        def href
+          @body['href']
+        end
+
+        def artists
+          # Has no popularity!
+          @body['artists'].map { |a| Spotify::Resources::Search::Artist.new(a)}
+        end
+
+        def availability
+          @body['availability']
+        end
+
+      end
+
+    end
+  end
+end

data/lib/spotify/resources/search/artist.rb

@@ -0,0 +1,26 @@
+module Spotify
+  module Resources
+    module Search
+
+      class Artist
+
+        def initialize(body)
+          @body = body
+        end
+
+        def href
+          @body['href']
+        end
+
+        def name
+          @body['name']
+        end
+
+        def popularity
+          @body['popularity']
+        end
+
+      end
+    end
+  end
+end

data/lib/spotify/resources/search/track.rb

@@ -0,0 +1,51 @@
+module Spotify
+  module Resources
+    module Search
+
+      class Track
+
+        def initialize(body)
+          @body = body
+        end
+
+        def album
+          # Might want to default to lookup here.
+          # No released
+          Spotify::Resources::Search::Album.new(@body['album'])
+        end
+
+        def name
+          @body['name']
+        end
+
+        def popularity
+          @body['popularity']
+        end
+
+        def external_ids
+          # External ID resource?
+          @body['external-ids']
+        end
+
+        def length
+          @body['length']
+        end
+
+        def href
+          @body['href']
+        end
+
+        def artists
+          # Has href and name?
+          @body['artists'].map { |a| Spotify::Resources::Search::Artist.new(a)}
+        end
+
+        def trac_number
+          @body['trac-number']
+        end
+
+      end
+
+    end
+  end
+end

data/lib/spotify/resources.rb

@@ -0,0 +1,12 @@
+require 'spotify/resources/base'
+require 'spotify/resources/info'
+
+require 'spotify/resources/search/album'
+require 'spotify/resources/search/artist'
+require 'spotify/resources/search/track'
+
+require 'spotify/resources/lookup/album/base'
+require 'spotify/resources/lookup/album/details'
+require 'spotify/resources/lookup/artist/base'
+require 'spotify/resources/lookup/artist/details'
+require 'spotify/resources/lookup/track/base'

data/lib/spotify.rb

@@ -0,0 +1,4 @@
+require 'spotify/client'
+
+require 'spotify/resources'
+require 'spotify/api'

metadata

@@ -0,0 +1,59 @@
+--- !ruby/object:Gem::Specification
+name: spotify-search
+version: !ruby/object:Gem::Version
+  version: 0.0.2
+platform: ruby
+authors:
+- TJ Biddle
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-08-04 00:00:00.000000000 Z
+dependencies: []
+description: Spotify metadata API Wrapper.
+email: biddle.thomas@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/spotify/api/base.rb
+- lib/spotify/api/lookup.rb
+- lib/spotify/api/search.rb
+- lib/spotify/api.rb
+- lib/spotify/client.rb
+- lib/spotify/resources/base.rb
+- lib/spotify/resources/info.rb
+- lib/spotify/resources/lookup/album/base.rb
+- lib/spotify/resources/lookup/album/details.rb
+- lib/spotify/resources/lookup/artist/base.rb
+- lib/spotify/resources/lookup/artist/details.rb
+- lib/spotify/resources/lookup/track/base.rb
+- lib/spotify/resources/search/album.rb
+- lib/spotify/resources/search/artist.rb
+- lib/spotify/resources/search/track.rb
+- lib/spotify/resources.rb
+- lib/spotify.rb
+homepage: https://github.com/thomasbiddle/spotify-search
+licenses: []
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.0.6
+signing_key: 
+specification_version: 4
+summary: Spotify metadata API Wrapper
+test_files: []