intown 0.1.0

data/.gitignore

@@ -0,0 +1,17 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp

data/.rspec

@@ -0,0 +1 @@
+--color --format nested

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in tourbus.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2013 Ben Scheirman
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,78 @@
+# Intown
+
+A gem to consume the Bandsintown 2.0 API.  Supports finding artists by name, MusicBrainz ID, & Facebook Page Id.  Supports returning events by artist & optional date range.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'intown'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install intown
+
+## Usage
+
+Set your "app_id" configuration before making any calls.  In a Rails app, this would go in `config/initializers/intown.rb`.
+
+```ruby
+Intown.configure do |config|
+  config.app_id = <YOUR APP ID HERE>
+end
+```
+
+### Fetching an artist
+
+```ruby
+Intown::Artist.fetch(params)
+```
+
+Params should be one of the following:
+
+```ruby
+{:name => "Radiohead"}
+{:mbid => "<band's MusicBrainz ID>"}
+{:fbid => "<band's Facebook page ID>"}
+```
+
+Returns an object that responds to the API attributes in the [Bandsintown API documentation](http://www.bandsintown.com/api/responses#artist-json)
+
+Returns nil if the band cannot be found.
+
+### Fetching events for an artist
+
+```ruby
+Intown::Event.list(params)
+```
+
+Params should identify the artist to search for (see above).  Params may also include one of the following date options:
+
+```ruby
+{:upcoming => true}        # default: only returns future events
+{:all => true}             # returns all events for this artist
+{:date => 3.days.from_now} # returns all events on the specified date
+{:from => 3.days.ago, :to => 5.days.from_now } # returns all events in the date range (inclusive)
+```
+
+Returns an object that responds to the API attributes in the [Bandsintown API documentation](http://www.bandsintown.com/api/responses#event-json)
+
+Returns nil if the band does not exist.
+
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Write Tests
+5. Push to the branch (`git push origin my-new-feature`)
+6. Create new Pull Request
+
+## License
+
+This code is provided under the MIT license.  See LICENSE.txt for more details.

data/Rakefile

@@ -0,0 +1 @@
+require "bundler/gem_tasks"

data/intown.gemspec

@@ -0,0 +1,27 @@
+# -*- encoding: utf-8 -*-
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'intown/version'
+
+Gem::Specification.new do |gem|
+  gem.name          = "intown"
+  gem.version       = Intown::VERSION
+  gem.authors       = ["Ben Scheirman"]
+  gem.email         = ["ben@scheirman.com"]
+  gem.description   = %q{A client for the Bandsintown API.}
+  gem.summary       = %q{Supports Bandsintown API version 1.1}
+  gem.homepage      = "https://github.com/subdigital/intown"
+
+  gem.files         = `git ls-files`.split($/)
+  gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
+  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
+  gem.require_paths = ["lib"]
+
+  gem.add_development_dependency 'rspec', '~> 2.12.0'
+  gem.add_development_dependency 'vcr', '~> 2.4.0'
+  gem.add_development_dependency 'webmock', '~> 1.9.3'
+  gem.add_development_dependency 'pry'
+
+  gem.add_dependency 'httparty', '~> 0.10.0'
+  gem.add_dependency 'hashie', '~> 2.0.0'
+end

data/lib/intown/artist.rb

@@ -0,0 +1,11 @@
+module Intown
+  class Artist < Client
+    class << self
+      def fetch(params)
+        identifier = artist_identifier(params)
+        response = get("/artists/#{URI.encode(identifier)}", options)
+        process_response(response)
+      end
+    end
+  end
+end

data/lib/intown/client.rb

@@ -0,0 +1,62 @@
+require 'httparty'
+require 'json'
+require 'hashie'
+
+module Intown
+  class Client
+    include HTTParty
+    API_VERSION = 2.0
+    base_uri "https://api.bandsintown.com"
+
+    class << self
+
+      def options
+        {
+          :query => {
+             :app_id => Intown.configuration.app_id, :api_version => API_VERSION 
+          }
+        }
+      end
+
+      def process_response(response)
+        case response.code
+        when 500 then raise Intown::InvalidRequestError, response.body
+        when 404 then process_not_found(response)
+        else
+          json_response = JSON.parse(response.body)
+
+          if json_response.is_a? Hash
+            Hashie::Mash.new(json_response)
+          elsif json_response.is_a? Array
+            json_response.map {|e| Hashie::Mash.new(e)}
+          else
+            json_response
+          end
+        end
+      end
+
+      def process_not_found(response)
+        json = JSON.parse(response.body)
+        if errors = json['errors']
+          raise Intown::InvalidRequestError, "app_id is required for this request" if errors.any? {|e| e =~ /app_id param is required/}
+        end
+        nil
+      end
+
+      def artist_identifier(params)
+        return musicbrainz_identifier(params[:mbid]) if params[:mbid]
+        return facebook_identifier(params[:fbid]) if params[:fbid]
+        return params[:name] if params[:name]
+        raise ArgumentError, "params must contain one of mbid, fbid, or name"
+      end
+
+      def musicbrainz_identifier(mbid)
+        "mbid_#{mbid}"
+      end
+
+      def facebook_identifier(fbid)
+        "fbid_#{fbid}"
+      end
+    end
+  end
+end

data/lib/intown/configuration.rb

@@ -0,0 +1,16 @@
+module Intown
+  class Configuration
+    attr_accessor :app_id
+  end
+
+  class << self
+    def configure(&block)
+      @configuration = Configuration.new
+      yield @configuration
+    end
+
+    def configuration
+      @configuration ||= Configuration.new
+    end
+  end
+end

data/lib/intown/errors.rb

@@ -0,0 +1,4 @@
+module Intown
+  IntownError = Class.new(StandardError)
+  InvalidRequestError = Class.new(IntownError)
+end

data/lib/intown/event.rb

@@ -0,0 +1,25 @@
+module Intown
+  class Event < Client
+    class << self
+      def list(params)
+        identifier = artist_identifier(params)
+        event_params = options.merge(date_options(params))
+        url = "/artists/#{URI.encode(identifier)}/events"
+        response = get(url, event_params)
+        process_response(response)
+      end
+
+      def date_options(params)
+        return {:date => format_date(params[:date])} if params[:date]
+        return {:date => "#{format_date(params[:from])},#{format_date(params[:to])}"} if params[:from] && params[:to]
+        return {:date => "upcoming"} if params[:upcoming] == true
+        return {:date => "all"} if params[:all] == true
+        {}
+      end
+
+      def format_date(date)
+        date.strftime("%Y-%m-%d")
+      end
+    end
+  end
+end

data/lib/intown/version.rb

@@ -0,0 +1,3 @@
+module Intown
+  VERSION = "0.1.0"
+end

data/lib/intown.rb

@@ -0,0 +1,9 @@
+require "intown/version"
+require "intown/configuration"
+require "intown/errors"
+require "intown/client"
+require "intown/artist"
+require "intown/event"
+
+module Intown
+end

data/spec/acceptance/fetch_artist_by_name_spec.rb

@@ -0,0 +1,38 @@
+require 'spec_helper'
+
+describe Intown::Artist do
+
+  context "without configuring an app id" do
+    before do
+      Intown.configure {|c| c.app_id = nil}
+    end
+    it "should raise an error if the app id param is not set" do
+      VCR.use_cassette("fetch_artist_no_app_id_set") do
+        expect { Intown::Artist.fetch(:name => "foobar") }.to raise_error Intown::InvalidRequestError
+      end
+    end
+  end
+
+  context "with an app id configured" do
+    before do
+      Intown.configure {|c| c.app_id = "test"}
+    end
+
+    it "should return nil for unknown artists" do
+      VCR.use_cassette("find_unknown_artist") do
+        Intown::Artist.fetch(:name => "Ishouldnotexist").should be_nil
+      end
+    end
+
+    it "should be fetched by name" do
+      VCR.use_cassette("find_artist_by_name") do
+        artist = Intown::Artist.fetch(:name => "My Morning Jacket")
+        artist.name.should == "My Morning Jacket"
+        artist.upcoming_events_count.should_not be_nil
+        artist.image_url.should_not be_nil
+        artist.mbid.should_not be_nil
+      end
+    end
+  end
+
+end

data/spec/acceptance/fetch_events_by_artist_spec.rb

@@ -0,0 +1,26 @@
+require 'spec_helper'
+
+describe Intown::Event do
+  before :each do
+    Intown.configure do |c|
+      c.app_id = "test"
+    end
+  end
+  context "Fetching events for an unknown band" do
+    it "should return nil" do
+      VCR.use_cassette("fetch events for unknown band") do
+        events = Intown::Event.list(:name => "GoobleGobble124")
+        events.should be_nil
+      end
+    end
+  end
+
+  context "Fetching events for an unknown band" do
+    it "should return nil" do
+      VCR.use_cassette("fetch events for known band") do
+        events = Intown::Event.list(:name => "Blame Sally")
+        events.length.should >= 0
+      end
+    end
+  end
+end

data/spec/fixtures/cassettes/fetch_artist_no_app_id_set.yml

@@ -0,0 +1,43 @@
+---
+http_interactions:
+- request:
+    method: get
+    uri: https://api.bandsintown.com/artists/foobar?api_version=2.0&app_id=
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers: {}
+  response:
+    status:
+      code: 404
+      message: Not Found
+    headers:
+      Date:
+      - Thu, 21 Feb 2013 20:11:49 GMT
+      Server:
+      - Mongrel 1.1.5
+      Content-Length:
+      - '40'
+      Content-Type:
+      - application/json; charset=utf-8
+      X-Runtime:
+      - '0.02046'
+      Status:
+      - 404 Not Found
+      Cache-Control:
+      - no-cache
+      Set-Cookie:
+      - _session_id=04cd7ac85a121e74bfb474f94f04c501; path=/; expires=Thu, 21 Mar
+        2013 19:11:49 GMT
+      Vary:
+      - Accept-Encoding
+      Connection:
+      - close
+    body:
+      encoding: US-ASCII
+      string: ! '{"errors":["app_id param is required"]}
+
+'
+    http_version: 
+  recorded_at: Thu, 21 Feb 2013 20:11:49 GMT
+recorded_with: VCR 2.4.0

data/spec/fixtures/cassettes/fetch_events_for_known_band.yml

@@ -0,0 +1,62 @@
+---
+http_interactions:
+- request:
+    method: get
+    uri: https://api.bandsintown.com/artists/Blame%20Sally/events?api_version=2.0&app_id=test
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers: {}
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Date:
+      - Thu, 21 Feb 2013 20:15:44 GMT
+      Server:
+      - Mongrel 1.1.5
+      Etag:
+      - ! '"8f78b9ff373c3291535e34a9c28a2d67"'
+      Content-Length:
+      - '5768'
+      Cache-Control:
+      - private, max-age=0, must-revalidate
+      X-Runtime:
+      - '0.06541'
+      Status:
+      - 200 OK
+      Content-Type:
+      - application/json; charset=utf-8
+      Set-Cookie:
+      - _session_id=09b05e580a4b65a836214fc870b5b76b; path=/; expires=Thu, 21 Mar
+        2013 19:15:44 GMT
+      Vary:
+      - Accept-Encoding
+      Connection:
+      - close
+    body:
+      encoding: US-ASCII
+      string: ! '[{"ticket_status":"unavailable","ticket_type":null,"ticket_url":null,"formatted_location":"Chico,
+        CA","formatted_datetime":"Monday, April 15, 2013 at 7:30pm","facebook_rsvp_url":"http:\/\/www.bandsintown.com\/event\/6216225\/facebook_rsvp?app_id=test&artist=Blame+Sally&came_from=67","artists":[{"mbid":"b30ac2b1-a4fc-45a3-98ff-9087a6a10208","name":"Blame
+        Sally","image_url":"http:\/\/www.bandsintown.com\/BlameSally\/photo\/medium.jpg","facebook_tour_dates_url":"http:\/\/bnds.in\/HQt8jZ","thumb_url":"http:\/\/www.bandsintown.com\/BlameSally\/photo\/small.jpg"}],"facebook_share_url":"https:\/\/www.facebook.com\/dialog\/feed?actions=%7B%22link%22%3A%22http%3A%5C%2F%5C%2Fwww.bandsintown.com%5C%2Fevent%5C%2F6216225%5C%2Ffacebook_rsvp%3Fartist%3DBlame%2BSally%26came_from%3D78%22%2C%22name%22%3A%22RSVP%22%7D&app_id=123966167614127&caption=Monday%2C+April+15%2C+2013+at+7%3A30pm&description=%26nbsp%3B&link=http%3A%2F%2Fwww.bandsintown.com%2Fevent%2F6216225%2Ffacebook_rsvp%3Fartist%3DBlame%2BSally%26came_from%3D77&name=Blame+Sally+%40+Sierra+Nevada+Brewing+Co.+in+Chico%2C+CA&picture=https%3A%2F%2Fd12nfv3nknyhzq.cloudfront.net%2FBlameSally%2Fphoto%2Flarge.jpg&properties=%7B%22More+Tour+Dates%22%3A%7B%22text%22%3A%22http%3A%5C%2F%5C%2Fbnds.in%5C%2FIgxMaj%22%2C%22href%22%3A%22http%3A%5C%2F%5C%2Fwww.bandsintown.com%5C%2FBlameSally%5C%2Ffacebookapp%3Fcame_from%3D78%22%7D%7D&redirect_uri=http%3A%2F%2Fwww.bandsintown.com%2Fevent%2F6216225%2Ffacebook_rsvp%3Fartist%3DBlame%2BSally%26came_from%3D102","title":"Blame
+        Sally @ Sierra Nevada Brewing Co. in Chico, CA","id":"6216225","description":null,"on_sale_datetime":null,"venue":{"country":"United
+        States","name":"Sierra Nevada Brewing Co.","longitude":"-121.8139110","city":"Chico","region":"CA","latitude":"39.7249330"},"datetime":"2013-04-15T19:30:00"},
+
+        {"ticket_status":"unavailable","ticket_type":null,"ticket_url":null,"formatted_location":"Seattle,
+        WA","formatted_datetime":"Friday, April 19, 2013 at 9:00pm","facebook_rsvp_url":"http:\/\/www.bandsintown.com\/event\/6128697\/facebook_rsvp?app_id=test&artist=Blame+Sally&came_from=67","artists":[{"mbid":"b30ac2b1-a4fc-45a3-98ff-9087a6a10208","name":"Blame
+        Sally","image_url":"http:\/\/www.bandsintown.com\/BlameSally\/photo\/medium.jpg","facebook_tour_dates_url":"http:\/\/bnds.in\/HQt8jZ","thumb_url":"http:\/\/www.bandsintown.com\/BlameSally\/photo\/small.jpg"}],"facebook_share_url":"https:\/\/www.facebook.com\/dialog\/feed?actions=%7B%22link%22%3A%22http%3A%5C%2F%5C%2Fwww.bandsintown.com%5C%2Fevent%5C%2F6128697%5C%2Ffacebook_rsvp%3Fartist%3DBlame%2BSally%26came_from%3D78%22%2C%22name%22%3A%22RSVP%22%7D&app_id=123966167614127&caption=Friday%2C+April+19%2C+2013+at+9%3A00pm&description=%26nbsp%3B&link=http%3A%2F%2Fwww.bandsintown.com%2Fevent%2F6128697%2Ffacebook_rsvp%3Fartist%3DBlame%2BSally%26came_from%3D77&name=Blame+Sally+%40+The+Triple+Door+in+Seattle%2C+WA&picture=https%3A%2F%2Fd12nfv3nknyhzq.cloudfront.net%2FBlameSally%2Fphoto%2Flarge.jpg&properties=%7B%22More+Tour+Dates%22%3A%7B%22text%22%3A%22http%3A%5C%2F%5C%2Fbnds.in%5C%2FIgxMaj%22%2C%22href%22%3A%22http%3A%5C%2F%5C%2Fwww.bandsintown.com%5C%2FBlameSally%5C%2Ffacebookapp%3Fcame_from%3D78%22%7D%7D&redirect_uri=http%3A%2F%2Fwww.bandsintown.com%2Fevent%2F6128697%2Ffacebook_rsvp%3Fartist%3DBlame%2BSally%26came_from%3D102","title":"Blame
+        Sally @ The Triple Door in Seattle, WA","id":"6128697","description":null,"on_sale_datetime":null,"venue":{"country":"United
+        States","name":"The Triple Door","longitude":"-122.3379440","city":"Seattle","region":"WA","latitude":"47.6084330"},"datetime":"2013-04-19T21:00:00"},
+
+        {"ticket_status":"available","ticket_type":"Tickets","ticket_url":"http:\/\/www.bandsintown.com\/event\/5985466\/buy_tickets?app_id=test&artist=Blame+Sally","formatted_location":"San
+        Francisco, CA","formatted_datetime":"Saturday, May 11, 2013 at 9:00pm","facebook_rsvp_url":"http:\/\/www.bandsintown.com\/event\/5985466\/facebook_rsvp?app_id=test&artist=Blame+Sally&came_from=67","artists":[{"mbid":"b30ac2b1-a4fc-45a3-98ff-9087a6a10208","name":"Blame
+        Sally","image_url":"http:\/\/www.bandsintown.com\/BlameSally\/photo\/medium.jpg","facebook_tour_dates_url":"http:\/\/bnds.in\/HQt8jZ","thumb_url":"http:\/\/www.bandsintown.com\/BlameSally\/photo\/small.jpg"}],"facebook_share_url":"https:\/\/www.facebook.com\/dialog\/feed?actions=%7B%22link%22%3A%22http%3A%5C%2F%5C%2Fwww.bandsintown.com%5C%2Fevent%5C%2F5985466%5C%2Ffacebook_rsvp%3Fartist%3DBlame%2BSally%26came_from%3D78%22%2C%22name%22%3A%22RSVP%22%7D&app_id=123966167614127&caption=Saturday%2C+May+11%2C+2013+at+9%3A00pm&description=%26nbsp%3B&link=http%3A%2F%2Fwww.bandsintown.com%2Fevent%2F5985466%2Ffacebook_rsvp%3Fartist%3DBlame%2BSally%26came_from%3D77&name=Blame+Sally+%40+Great+American+Music+Hall+in+San+Francisco%2C+CA&picture=https%3A%2F%2Fd12nfv3nknyhzq.cloudfront.net%2FBlameSally%2Fphoto%2Flarge.jpg&properties=%7B%22Tickets%22%3A%7B%22text%22%3A%22http%3A%5C%2F%5C%2Fbnds.in%5C%2FUNp0bR%22%2C%22href%22%3A%22http%3A%5C%2F%5C%2Fwww.bandsintown.com%5C%2Fevent%5C%2F5985466%5C%2Fbuy_tickets%3Faffil_code%3Dfb_19907696684%26artist%3DBlame%2BSally%22%7D%2C%22More+Tour+Dates%22%3A%7B%22text%22%3A%22http%3A%5C%2F%5C%2Fbnds.in%5C%2FIgxMaj%22%2C%22href%22%3A%22http%3A%5C%2F%5C%2Fwww.bandsintown.com%5C%2FBlameSally%5C%2Ffacebookapp%3Fcame_from%3D78%22%7D%7D&redirect_uri=http%3A%2F%2Fwww.bandsintown.com%2Fevent%2F5985466%2Ffacebook_rsvp%3Fartist%3DBlame%2BSally%26came_from%3D102","title":"Blame
+        Sally @ Great American Music Hall in San Francisco, CA","id":"5985466","description":null,"on_sale_datetime":null,"venue":{"country":"United
+        States","name":"Great American Music Hall","longitude":"-122.4205960","city":"San
+        Francisco","region":"CA","latitude":"37.7943790"},"datetime":"2013-05-11T21:00:00"}]
+
+'
+    http_version: 
+  recorded_at: Thu, 21 Feb 2013 20:15:44 GMT
+recorded_with: VCR 2.4.0

data/spec/fixtures/cassettes/fetch_events_for_unknown_band.yml

@@ -0,0 +1,43 @@
+---
+http_interactions:
+- request:
+    method: get
+    uri: https://api.bandsintown.com/artists/GoobleGobble124/events?api_version=2.0&app_id=test
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers: {}
+  response:
+    status:
+      code: 404
+      message: Not Found
+    headers:
+      Date:
+      - Thu, 21 Feb 2013 20:11:51 GMT
+      Server:
+      - Mongrel 1.1.5
+      Status:
+      - 404 Not Found
+      Cache-Control:
+      - no-cache
+      Content-Type:
+      - application/json; charset=utf-8
+      Content-Length:
+      - '30'
+      X-Runtime:
+      - '0.00860'
+      Set-Cookie:
+      - _session_id=5d23778c700fcb71fd14d2061fc20e43; path=/; expires=Thu, 21 Mar
+        2013 19:11:51 GMT
+      Vary:
+      - Accept-Encoding
+      Connection:
+      - close
+    body:
+      encoding: US-ASCII
+      string: ! '{"errors":["Unknown Artist"]}
+
+'
+    http_version: 
+  recorded_at: Thu, 21 Feb 2013 20:11:51 GMT
+recorded_with: VCR 2.4.0

data/spec/fixtures/cassettes/find_artist_by_name.yml

@@ -0,0 +1,44 @@
+---
+http_interactions:
+- request:
+    method: get
+    uri: https://api.bandsintown.com/artists/My%20Morning%20Jacket?api_version=2.0&app_id=test
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers: {}
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Date:
+      - Thu, 21 Feb 2013 20:11:50 GMT
+      Server:
+      - Mongrel 1.1.5
+      Etag:
+      - ! '"f71ae1412f3e37311757d098764b8aad"'
+      Cache-Control:
+      - private, max-age=0, must-revalidate
+      Status:
+      - 200 OK
+      X-Runtime:
+      - '0.04589'
+      Content-Length:
+      - '310'
+      Content-Type:
+      - application/json; charset=utf-8
+      Set-Cookie:
+      - _session_id=b50f066fa543a15f617acfe11a075bb2; path=/; expires=Thu, 21 Mar
+        2013 19:11:50 GMT
+      Vary:
+      - Accept-Encoding
+      Connection:
+      - close
+    body:
+      encoding: US-ASCII
+      string: ! '{"mbid":"ea5883b7-68ce-48b3-b115-61746ea53b8c","upcoming_events_count":0,"image_url":"http:\/\/www.bandsintown.com\/MyMorningJacket\/photo\/medium.jpg","thumb_url":"http:\/\/www.bandsintown.com\/MyMorningJacket\/photo\/small.jpg","name":"My
+        Morning Jacket","facebook_tour_dates_url":"http:\/\/bnds.in\/zTPiUu"}'
+    http_version: 
+  recorded_at: Thu, 21 Feb 2013 20:11:50 GMT
+recorded_with: VCR 2.4.0

data/spec/fixtures/cassettes/find_unknown_artist.yml

@@ -0,0 +1,43 @@
+---
+http_interactions:
+- request:
+    method: get
+    uri: https://api.bandsintown.com/artists/Ishouldnotexist?api_version=2.0&app_id=test
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers: {}
+  response:
+    status:
+      code: 404
+      message: Not Found
+    headers:
+      Date:
+      - Thu, 21 Feb 2013 20:11:50 GMT
+      Server:
+      - Mongrel 1.1.5
+      Content-Type:
+      - application/json; charset=utf-8
+      X-Runtime:
+      - '0.01188'
+      Status:
+      - 404 Not Found
+      Cache-Control:
+      - no-cache
+      Content-Length:
+      - '30'
+      Set-Cookie:
+      - _session_id=407c1b0ceec22028ba725603afbe8534; path=/; expires=Thu, 21 Mar
+        2013 19:11:50 GMT
+      Vary:
+      - Accept-Encoding
+      Connection:
+      - close
+    body:
+      encoding: US-ASCII
+      string: ! '{"errors":["Unknown Artist"]}
+
+'
+    http_version: 
+  recorded_at: Thu, 21 Feb 2013 20:11:50 GMT
+recorded_with: VCR 2.4.0

data/spec/intown/artist_spec.rb

@@ -0,0 +1,44 @@
+require 'spec_helper'
+
+describe Intown::Artist do
+  let(:response) {
+    stub(:code => 200,
+         :body => '{
+                    "upcoming_events_count":0,
+                    "thumb_url":"http:\/\/www.bandsintown.com\/Nirvana\/photo\/small.jpg",
+                    "name": "Nirvana",
+                    "image_url":"http:\/\/www.bandsintown.com\/Nirvana\/photo\/medium.jpg",
+                    "mbid":"ea5883b7-68ce-48b3-b115-61746ea53b8c",
+                    "facebook_tour_dates_url":"http:\/\/bnds.in\/zTPiUu"
+                  }'
+        )
+  }
+
+  context "searching by name" do
+    it "should put the name in the artist url" do
+      Intown::Artist.should_receive(:get).with(/\/artists\/Nirvana/, anything).and_return(response)
+      Intown::Artist.fetch(:name => "Nirvana")
+    end
+  end
+
+  context "searching by name with spaces" do
+    it "should url encode the spaces" do
+      Intown::Artist.should_receive(:get).with(/\/artists\/Foo%20Fighters/, anything).and_return(response)
+      Intown::Artist.fetch(:name => "Foo Fighters")
+    end
+  end
+
+  context "searching by musicbrainz id" do
+    it "should format the musicbrainz id in the url" do
+      Intown::Artist.should_receive(:get).with(/\/artists\/mbid_1234567890abcd/, anything).and_return(response)
+      Intown::Artist.fetch(:mbid => "1234567890abcd")
+    end
+  end
+
+  context "searching with invalid params" do
+    it "should raise an argument error" do
+      expect { Intown::Artist.fetch(:foo_bar => "baz") }.to raise_error ArgumentError
+    end
+  end
+
+end

data/spec/intown/configuration_spec.rb

@@ -0,0 +1,11 @@
+require 'spec_helper'
+
+describe Intown::Configuration do
+  it "should set an app_id" do
+    Intown.configure do |config|
+      config.app_id = "my_app"
+    end
+
+    Intown.configuration.app_id.should == "my_app"
+  end
+end

data/spec/intown/event_spec.rb

@@ -0,0 +1,53 @@
+require 'spec_helper'
+
+describe Intown::Event do
+  let(:response) {
+    stub(:code => 200,
+         :body => '{"foo":"bar"}')
+  }
+
+  context "searching by artist id" do
+    it "should format the proper artist term in the url" do
+      Intown::Event.should_receive(:get).with(/artists\/Radiohead\/events/, anything).and_return(response)
+      Intown::Event.list(:name => "Radiohead")
+    end
+  end
+
+  context "Searching by date range" do
+    before :each do
+      Intown::Event.should_receive(:get).with(anything, hash_including(expected_params)).and_return(response)
+    end
+
+    context "single date" do
+      let(:expected_params) {{ :date => '2013-03-02' }}
+      let(:input_params)    {{ :name => "Radiohead", :date => Time.new(2013, 3, 2) }}
+      it "should format the date in the url" do
+        Intown::Event.list(input_params)
+      end
+    end
+
+    context "date range" do
+      let(:expected_params) {{ :date => '2013-03-02,2013-03-08' }}
+      let(:input_params)    {{ :name => "Radiohead", :from => Time.new(2013, 3, 2), :to => Time.new(2013, 3, 8)}}
+      it "should format the date range from to/from date params" do
+        Intown::Event.list(input_params)
+      end
+    end
+
+    context "upcoming" do
+      let(:expected_params) {{ :date => 'upcoming' }}
+      let(:input_params)    {{ :name => "Radiohead", :upcoming => true}}
+      it "should set the date parameter to upcoming" do
+        Intown::Event.list(input_params)
+      end
+    end
+
+    context "all" do
+      let(:expected_params) {{ :date => 'all' }}
+      let(:input_params)    {{ :name => "Radiohead", :all => true}}
+      it "should set the date parameter to all" do
+        Intown::Event.list(input_params)
+      end
+    end
+  end
+end

data/spec/intown/tourbus_spec.rb

@@ -0,0 +1,7 @@
+require 'spec_helper'
+
+describe Intown do
+  it "should define a version" do
+    Intown::VERSION.should_not be_nil
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,14 @@
+lib = File.expand_path('../../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'rubygems'
+require 'intown'
+require 'rspec'
+require 'vcr'
+require 'httparty'
+require 'pry'
+
+VCR.configure do |c|
+  c.cassette_library_dir = 'spec/fixtures/cassettes'
+  c.hook_into :webmock
+  c.allow_http_connections_when_no_cassette = true
+end

metadata

@@ -0,0 +1,180 @@
+--- !ruby/object:Gem::Specification
+name: intown
+version: !ruby/object:Gem::Version
+  prerelease: 
+  version: 0.1.0
+platform: ruby
+authors:
+- Ben Scheirman
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-02-21 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.12.0
+    none: false
+  type: :development
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.12.0
+    none: false
+- !ruby/object:Gem::Dependency
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.4.0
+    none: false
+  type: :development
+  name: vcr
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.4.0
+    none: false
+- !ruby/object:Gem::Dependency
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.9.3
+    none: false
+  type: :development
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.9.3
+    none: false
+- !ruby/object:Gem::Dependency
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+    none: false
+  type: :development
+  name: pry
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+    none: false
+- !ruby/object:Gem::Dependency
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.10.0
+    none: false
+  type: :runtime
+  name: httparty
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.10.0
+    none: false
+- !ruby/object:Gem::Dependency
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.0.0
+    none: false
+  type: :runtime
+  name: hashie
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.0.0
+    none: false
+description: A client for the Bandsintown API.
+email:
+- ben@scheirman.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .rspec
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- intown.gemspec
+- lib/intown.rb
+- lib/intown/artist.rb
+- lib/intown/client.rb
+- lib/intown/configuration.rb
+- lib/intown/errors.rb
+- lib/intown/event.rb
+- lib/intown/version.rb
+- spec/acceptance/fetch_artist_by_name_spec.rb
+- spec/acceptance/fetch_events_by_artist_spec.rb
+- spec/fixtures/cassettes/fetch_artist_no_app_id_set.yml
+- spec/fixtures/cassettes/fetch_events_for_known_band.yml
+- spec/fixtures/cassettes/fetch_events_for_unknown_band.yml
+- spec/fixtures/cassettes/find_artist_by_name.yml
+- spec/fixtures/cassettes/find_unknown_artist.yml
+- spec/intown/artist_spec.rb
+- spec/intown/configuration_spec.rb
+- spec/intown/event_spec.rb
+- spec/intown/tourbus_spec.rb
+- spec/spec_helper.rb
+homepage: https://github.com/subdigital/intown
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+  none: false
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+  none: false
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.25
+signing_key: 
+specification_version: 3
+summary: Supports Bandsintown API version 1.1
+test_files:
+- spec/acceptance/fetch_artist_by_name_spec.rb
+- spec/acceptance/fetch_events_by_artist_spec.rb
+- spec/fixtures/cassettes/fetch_artist_no_app_id_set.yml
+- spec/fixtures/cassettes/fetch_events_for_known_band.yml
+- spec/fixtures/cassettes/fetch_events_for_unknown_band.yml
+- spec/fixtures/cassettes/find_artist_by_name.yml
+- spec/fixtures/cassettes/find_unknown_artist.yml
+- spec/intown/artist_spec.rb
+- spec/intown/configuration_spec.rb
+- spec/intown/event_spec.rb
+- spec/intown/tourbus_spec.rb
+- spec/spec_helper.rb
+has_rdoc: