songkick_ruby 1.0.0

data/README.textile

@@ -0,0 +1,94 @@
+h1. Songkick ruby
+
+songkick ruby is a gem for the "Songkick api":http://www.songkick.com/developer
+
+h1. Installation
+
+<pre>
+	<code>
+		gem install songkick_ruby
+	</code>
+</pre>
+
+h1. Usage
+
+h2. First step
+
+<pre>
+	<code>
+		client = Songkick.new("your songkick api key", :json)
+		# or
+		client = Songkick::Client.new("your songckick api key", :json)
+	</code>
+</pre>
+
+
+h2. Search
+
+Search events.
+More in,formation here: "http://www.songkick.com/developer/event-search":http://www.songkick.com/developer/event-search
+
+<pre>
+	<code>
+		events = client.search_events(:artist_name => "lady gaga", :location => "clientip:84.102.219.109")
+	</code>
+</pre>
+
+Search locations.
+More in,formation here: "http://www.songkick.com/developer/location-search":http://www.songkick.com/developer/location-search
+
+<pre>
+	<code>
+		locations = client.search_locations(:query => "paris")
+	</code>
+</pre>
+
+Search artists.
+More in,formation "here: http://www.songkick.com/developer/artist-search":here: http://www.songkick.com/developer/artist-search
+
+<pre>
+	<code>
+		artists = client.search_locations("lady gaga")
+	</code>
+</pre>
+
+
+h2. Event
+
+Find an event
+More in,formation here: "http://www.songkick.com/developer/artist-search":http://www.songkick.com/developer/artist-search
+
+<pre>
+	<code>
+		random_event = client.find_event(9969693)
+	</code>
+</pre>
+
+h2. Calendar
+
+Get the calendar of an artist.
+More information here: "http://www.songkick.com/developer/upcoming-events-for-artist":http://www.songkick.com/developer/upcoming-events-for-artist
+
+<pre>
+	<code>
+		coldplay_calendar = client.artist_calendar(197928)
+	</code>
+</pre>
+
+Get the calendar of a location.
+More information here: "http://www.songkick.com/developer/upcoming-events-for-metro-area":http://www.songkick.com/developer/upcoming-events-for-metro-area
+
+<pre>
+	<code>
+		paris = client.artist_calendar(28909)
+	</code>
+</pre>
+
+Get the calendar of a user.
+More information here: "http://www.songkick.com/developer/upcoming-events-for-user":http://www.songkick.com/developer/upcoming-events-for-user
+
+<pre>
+	<code>
+		random_user = client.artist_calendar(847914)
+	</code>
+</pre>

data/lib/songkick/client/calendar.rb

@@ -0,0 +1,19 @@
+module Songkick
+  class Client
+    module Calendar
+
+      def artist_calendar(artist_id)
+        get "artists/#{artist_id}/calendar.#{format}"
+      end
+
+      def location_calendar(location_id)
+        get "metro_areas/#{location_id}/calendar.#{format}"
+      end
+
+      def user_calendar(username)
+        get "users/#{artist_id}/calendar.#{format}"
+      end
+
+    end
+  end
+end

data/lib/songkick/client/event.rb

@@ -0,0 +1,11 @@
+module Songkick
+  class Client
+    module Event
+
+      def find_event(event_id)
+        get "events/#{event_id}.#{format}"
+      end
+
+    end
+  end
+end

data/lib/songkick/client/request.rb

@@ -0,0 +1,17 @@
+module Songkick
+  class Client
+    module Request
+
+      private
+      
+      def get(url)
+        uri = API_URL + url
+        uri = URI.parse uri.include?("?") ? uri + "&apikey=#{api_key}" : uri + "?apikey=#{api_key}"
+        
+        response = Net::HTTP.get_response(uri)
+        json? ? JSON.parse(response.body) : response.body
+      end
+
+    end
+  end
+end

data/lib/songkick/client/search.rb

@@ -0,0 +1,25 @@
+module Songkick
+  class Client
+    module Search
+
+      def search_events(opts)
+        _opts = opts.collect{|k, v| "#{k}=#{v.gsub(" ", "%20")}"}.join("&")
+        get "events.#{format}?#{_opts}"
+      end
+      alias_method :search_event, :search_events
+
+
+      def search_locations(opts)
+        _opts = opts.collect{|k, v| "#{k}=#{v.gsub(" ", "%20")}"}.join("&")
+        get "search/locations.#{format}?#{_opts}"
+      end
+      alias_method :search_location, :search_locations
+
+      def search_artists(text)
+        get "search/artists.#{format}?query=#{text.gsub(" ","%20")}"
+      end
+      alias_method :search_artist, :search_artists
+
+    end
+  end
+end

data/lib/songkick/client.rb

@@ -0,0 +1,36 @@
+require "songkick/client/calendar.rb"
+require "songkick/client/event.rb"
+require "songkick/client/request.rb"
+require "songkick/client/search.rb"
+
+module Songkick
+  class Client
+    
+    API_URL = 'http://api.songkick.com/api/3.0/'
+    
+    attr_accessor :api_key, :format
+
+    def initialize(api_key, format)
+      @api_key = api_key
+      @format = format
+    end
+
+    def format=(format)
+      @format = format.to_s
+    end
+
+    def json?
+      format == 'json'
+    end
+
+    def xml?
+      format == 'xml'
+    end
+
+    include Songkick::Client::Calendar
+    include Songkick::Client::Event
+    include Songkick::Client::Search
+    include Songkick::Client::Request
+
+  end
+end

data/lib/songkick/version.rb

@@ -0,0 +1,3 @@
+module Songkick
+  VERSION = '1.0.0'
+end

data/lib/songkick.rb

@@ -0,0 +1,16 @@
+require "net/http"
+require "rubygems"
+require 'json'
+
+require "songkick/version.rb"
+require "songkick/client.rb"
+
+module Songkick
+  class << self
+    
+    def new(api_key, format)
+      Songkick::Client.new(api_key, format)
+    end
+
+  end
+end

data/songkick_ruby.gemspec

@@ -0,0 +1,24 @@
+Gem::Specification.new do |s|
+  s.name = "songkick_ruby"
+  s.version = "1.0.0"
+  s.author = "Gregory Marcilhacy"
+  s.email = "g.marcilhacy@gmail.com"
+  s.homepage = "http://github.com/gregorym/songkick_ruby"
+  s.summary = "Ruby wrapper of the songkick api"
+
+  s.require_path = "lib"
+  s.files = %w(
+    README.textile
+    songkick_ruby.gemspec
+    lib/songkick.rb
+    lib/songkick
+    lib/songkick/version.rb
+    lib/songkick/client.rb
+    lib/songkick/client/calendar.rb
+    lib/songkick/client/event.rb
+    lib/songkick/client/search.rb
+    lib/songkick/client/request.rb
+  )
+  
+  s.test_files = %w()
+end

metadata

@@ -0,0 +1,75 @@
+--- !ruby/object:Gem::Specification 
+name: songkick_ruby
+version: !ruby/object:Gem::Version 
+  hash: 23
+  prerelease: false
+  segments: 
+  - 1
+  - 0
+  - 0
+  version: 1.0.0
+platform: ruby
+authors: 
+- Gregory Marcilhacy
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-08-12 00:00:00 +02:00
+default_executable: 
+dependencies: []
+
+description: 
+email: g.marcilhacy@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- README.textile
+- songkick_ruby.gemspec
+- lib/songkick.rb
+- lib/songkick/version.rb
+- lib/songkick/client.rb
+- lib/songkick/client/calendar.rb
+- lib/songkick/client/event.rb
+- lib/songkick/client/search.rb
+- lib/songkick/client/request.rb
+has_rdoc: true
+homepage: http://github.com/gregorym/songkick_ruby
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: Ruby wrapper of the songkick api
+test_files: []
+