bandsintown 0.1.1 → 0.1.2

data/History.txt

@@ -1,3 +1,6 @@
+== 0.1.2 2009-11-11
+* updated Bandsintown::Artist class with support for mbid / music brainz id and additional documentation
+
 == 0.1.1 2009-09-08
 * fixed escaping issue with / and ? in artist urls
 

data/README.rdoc

@@ -26,7 +26,17 @@ For more information visit http://www.bandsintown.com/api/requests.
 
 === Find all upcoming events for a given artist
 
-  artist = Bandsintown::Artist.new("The Killers")
+  artist = Bandsintown::Artist.new({
+    :name => "The Killers"
+  })
+  events = artist.events
+
+=== Find all upcoming events for a given artist using mbid (music brainz id)
+
+  # 486af4f0-a79b-468f-be73-527cd4caf6ea => mbid for Slick Rick
+  artist = Bandsintown::Artist.new({
+    :mbid => "486af4f0-a79b-468f-be73-527cd4caf6ea"
+  })
   events = artist.events
 
 === Find events this week around Boston, MA 
@@ -45,6 +55,19 @@ For more information visit http://www.bandsintown.com/api/requests.
     :end_date => 1.week.from_now
   })
 
+=== Find events this month for Ghostface Killah and Raekwon using mbid (music brainz id)
+
+  # 3b39abeb-0064-4eed-9ddd-ee47a45c54cb => mbid for Ghostface Killah
+  # 4e954b02-fae2-4bd7-9547-e055a6ac0527 => mbid for Raekwon
+  events = Bandsintown::Event.search({
+    :artists => [
+      'mbid_3b39abeb-0064-4eed-9ddd-ee47a45c54cb', 
+      'mbid_4e954b02-fae2-4bd7-9547-e055a6ac0527'
+    ], 
+    :start_date => Time.now.beginning_of_month, 
+    :end_date => Time.now.end_of_month
+  })
+
 === Find recommended events around Boston, MA for fans of Led Zeppelin
 
   events = Bandsintown::Event.recommended({

data/Rakefile

@@ -1,4 +1,4 @@
-%w[rubygems rake rake/clean fileutils newgem rubigen].each { |f| require f }
+%w[rubygems rake rake/clean fileutils newgem rubigen hoe].each { |f| require f }
 require File.dirname(__FILE__) + '/lib/bandsintown'
 
 # Generate all the Rake tasks

data/lib/bandsintown.rb

@@ -14,7 +14,7 @@ require 'bandsintown/event'
 require 'bandsintown/venue'
 
 module Bandsintown
-  VERSION = '0.1.1'
+  VERSION = '0.1.2'
   class APIError < StandardError; end
   class << self
     # All Bandsintown API requests require an app_id parameter for identification.

data/lib/bandsintown/artist.rb

@@ -1,18 +1,24 @@
 module Bandsintown
   class Artist < Base
     
-    attr_accessor :name, :events
+    attr_accessor :name, :bandsintown_url, :mbid, :events
     
-    def initialize(name, url = nil)
-      @name = name
-      @bandsintown_url = url || build_bandsintown_url
+    def initialize(options = {})
+      @name = options[:name]
+      @mbid = options[:mbid]
+      @bandsintown_url = options[:url] || build_bandsintown_url
     end
     
     #Returns an array of Bandsintown::Event objects for each of the artist's upcoming events available through bandsintown.com.
     #See http://www.bandsintown.com/api/requests#artists-events for more information.
-    #
+    #Can be used with either artist name or mbid (music brainz id).
     #====example:
-    #   artist = Bandsintown::Artist.new("Little Brother")
+    #   # using artist name
+    #   artist = Bandsintown::Artist.new(:name => "Little Brother")
+    #   upcoming_little_brother_events = artist.events
+    #
+    #   # using mbid for Little Brother
+    #   artist = Bandsintown::Artist.new(:mbid => "b929c0c9-5de0-4d87-8eb9-365ad1725629")
     #   upcoming_little_brother_events = artist.events
     #
     def events
@@ -20,13 +26,19 @@ module Bandsintown
       @events = self.class.request_and_parse("#{api_name}/events").map { |event| Bandsintown::Event.build_from_json(event) }
     end
     
-    # name used in api requests. / and ? must be double escaped.
+    # Used in api requests as the RESTful resource id for artists (http://api.bandsintown.com/artists/id/method).
+    # If @name is not nil, it will be URI escaped to generate the api_name.  '/' and '?' must be double escaped.
+    # If @name is nil, @mbid is used with 'mbid_' prefixed.
     #
     def api_name
-      name = @name.dup
-      name.gsub!('/', CGI.escape('/'))
-      name.gsub!('?', CGI.escape('?'))
-      URI.escape(name)
+      if @name
+        name = @name.dup
+        name.gsub!('/', CGI.escape('/'))
+        name.gsub!('?', CGI.escape('?'))
+        URI.escape(name)
+      else
+        "mbid_#{@mbid}"
+      end
     end
     
     def self.resource_path
@@ -36,13 +48,17 @@ module Bandsintown
     private
     
     def build_bandsintown_url
-      name = @name.dup
-      name.gsub!('&', 'And')
-      name.gsub!('+', 'Plus')
-      name = name.split.map { |w| w.capitalize }.join if name =~ /\s/
-      name.gsub!('/', CGI.escape('/'))
-      name.gsub!('?', CGI.escape('?'))
-      "http://www.bandsintown.com/#{URI.escape(name)}"
+      if @name
+        name = @name.dup
+        name.gsub!('&', 'And')
+        name.gsub!('+', 'Plus')
+        name = name.split.map { |w| w.capitalize }.join if name =~ /\s/
+        name.gsub!('/', CGI.escape('/'))
+        name.gsub!('?', CGI.escape('?'))
+        "http://www.bandsintown.com/#{URI.escape(name)}"
+      else
+        "http://www.bandsintown.com/mbid_#{@mbid}"
+      end
     end
     
   end

data/lib/bandsintown/event.rb

@@ -84,7 +84,7 @@ module Bandsintown
     end
     
     def self.build_from_json(json_hash)
-      event                  = Bandsintown::Event.new()
+      event                  = Bandsintown::Event.new
       event.bandsintown_id   = json_hash["id"]
       event.bandsintown_url  = json_hash["url"]
       event.datetime         = Time.parse(json_hash["datetime"])
@@ -93,8 +93,7 @@ module Bandsintown
       event.ticket_status    = json_hash["ticket_status"]
       event.on_sale_datetime = Time.parse(json_hash["on_sale_datetime"]) rescue nil
       event.venue            = Bandsintown::Venue.new(json_hash["venue"])
-      event.artists          = []
-      json_hash["artists"].each { |artist| event.artists << Bandsintown::Artist.new(artist["name"], artist["url"]) }
+      event.artists          = json_hash["artists"].map { |artist| Bandsintown::Artist.new(artist.symbolize_keys) }
       event
     end
     

data/spec/bandsintown/artist_spec.rb

@@ -3,70 +3,95 @@ require File.dirname(__FILE__) + '/../spec_helper.rb'
 describe Bandsintown::Artist do
   
   before(:each) do
-    @name = "Little Brother"
-    @url = "http://www.bandsintown.com/LittleBrother"
-    @artist = Bandsintown::Artist.new(@name, @url)
+    @options = {
+      :name => 'Little Brother',
+      :url => 'http://www.bandsintown.com/LittleBrother',
+      :mbid => 'b929c0c9-5de0-4d87-8eb9-365ad1725629'
+    }
+    @artist = Bandsintown::Artist.new(@options)
   end
   
-  describe ".initialize(name, url = nil)" do
-    it "should set the Artist name" do
-      @artist.name.should == @name
+  describe "attributes" do
+    it "should have an attr_accessor for @name" do
+      @artist.should respond_to(:name)
+      @artist.should respond_to(:name=)
     end
-    it "should set the Artist bandsintown_url if given" do
-      @artist.bandsintown_url.should == @url
+    it "should have an attr_accessor for @bandsintown_url" do
+      @artist.should respond_to(:bandsintown_url)
+      @artist.should respond_to(:bandsintown_url=)
+    end
+    it "should have an attr_accessor for @mbid" do
+      @artist.should respond_to(:mbid)
+      @artist.should respond_to(:mbid=)
+    end
+  end
+  
+  describe ".initialize(options = {})" do
+    it "should set the Artist name from options" do
+      @artist.name.should == @options[:name]
+    end
+    it "should set the Artist bandsintown_url from options" do
+      @artist.bandsintown_url.should == @options[:url]
+    end
+    it "should set the Artist mbid from options" do
+      @artist.mbid.should == @options[:mbid]
     end
     
-    describe "generating a url (initialize with nil url)" do
+    describe "generating a url (initialized without an option for :url)" do
       it "should strip spaces" do
         name = "The Beatles "
-        Bandsintown::Artist.new(name).bandsintown_url.should == "http://www.bandsintown.com/TheBeatles"
+        Bandsintown::Artist.new(:name => name).bandsintown_url.should == "http://www.bandsintown.com/TheBeatles"
       end
       it "should convert '&' -> 'And'" do
         name = "Meg & Dia"
-        Bandsintown::Artist.new(name).bandsintown_url.should == "http://www.bandsintown.com/MegAndDia"
+        Bandsintown::Artist.new(:name => name).bandsintown_url.should == "http://www.bandsintown.com/MegAndDia"
       end
       it "should convert '+' -> 'Plus'" do
         name = "+44"
-        Bandsintown::Artist.new(name).bandsintown_url.should == "http://www.bandsintown.com/Plus44"
+        Bandsintown::Artist.new(:name => name).bandsintown_url.should == "http://www.bandsintown.com/Plus44"
       end
       it "should camelcase seperate words" do
         name = "meg & dia"
-        Bandsintown::Artist.new(name).bandsintown_url.should == "http://www.bandsintown.com/MegAndDia"
+        Bandsintown::Artist.new(:name => name).bandsintown_url.should == "http://www.bandsintown.com/MegAndDia"
       end
       it "should not cgi escape url" do
         name = "$up"
-        Bandsintown::Artist.new(name).bandsintown_url.should == "http://www.bandsintown.com/$up"
+        Bandsintown::Artist.new(:name => name).bandsintown_url.should == "http://www.bandsintown.com/$up"
       end
       it "should uri escape accented characters" do
         name = "sigur rós"
-        Bandsintown::Artist.new(name).bandsintown_url.should == "http://www.bandsintown.com/SigurR%C3%B3s"
+        Bandsintown::Artist.new(:name => name).bandsintown_url.should == "http://www.bandsintown.com/SigurR%C3%B3s"
       end
       it "should not alter the case of single word names" do
         name = "AWOL"
-        Bandsintown::Artist.new(name).bandsintown_url.should == "http://www.bandsintown.com/AWOL"
+        Bandsintown::Artist.new(:name => name).bandsintown_url.should == "http://www.bandsintown.com/AWOL"
       end
       it "should allow dots" do
         name = "M.I.A"
-        Bandsintown::Artist.new(name).bandsintown_url.should == "http://www.bandsintown.com/M.I.A"
+        Bandsintown::Artist.new(:name => name).bandsintown_url.should == "http://www.bandsintown.com/M.I.A"
       end
       it "should allow exclamations" do
         name = "against me!"
-        Bandsintown::Artist.new(name).bandsintown_url.should == "http://www.bandsintown.com/AgainstMe!"
+        Bandsintown::Artist.new(:name => name).bandsintown_url.should == "http://www.bandsintown.com/AgainstMe!"
       end
-      it "should not modify @name" do
+      it "should not modify @options[:name]" do
         name = "this is how i think"
-        Bandsintown::Artist.new(name)
+        Bandsintown::Artist.new(:name => name)
         name.should == "this is how i think"
       end
       it "should cgi escape '/' so it will be double encoded" do
         name = "AC/DC"
         escaped_name = URI.escape(name.gsub('/', CGI.escape('/')))
-        Bandsintown::Artist.new(name).bandsintown_url.should == "http://www.bandsintown.com/#{escaped_name}"
+        Bandsintown::Artist.new(:name => name).bandsintown_url.should == "http://www.bandsintown.com/#{escaped_name}"
       end
       it "should cgi escape '?' so it will be double encoded" do
         name = "Does it offend you, yeah?"
         escaped_name = URI.escape("DoesItOffendYou,Yeah#{CGI.escape('?')}")
-        Bandsintown::Artist.new(name).bandsintown_url.should == "http://www.bandsintown.com/#{escaped_name}"
+        Bandsintown::Artist.new(:name => name).bandsintown_url.should == "http://www.bandsintown.com/#{escaped_name}"
+      end
+      it "should use @mbid only if @name is nil" do
+        Bandsintown::Artist.new(:name => 'name', :mbid => 'mbid').bandsintown_url.should == 'http://www.bandsintown.com/name'
+        Bandsintown::Artist.new(:mbid => '1234').bandsintown_url.should == 'http://www.bandsintown.com/mbid_1234'
       end
     end
   end
@@ -79,11 +104,11 @@ describe Bandsintown::Artist do
   
   describe "#events" do
     before(:each) do
-      @artist = Bandsintown::Artist.new("Little Brother")
+      @artist = Bandsintown::Artist.new(:name => "Little Brother")
     end
     it "should request and parse a call to the BIT artist events API method and the artist's api name" do
-      @artist.should_receive(:api_name).and_return("Little+Brother")
-      Bandsintown::Artist.should_receive(:request_and_parse).with("Little+Brother/events").and_return([])
+      @artist.should_receive(:api_name).and_return('Little%20Brother')
+      Bandsintown::Artist.should_receive(:request_and_parse).with("Little%20Brother/events").and_return([])
       @artist.events
     end
     it "should return an Array of Bandsintown::Event objects built from the response" do
@@ -107,8 +132,12 @@ describe Bandsintown::Artist do
       @artist.api_name.should == URI.escape(@artist.name)
     end
     it "should CGI escape / and ? characters before URI escaping the whole name" do
-      Bandsintown::Artist.new("AC/DC").api_name.should == URI.escape(CGI.escape("AC/DC"))
-      Bandsintown::Artist.new("?uestlove").api_name.should == URI.escape(CGI.escape("?uestlove"))
+      Bandsintown::Artist.new(:name => "AC/DC").api_name.should == URI.escape(CGI.escape("AC/DC"))
+      Bandsintown::Artist.new(:name => "?uestlove").api_name.should == URI.escape(CGI.escape("?uestlove"))
+    end
+    it "should use 'mbid_<@mbid>' only if @name is nil" do
+      Bandsintown::Artist.new(:name => 'name', :mbid => 'mbid').api_name.should == 'name'
+      Bandsintown::Artist.new(:mbid => '1234').api_name.should == 'mbid_1234'
     end
   end
 end

data/spec/bandsintown/event_spec.rb

@@ -62,8 +62,8 @@ describe Bandsintown::Event do
       @datetime   = "2008-09-30T19:30:00"
       @ticket_url = "http://www.bandsintown.com/event/745095/buy_tickets"
       
-      @artist_1 = { "name" => "Little Brother", "url" => "http://www.bandsintown.com/LittleBrother" }
-      @artist_2 = { "name" => "Joe Scudda", "url" => "http://www.bandsintown.com/JoeScudda" }
+      @artist_1 = { "name" => "Little Brother", "url" => "http://www.bandsintown.com/LittleBrother", "mbid" => "b929c0c9-5de0-4d87-8eb9-365ad1725629" }
+      @artist_2 = { "name" => "Joe Scudda", "url" => "http://www.bandsintown.com/JoeScudda", "mbid" => nil } # sorry Joe its just an example
             
       @venue_hash = {
         "id" => 327987,
@@ -125,10 +125,10 @@ describe Bandsintown::Event do
       @built_event.venue.should == built_venue
     end
     it "should set the Event's Artists" do
-      built_artist_1 = mock(Bandsintown::Artist, :name => "Little Brother")
-      built_artist_2 = mock(Bandsintown::Artist, :name => "Joe Scudda")
-      Bandsintown::Artist.should_receive(:new).with(@artist_1["name"], @artist_1["url"]).and_return(built_artist_1)
-      Bandsintown::Artist.should_receive(:new).with(@artist_2["name"], @artist_2["url"]).and_return(built_artist_2)
+      built_artist_1 = mock(Bandsintown::Artist)
+      built_artist_2 = mock(Bandsintown::Artist)
+      Bandsintown::Artist.should_receive(:new).with(:name => @artist_1["name"], :url => @artist_1["url"], :mbid => @artist_1["mbid"]).and_return(built_artist_1)
+      Bandsintown::Artist.should_receive(:new).with(:name => @artist_2["name"], :url => @artist_2["url"], :mbid => @artist_2["mbid"]).and_return(built_artist_2)
       @built_event = Bandsintown::Event.build_from_json(@event_hash)
       @built_event.artists.should == [built_artist_1, built_artist_2]
     end

data/website/index.html

@@ -34,7 +34,7 @@
     <div class="sidebar">
       <div id="version" class="clickable" onclick='document.location = "http://rubyforge.org/projects/bandsintown"; return false'>
         <p>Get Version</p>
-        <a href="http://rubyforge.org/projects/bandsintown" class="numbers">0.1.1</a>
+        <a href="http://rubyforge.org/projects/bandsintown" class="numbers">0.1.2</a>
       </div>
     </div>
     <h2>Description</h2>
@@ -53,7 +53,17 @@
 </pre></p>
 <h3>Find all upcoming events for a given artist</h3>
 <p><pre class='syntax'>
-<span class="ident">artist</span> <span class="punct">=</span> <span class="constant">Bandsintown</span><span class="punct">::</span><span class="constant">Artist</span><span class="punct">.</span><span class="ident">new</span><span class="punct">('</span><span class="string">The Killers</span><span class="punct">')</span>
+<span class="ident">artist</span> <span class="punct">=</span> <span class="constant">Bandsintown</span><span class="punct">::</span><span class="constant">Artist</span><span class="punct">.</span><span class="ident">new</span><span class="punct">({</span>
+  <span class="symbol">:name</span> <span class="punct">=&gt;</span> <span class="punct">'</span><span class="string">The Killers</span><span class="punct">'</span>
+<span class="punct">})</span>
+<span class="ident">events</span> <span class="punct">=</span> <span class="ident">artist</span><span class="punct">.</span><span class="ident">events</span>
+</pre></p>
+<h3>Find all upcoming events for a given artist using mbid (music brainz id)</h3>
+<p><pre class='syntax'>
+<span class="comment"># 486af4f0-a79b-468f-be73-527cd4caf6ea =&gt; mbid for Slick Rick</span>
+<span class="ident">artist</span> <span class="punct">=</span> <span class="constant">Bandsintown</span><span class="punct">::</span><span class="constant">Artist</span><span class="punct">.</span><span class="ident">new</span><span class="punct">({</span> 
+  <span class="symbol">:mbid</span> <span class="punct">=&gt;</span> <span class="punct">&quot;</span><span class="string">486af4f0-a79b-468f-be73-527cd4caf6ea</span><span class="punct">&quot;</span>
+<span class="punct">})</span>
 <span class="ident">events</span> <span class="punct">=</span> <span class="ident">artist</span><span class="punct">.</span><span class="ident">events</span>
 </pre></p>
 <h3>Find events this week around Boston, MA</h3>
@@ -72,6 +82,19 @@
   <span class="symbol">:end_date</span> <span class="punct">=&gt;</span> <span class="number">1</span><span class="punct">.</span><span class="ident">week</span><span class="punct">.</span><span class="ident">from_now</span>
 <span class="punct">})</span>
 </pre></p>
+<h3>Find events this month for Ghostface Killah and Raekwon using mbid (music brainz id)</h3>
+<p><pre class='syntax'>
+<span class="comment"># 3b39abeb-0064-4eed-9ddd-ee47a45c54cb =&gt; mbid for Ghostface Killah</span>
+<span class="comment"># 4e954b02-fae2-4bd7-9547-e055a6ac0527 =&gt; mbid for Raekwon</span>
+<span class="ident">events</span> <span class="punct">=</span> <span class="constant">Bandsintown</span><span class="punct">::</span><span class="constant">Event</span><span class="punct">.</span><span class="ident">search</span><span class="punct">({</span>
+  <span class="symbol">:artists</span> <span class="punct">=&gt;</span> <span class="punct">[</span>
+    <span class="punct">'</span><span class="string">mbid_3b39abeb-0064-4eed-9ddd-ee47a45c54cb</span><span class="punct">',</span> 
+    <span class="punct">'</span><span class="string">mbid_4e954b02-fae2-4bd7-9547-e055a6ac0527</span><span class="punct">'</span>
+  <span class="punct">],</span> 
+  <span class="symbol">:start_date</span> <span class="punct">=&gt;</span> <span class="constant">Time</span><span class="punct">.</span><span class="ident">now</span><span class="punct">.</span><span class="ident">beginning_of_month</span><span class="punct">,</span> 
+  <span class="symbol">:end_date</span> <span class="punct">=&gt;</span> <span class="constant">Time</span><span class="punct">.</span><span class="ident">now</span><span class="punct">.</span><span class="ident">end_of_month</span>
+<span class="punct">})</span>
+</pre></p>
 <h3>Find recommended events around Boston, MA for fans of Led Zeppelin</h3>
 <p><pre class='syntax'>
 <span class="ident">events</span> <span class="punct">=</span> <span class="constant">Bandsintown</span><span class="punct">::</span><span class="constant">Event</span><span class="punct">.</span><span class="ident">recommended</span><span class="punct">({</span>

data/website/index.txt

@@ -29,7 +29,19 @@ Bandsintown.app_id = 'YOUR_APP_ID'
 h3. Find all upcoming events for a given artist 
 
 <pre syntax="ruby">
-artist = Bandsintown::Artist.new('The Killers')
+artist = Bandsintown::Artist.new({
+  :name => 'The Killers'
+})
+events = artist.events
+</pre>
+
+h3. Find all upcoming events for a given artist using mbid (music brainz id)
+
+<pre syntax="ruby">
+# 486af4f0-a79b-468f-be73-527cd4caf6ea => mbid for Slick Rick
+artist = Bandsintown::Artist.new({ 
+  :mbid => "486af4f0-a79b-468f-be73-527cd4caf6ea"
+})
 events = artist.events
 </pre>
 
@@ -53,6 +65,21 @@ events = Bandsintown::Event.search({
 })
 </pre>
 
+h3. Find events this month for Ghostface Killah and Raekwon using mbid (music brainz id)
+
+<pre syntax="ruby">
+# 3b39abeb-0064-4eed-9ddd-ee47a45c54cb => mbid for Ghostface Killah
+# 4e954b02-fae2-4bd7-9547-e055a6ac0527 => mbid for Raekwon
+events = Bandsintown::Event.search({
+  :artists => [
+    'mbid_3b39abeb-0064-4eed-9ddd-ee47a45c54cb', 
+    'mbid_4e954b02-fae2-4bd7-9547-e055a6ac0527'
+  ], 
+  :start_date => Time.now.beginning_of_month, 
+  :end_date => Time.now.end_of_month
+})
+</pre>
+
 h3. Find recommended events around Boston, MA for fans of Led Zeppelin
 
 <pre syntax="ruby">

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: bandsintown
 version: !ruby/object:Gem::Version 
-  version: 0.1.1
+  version: 0.1.2
 platform: ruby
 authors: 
 - Mike Costanza
@@ -9,7 +9,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2009-09-08 00:00:00 -04:00
+date: 2009-11-12 00:00:00 -05:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -40,7 +40,7 @@ dependencies:
     requirements: 
     - - ">="
       - !ruby/object:Gem::Version 
-        version: 1.2.1
+        version: 1.5.2
     version: 
 - !ruby/object:Gem::Dependency 
   name: hoe
@@ -50,7 +50,7 @@ dependencies:
     requirements: 
     - - ">="
       - !ruby/object:Gem::Version 
-        version: 1.8.0
+        version: 2.3.3
     version: 
 description: |-
   Bandsintown.com API gem
@@ -69,7 +69,6 @@ extensions: []
 extra_rdoc_files: 
 - History.txt
 - Manifest.txt
-- README.rdoc
 - website/index.txt
 files: 
 - History.txt
@@ -106,7 +105,7 @@ licenses: []
 post_install_message: 
 rdoc_options: 
 - --main
-- README.rdoc
+- README.txt
 require_paths: 
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement 
@@ -124,7 +123,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 
 rubyforge_project: bandsintown
-rubygems_version: 1.3.3
+rubygems_version: 1.3.5
 signing_key: 
 specification_version: 3
 summary: Bandsintown.com API gem  A Ruby library for accessing the Bandsintown API