bandcamp_api 0.0.1

data/.gitignore

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

data/.rspec

@@ -0,0 +1,2 @@
+--color
+--format documentation

data/Gemfile

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

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2013 Mike Williamson
+
+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,106 @@
+# Bandcamp
+
+This is a gem that wraps the Bandcamp API in a warm Rubyish hug.
+To use it you will need to request an API key from them. For details see
+[http://bandcamp.com/developer#key_request][].
+
+# Usage
+
+In your Gemfile
+```ruby
+gem 'bandcamp', github: "sleepycat/bandcamp"
+```
+
+## Getting started:
+```ruby
+require 'bandcamp'
+Bandcamp.config.api_key = "your_api_key"
+```
+
+## Search
+
+Search the Bandcamp.com API by band name:
+```ruby
+matching_bands = Bandcamp.search "pitch black"
+=> [#<Bandcamp::Band:0x00000001efa168>, #<Bandcamp::Band:0x00000001e53278>, ...]
+```
+
+## Resolving URLs
+
+Bandcamp lets you resolve a given url to given band, track or album:
+
+```ruby
+sea_oleena = Bandcamp.resolve.url "seaoleena.bandcamp.com"
+=> #<Bandcamp::Band:0x00000001ef20f8>
+
+emoxygen_by_sun_monx = Bandcamp.resolve.url "http://interchill.bandcamp.com/track/emoxygen"
+```
+
+## Getting stuff
+
+A specific track:
+```ruby
+evolution_11 = Bandcamp.get.track 1735088360
+=> #<Bandcamp::Track:0x0000000162c7e8>
+```
+
+Many specific tracks:
+```ruby
+tracks = Bandcamp.get.tracks 1735088360, 1739611553
+=> [#<Bandcamp::Track:0x00000001316ab8>, #<Bandcamp::Track:0x00000001314a10>, ...]
+```
+
+A band:
+```ruby
+pitchblack = Bandcamp.get.band 950934886
+=> #<Bandcamp::Band:0x000000017d43e8>
+```
+
+An album:
+```ruby
+ape_to_angel = Bandcamp.get.album 2909726980
+=> #<Bandcamp::Album:0x00000001e20c60>
+```
+
+## TODO list
+
+* Making the objects a little smarter. Tracks should be able to tell you what album
+  they are from and what band did them. Same sort of thing for the other
+  objects.
+* Rails 3 integration so you can use these ojects with partials and form_for.
+* Duck typing helpers along the lines of [ActiveSupport's
+  #acts_like?](http://apidock.com/rails/Object/acts_like%3F)
+
+## 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. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request
+
+### License
+
+(The MIT License)
+
+Copyright (c) 2013 Mike Williamson
+
+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/Rakefile

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

data/bandcamp_api.gemspec

@@ -0,0 +1,21 @@
+# -*- encoding: utf-8 -*-
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'bandcamp/version'
+
+Gem::Specification.new do |gem|
+  gem.name          = "bandcamp_api"
+  gem.version       = Bandcamp::VERSION
+  gem.authors       = ["Mike Williamson"]
+  gem.email         = ["blessedbyvirtuosity@gmail.com"]
+  gem.description   = "A helper library for accessing the Bandcamp.com api"
+  gem.summary       = "A library for communicating with the Bandcamp.com api and wrapping the various types of data to make it easier to work with."
+  #gem.homepage      = ""
+
+  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")
+  gem.add_runtime_dependency("multi_json")
+end

data/lib/bandcamp/album.rb

@@ -0,0 +1,14 @@
+require 'bandcamp/methodical'
+
+module Bandcamp
+  class Album
+
+    include Methodical
+
+    def initialize album_hash
+      to_methods album_hash
+    end
+
+
+  end
+end

data/lib/bandcamp/band.rb

@@ -0,0 +1,12 @@
+require 'bandcamp/methodical'
+
+module Bandcamp
+  class Band
+    include Methodical
+
+    def initialize attrs_hash
+      to_methods attrs_hash
+    end
+
+  end
+end

data/lib/bandcamp/configuration.rb

@@ -0,0 +1,15 @@
+module Bandcamp
+  class ConfigurationError < StandardError; end
+
+  class Configuration
+
+    attr_writer :api_key
+
+    def api_key
+      raise ConfigurationError, "You need to set an API key" unless @api_key
+      @api_key
+    end
+
+  end
+
+end

data/lib/bandcamp/getter.rb

@@ -0,0 +1,61 @@
+require 'bandcamp/band'
+require 'bandcamp/album'
+require 'bandcamp/track'
+require 'bandcamp/request'
+
+module Bandcamp
+  class Getter
+
+    def initialize request
+      @request = request
+    end
+
+    def track track_id
+      response = @request.track track_id
+      response.nil? ? nil : Track.new(response)
+    end
+
+    def tracks *tracks
+      track_list = tracks.join(',')
+      response = @request.track track_list
+      if response.nil?
+        []
+      else
+        response.collect{|key,val| Track.new val}
+      end
+    end
+
+    def album album_id
+      response = @request.album album_id
+      response.nil? ? nil : Album.new(response)
+    end
+
+    def search band_name
+      response = @request.search band_name
+      if response.nil?
+        []
+      else
+        response.collect{|band_json| Band.new band_json}
+      end
+    end
+
+    def band name
+      response = @request.band name
+      response.nil? ? nil : Band.new(response)
+    end
+
+    def url address
+      response = @request.url address
+      return nil if response.nil?
+      case
+      when response.has_key?("album_id")
+        album(response["album_id"])
+      when response.has_key?("track_id")
+        track(response["track_id"])
+      when (response.keys.length == 1) && response.has_key?("band_id")
+        band(response["band_id"])
+      end
+    end
+
+  end
+end

data/lib/bandcamp/methodical.rb

@@ -0,0 +1,15 @@
+module Bandcamp
+  module Methodical
+
+    def to_methods hash
+      eigenclass = class << self; self; end
+      hash.each_pair do |key, val|
+         eigenclass.instance_eval { attr_reader key.to_sym }
+         instance_variable_set("@#{key}".to_sym, val)
+      end
+    end
+
+    private :to_methods
+
+  end
+end

data/lib/bandcamp/request.rb

@@ -0,0 +1,125 @@
+require 'bandcamp'
+require 'net/http'
+require 'multi_json'
+
+module Bandcamp
+
+  # A helper class for assembling a uri to query the API
+
+  class Request
+
+    attr_reader :api_key
+
+    def initialize api_key
+      @uri = URI('http://api.bandcamp.com')
+      @api_key = api_key
+    end
+
+    def host
+      @uri.host
+    end
+
+    def path
+      @uri.path
+    end
+
+    def path= path
+      @uri.path = path
+    end
+
+    def track trackid
+      self.type :track
+      self.query = { track_id: trackid }
+      response = dispatch
+      response.empty? ? nil : response
+    end
+
+    def album albumid
+      type :album
+      self.query={ album_id: albumid }
+      response = dispatch
+      response.empty? ? nil : response
+    end
+
+    def band bandid
+      type :band
+      self.query={ band_id: bandid }
+      response = dispatch
+      response["error"] ? nil : response
+    end
+
+    def url bandcamp_url
+      type :url
+      self.query = {url: bandcamp_url}
+      response = dispatch
+      response["error"] ? nil : response
+    end
+
+    def discography bandid
+      type :discography
+      self.query = {band_id: bandid}
+      response = dispatch
+      response["discography"].empty? ? nil : response["discography"]
+    end
+
+    def search name
+      type :search
+      self.query = {name: name}
+      response = dispatch
+      response["results"].empty? ? nil : response["results"]
+    end
+
+    def type req_type
+      self.path = case req_type
+                  when :track
+                    '/api/track/3/info'
+                  when :album
+                    '/api/album/2/info'
+                  when :discography
+                    '/api/band/3/discography'
+                  when :search
+                    '/api/band/3/search'
+                  when :band
+                    '/api/band/3/info'
+                  when :url
+                    '/api/url/1/info'
+                  else
+                    raise UnknownTypeError, "The Bandcamp API does not support this type of request."
+                  end
+    end
+
+    def uri
+      @uri.to_s
+    end
+
+    def query= params
+      @uri.query = generate_params(params)
+    end
+
+    def query
+      @uri.query
+    end
+
+    def generate_params params
+      add_key_param(params).map{|key,val| "#{URI.encode(key.to_s)}=#{URI.encode(val.to_s)}"}.join('&')
+    end
+
+    def add_key_param params
+      {key: @api_key}.merge params
+    end
+
+    def dispatch
+      MultiJson.decode(get(@uri))
+    end
+
+    private
+
+    def get uri
+      Net::HTTP.get(uri)
+    end
+
+  end
+
+  class UnknownTypeError < StandardError; end
+
+end

data/lib/bandcamp/track.rb

@@ -0,0 +1,21 @@
+require 'bandcamp/methodical'
+
+module Bandcamp
+  class Track
+
+    include Bandcamp::Methodical
+
+    def initialize attrs
+      to_methods attrs
+    end
+
+    def paid?
+      downloadable == 2 ? true : false
+    end
+
+    def free?
+      downloadable == 1 ? true : false
+    end
+
+  end
+end

data/lib/bandcamp/version.rb

@@ -0,0 +1,3 @@
+module Bandcamp
+  VERSION = "0.0.1"
+end

data/lib/bandcamp.rb

@@ -0,0 +1,32 @@
+require "bandcamp/request"
+require "bandcamp/getter"
+require "bandcamp/track"
+require "bandcamp/configuration"
+require "bandcamp/version"
+
+module Bandcamp
+
+  def self.config
+    @configuration ||= Configuration.new
+  end
+
+  def self.get
+    request
+  end
+
+  def self.search band_name
+    request.search(band_name)
+  end
+
+  def self.resolve
+    request
+  end
+
+  private
+
+  def self.request
+    Getter.new(Request.new config.api_key)
+  end
+
+end
+

data/lib/bandcamp_api.rb

@@ -0,0 +1 @@
+require_relative './bandcamp'

data/spec/album_spec.rb

@@ -0,0 +1,16 @@
+require 'bandcamp/album'
+
+module Bandcamp
+  describe Album do
+    describe ".new" do
+
+      it "accepts a hash and returns an Album" do
+        expect(Album.new(foo: "bar")).to be_an Album
+      end
+
+      it "creates methods based on the hash" do
+        expect(Album.new(foo: "bar").foo).to eq "bar"
+      end
+    end
+  end
+end

data/spec/band_spec.rb

@@ -0,0 +1,22 @@
+require 'bandcamp/band'
+
+module Bandcamp
+  describe Band do
+    let(:band){Band.new(foo: "bar") }
+
+    it "mixes in Methodical" do
+      # passing in true here because to_methods is private
+      expect(band.respond_to?(:to_methods, true)).to be true
+    end
+
+    describe ".new" do
+      it "accepts a hash and returns a Band" do
+        expect(band).to be_a Band
+      end
+      it "creates methods based on the hash" do
+        expect(band.foo).to eq "bar"
+      end
+    end
+
+  end
+end

data/spec/bandcamp_spec.rb

@@ -0,0 +1,42 @@
+require 'spec_helper'
+require 'bandcamp/band'
+require 'bandcamp'
+
+describe Bandcamp do
+
+  let(:getter) do
+    Class.new do
+      def search name
+        [Bandcamp::Band.new(foo: "bar"), Bandcamp::Band.new(fizz: "buzz")]
+      end
+    end.new
+  end
+
+  before(:each) { Bandcamp.config.api_key = "abc123" }
+
+  describe ".config" do
+    it 'returns a configuration object' do
+      expect(Bandcamp.config).to be_a (Bandcamp::Configuration)
+    end
+  end
+
+  describe ".get" do
+    it "returns an object for making requests" do
+      expect(Bandcamp.get).to be_a Bandcamp::Getter
+    end
+  end
+
+  describe ".search" do
+    it "accepts a band name to search for" do
+      Bandcamp.stub(:request).and_return(getter)
+      expect(Bandcamp.search "pitch black").to have(2).bands
+    end
+  end
+
+  describe ".resolve" do
+    it "returns an object for making requests" do
+      expect(Bandcamp.get).to be_a Bandcamp::Getter
+    end
+  end
+
+end

data/spec/configuration_spec.rb

@@ -0,0 +1,23 @@
+require 'bandcamp/configuration'
+
+module Bandcamp
+  describe Configuration do
+
+    describe "#api_key" do
+
+      let(:config){ Configuration.new }
+
+      it "returns the key" do
+        config.api_key = "abc123"
+        expect(config.api_key).to eq "abc123"
+      end
+
+      context "when there is no key" do
+        it "raises an error" do
+          expect{ config.api_key }.to raise_error ConfigurationError
+        end
+      end
+
+    end
+  end
+end

data/spec/fixtures/a_new_day.json

@@ -0,0 +1 @@
+{"duration":713.4,"track_id":1784614291,"url":"/track/a-new-day-pitch-black-remix","lyrics":null,"large_art_url":"http://f0.bcbits.com/z/97/13/971382268-1.jpg","streaming_url":"http://popplers5.bandcamp.com/download/track?enc=mp3-128&fsig=af9ba8557731f9fef8cfea9d421b335d&id=1784614291&stream=1&ts=1357664814.0","title":"A New Day (Pitch Black Remix)","about":null,"album_id":405027664,"band_id":950934886,"credits":"Laya Project\r\n2010\r\nFirst released on \"A New Day - Laya Project Remixed\" (EarthSync)\r\nOriginal written by Patric Sebag + Yotam Agam\r\nPublished by EarthSync\r\nKindly licensed from EarthSync\r\nlayaproject.com","number":9,"small_art_url":"http://f0.bcbits.com/z/40/85/4085860-1.jpg","downloadable":2}

data/spec/fixtures/pitch_black_band.json

@@ -0,0 +1 @@
+{"url":"http://pitchblack.bandcamp.com","name":"Pitch Black","offsite_url":"http://www.pitchblack.co.nz","subdomain":"pitchblack","band_id":950934886}

data/spec/fixtures/pitch_black_discography.json

@@ -0,0 +1 @@
+{"discography":[{"small_art_url":"http://f0.bcbits.com/z/14/53/1453962800-1.jpg","release_date":1264377600,"artist":"Pitch Black","downloadable":2,"url":"http://pitchblack.bandcamp.com/album/harmonia-pt-i-ep?pk=284","large_art_url":"http://f0.bcbits.com/z/16/25/1625598935-1.jpg","title":"Harmonia Pt.I EP","album_id":123407739,"band_id":950934886},{"small_art_url":"http://f0.bcbits.com/z/38/78/3878854390-1.jpg","release_date":1307923200,"artist":"Pitch Black","downloadable":2,"url":"http://pitchblack.bandcamp.com/album/remixes-rarities?pk=284","large_art_url":"http://f0.bcbits.com/z/16/23/162338784-1.jpg","title":"Remixes & Rarities","album_id":405027664,"band_id":950934886},{"small_art_url":"http://f0.bcbits.com/z/32/90/3290360840-1.jpg","release_date":1220227200,"artist":"Pitch Black","downloadable":2,"url":"http://pitchblack.bandcamp.com/album/1000-mile-drift-ep?pk=284","large_art_url":"http://f0.bcbits.com/z/42/61/4261151524-1.jpg","title":"1000 Mile Drift EP","album_id":987436653,"band_id":950934886},{"small_art_url":"http://f0.bcbits.com/z/13/48/134898433-1.jpg","release_date":946684800,"artist":"Pitch Black","downloadable":2,"url":"http://pitchblack.bandcamp.com/album/futureproof?pk=284","large_art_url":"http://f0.bcbits.com/z/29/12/2912181120-1.jpg","title":"Futureproof","album_id":1482002482,"band_id":950934886},{"small_art_url":"http://f0.bcbits.com/z/64/73/647374015-1.jpg","release_date":991353600,"artist":"Pitch Black","downloadable":2,"url":"http://pitchblack.bandcamp.com/album/electronomicon?pk=284","large_art_url":"http://f0.bcbits.com/z/25/13/2513680008-1.jpg","title":"Electronomicon","album_id":1587432954,"band_id":950934886},{"small_art_url":"http://f0.bcbits.com/z/16/88/1688533909-1.jpg","release_date":1188604800,"artist":"Pitch Black","downloadable":2,"url":"http://pitchblack.bandcamp.com/album/rude-mechanicals?pk=284","large_art_url":"http://f0.bcbits.com/z/25/63/256363587-1.jpg","title":"Rude Mechanicals","album_id":2119881068,"band_id":950934886},{"small_art_url":"http://f0.bcbits.com/z/13/32/1332099373-1.jpg","release_date":1149120000,"artist":"Pitch Black","downloadable":2,"url":"http://pitchblack.bandcamp.com/album/empty-spaces-random-units-ep?pk=284","large_art_url":"http://f0.bcbits.com/z/25/03/2503075126-1.jpg","title":"Empty Spaces, Random Units EP","album_id":2153042914,"band_id":950934886},{"small_art_url":"http://f0.bcbits.com/z/37/52/3752290706-1.jpg","release_date":1230768000,"artist":"Pitch Black","downloadable":2,"url":"http://pitchblack.bandcamp.com/album/bird-soul-ep?pk=284","large_art_url":"http://f0.bcbits.com/z/22/22/2222550128-1.jpg","title":"Bird Soul EP","album_id":2831814628,"band_id":950934886},{"small_art_url":"http://f0.bcbits.com/z/38/42/3842813731-1.jpg","release_date":1149033600,"artist":"Pitch Black","downloadable":2,"url":"http://pitchblack.bandcamp.com/album/lost-in-trancelation-ep?pk=284","large_art_url":"http://f0.bcbits.com/z/40/75/4075125765-1.jpg","title":"Lost in Trancelation EP","album_id":2844989968,"band_id":950934886},{"small_art_url":"http://f0.bcbits.com/z/16/46/1646703290-1.jpg","release_date":1228089600,"artist":"Pitch Black","downloadable":2,"url":"http://pitchblack.bandcamp.com/album/rude-mechanicals-ep?pk=284","large_art_url":"http://f0.bcbits.com/z/17/97/1797970339-1.jpg","title":"Rude Mechanicals EP","album_id":2898119910,"band_id":950934886},{"small_art_url":"http://f0.bcbits.com/z/21/22/2122942497-1.jpg","release_date":1086048000,"artist":"Pitch Black","downloadable":2,"url":"http://pitchblack.bandcamp.com/album/ape-to-angel?pk=284","large_art_url":"http://f0.bcbits.com/z/96/40/96409743-1.jpg","title":"Ape to Angel","album_id":2909726980,"band_id":950934886},{"small_art_url":"http://f0.bcbits.com/z/36/68/3668138914-1.jpg","release_date":1264377600,"artist":"Pitch Black","downloadable":2,"url":"http://pitchblack.bandcamp.com/album/harmonia-pt-ii-ep?pk=284","large_art_url":"http://f0.bcbits.com/z/23/15/231526816-1.jpg","title":"Harmonia Pt.II EP","album_id":3220776887,"band_id":950934886},{"small_art_url":"http://f0.bcbits.com/z/29/23/2923271411-1.jpg","release_date":1241136000,"artist":"Pitch Black","downloadable":2,"url":"http://pitchblack.bandcamp.com/album/rhythm-sound-movement?pk=284","large_art_url":"http://f0.bcbits.com/z/28/52/2852686826-1.jpg","title":"Rhythm, Sound & Movement","album_id":4038639624,"band_id":950934886},{"small_art_url":"http://f0.bcbits.com/z/15/93/1593128441-1.jpg","release_date":1117584000,"artist":"Pitch Black","downloadable":2,"url":"http://pitchblack.bandcamp.com/album/flex-ep?pk=284","large_art_url":"http://f0.bcbits.com/z/24/65/246552663-1.jpg","title":"Flex EP","album_id":4040205273,"band_id":950934886},{"small_art_url":"http://f0.bcbits.com/z/37/15/3715147005-1.jpg","release_date":1117584000,"artist":"Pitch Black","downloadable":2,"url":"http://pitchblack.bandcamp.com/album/frequencies-fall?pk=284","large_art_url":"http://f0.bcbits.com/z/28/19/2819545390-1.jpg","title":"Frequencies Fall","album_id":4049890507,"band_id":950934886},{"small_art_url":"http://f0.bcbits.com/z/18/96/1896650809-1.jpg","release_date":1287532800,"artist":"Pitch Black","downloadable":1,"url":"http://pitchblack.bandcamp.com/album/live?pk=284","large_art_url":"http://f0.bcbits.com/z/20/80/2080879111-1.jpg","title":"Live","album_id":4079738343,"band_id":950934886}]}

data/spec/fixtures/remixes_and_rarities_album.json

@@ -0,0 +1 @@
+{"credits":"Album Credits\r\n\r\n1. Te Po (Pitch Black Remix)\r\nHirini Melbourne and Richard Nunns \r\n2006\r\nFirst released on \"Te Whaiao: Te Ku Te Whe Remixed\"\r\nOriginal written by Hirini Melbourne and Richard Nunns \r\nPublished by Rattle Records\r\nKindly licensed from Rattle Records\r\nrattlerecords.net\r\n\r\n2. Kaikoura Dub (Original Demo)\r\nPitch Black\r\n2002\r\nUnreleased track that was featured in the film \"Whale Rider\"\r\nWritten and produced by Paddy Free and Michael Hodgson\r\nPublished by Native Tongue Music Publishing\r\nwhaleriderthemovie.co.nz\r\n\r\n3. House Of The Rising Dub (Pitch Black Remix)\r\nInternational Observer\r\n2009\r\nOriginal track written and produced by Tom Bailey\r\nPublished by Copyright Control/Native Tongue Music Publishing\r\nKindly licensed from Dubmission Records\r\nfacebook.com/internationalobserver\r\n\r\n4. For The Love Of It (Pitch Black Version) \r\nSalmonella Dub\r\n1999\r\nOriginal track written by Salmonella Dub\r\nPublished by Mushroom Music Publishing\r\nKindly licensed from Salmonella Dub \r\nsalmonelladub.com\r\n\r\n5. The Opaque (Pitch Black Remix)\r\nTom Cosm\r\n2011\r\nOriginal track written and produced by Tom Cosm\r\nPublished by Copyright Control\r\ncosm.co.nz\r\n\r\n6. Sensimillia (Pitch Black's Sensi Dub)\r\nKatchafire\r\n2006\r\nFirst released on \"Homegrown Dub\" (Mai Music)\r\nOrginal track written by Logan Bell, Jordan Bell, Jaimey Ferguson, Ara Adams-Tamatea and T Hohepa\r\nPublished by Local Music/Mushroom Music\r\nKindly licensed from Local Music\r\nkatchafire.co.nz\r\n\r\n7. I'm a Wanderer\r\nPitch Black\r\n1997\r\nThis is the first track we wrote together.\r\nOriginally released on the Curious Records compilation \"On the beat'n'track\"\r\nWritten and produced by Paddy Free and Michael Hodgson\r\nPublished by Native Tongue Music Publishing\r\n\r\n8. Mirror Beach (Pitch Black's Iron Sands Re-rub) \r\nMirror System\r\n2006\r\nOriginal written and produced by Steve Hillage, Miquette Giraudy and Mark Neal\r\nPublished by Stage Three Music/Copyright Control.\r\nKindly used by permission of Mirror System / A-Wave Records.\r\na-wave.com\r\n\r\n9. A New Day (Pitch Black Remix)\r\nLaya Project\r\n2010\r\nFirst released on \"A New Day - Laya Project Remixed\" (EarthSync)\r\nOriginal written by Patric Sebag + Yotam Agam\r\nPublished by EarthSync\r\nKindly licensed from EarthSync\r\nlayaproject.com\r\n\r\n10. Protect the Grain\r\nPitch Black\r\n2003\r\nFirst released on the limited edition \"Flex\" EP, created for our European excursion of 2003\r\nWritten and produced by Paddy Free and Michael Hodgson\r\nPublished by Native Tongue Music Publishing\r\n\r\n11. Past Present Future (Pitch Black's Sleep Whisperer Remix)\r\nTiki\r\n2009\r\nFirst released on \"Flux\" (TikiDub)\r\nOriginal written by Tiki and Inuwai Taanetinorau\r\nPublished by Tikidub Production\r\nKindly licensed from Tikidub Productions\r\ntikidub.com\r\n\r\n12. Disarray (Pitch Black's +13db@50Hz Remix)\r\nAcross Digital\r\n2011\r\nOriginal written by Rogerio Romao and Marcus Vandell \r\nacrossdigital.com\r\n\r\n13. For Your Digitalize Only ( Pitch Black Remix ) \r\nZen Lemonade\r\n2009 \r\nOriginal Written by Gus Till and Supercozi ( a.k.a Cozi Till Yukimi Yonezawa )\r\nPublished by Electronic Soundscapes \r\nKindly licensed from Electronic Soundscapes \r\nmyspace.com/zenlemonade\r\n\r\nDelf Movie\r\n1997\r\nWritten and directed by James Cunningham\r\nProduced by Paul Swadel\r\nMusic by Pitch Black\r\nnzfilm.co.nz\r\n\r\nArtwork by Nick Caro dub_badger@yahoo.co.uk\r\nMastering by Angus McNaughton @ Auralux Mastering","downloadable":2,"release_date":1307923200,"tracks":[{"credits":"Hirini Melbourne and Richard Nunns \r\n2006\r\nFirst released on \"Te Whaiao: Te Ku Te Whe Remixed\"\r\nOriginal written by Hirini Melbourne and Richard Nunns \r\nPublished by Rattle Records\r\nKindly licensed from Rattle Records\r\nrattlerecords.net","number":1,"streaming_url":"http://popplers5.bandcamp.com/download/track?enc=mp3-128&fsig=2868d777e70ccf799d1ea4ed8b72454c&id=2164488036&pk=284&stream=1&ts=1357780433.0","downloadable":2,"artist":"Richard Nunns & Hirini Melbourne","album_id":405027664,"large_art_url":"http://f0.bcbits.com/z/26/86/2686072554-1.jpg","duration":307.147,"url":"/track/te-po-pitch-black-remix?pk=284","track_id":2164488036,"title":"Te Po (Pitch Black Remix)","band_id":950934886,"small_art_url":"http://f0.bcbits.com/z/17/65/1765257345-1.jpg"},{"credits":"Pitch Black\r\n2002\r\nUnreleased track that was featured in the film \"Whale Rider\"\r\nWritten and produced by Paddy Free and Michael Hodgson\r\nPublished by Native Tongue Music Publishing\r\nwhaleriderthemovie.co.nz","number":2,"streaming_url":"http://popplers5.bandcamp.com/download/track?enc=mp3-128&fsig=8b80d2e659794deaafab782a728e98c7&id=1869822966&pk=284&stream=1&ts=1357780433.0","downloadable":2,"album_id":405027664,"large_art_url":"http://f0.bcbits.com/z/50/77/507764963-1.jpg","duration":488.6,"url":"/track/kaikoura-dub?pk=284","track_id":1869822966,"title":"Kaikoura Dub","band_id":950934886,"small_art_url":"http://f0.bcbits.com/z/18/89/1889845170-1.jpg"},{"credits":"International Observer\r\n2009\r\nOriginal track written and produced by Tom Bailey\r\nPublished by Copyright Control/Native Tongue Music Publishing\r\nKindly licensed from Dubmission Records\r\nfacebook.com/internationalobserver","number":3,"streaming_url":"http://popplers5.bandcamp.com/download/track?enc=mp3-128&fsig=cfee3d69e10a36c24a6c0627cd9328b8&id=701130188&pk=284&stream=1&ts=1357780433.0","downloadable":2,"artist":"International Observer","album_id":405027664,"large_art_url":"http://f0.bcbits.com/z/32/99/3299308193-1.jpg","duration":378.067,"url":"/track/house-of-the-rising-dub-pitch-black-remix?pk=284","track_id":701130188,"title":"House of the Rising Dub (Pitch Black Remix)","band_id":950934886,"small_art_url":"http://f0.bcbits.com/z/23/67/2367062797-1.jpg"},{"credits":"Salmonella Dub\r\n1999\r\nOriginal track written by Salmonella Dub\r\nPublished by Mushroom Music Publishing\r\nKindly licensed from Salmonella Dub \r\nsalmonelladub.com","number":4,"streaming_url":"http://popplers5.bandcamp.com/download/track?enc=mp3-128&fsig=a755646599f41b5d4b946aa28d63a1f3&id=1322997180&pk=284&stream=1&ts=1357780433.0","downloadable":2,"artist":"Salmonella Dub","album_id":405027664,"large_art_url":"http://f0.bcbits.com/z/17/06/1706364830-1.jpg","duration":364.693,"url":"/track/for-the-love-of-it-pitch-black-version?pk=284","track_id":1322997180,"title":"For the Love of It (Pitch Black Version)","band_id":950934886,"small_art_url":"http://f0.bcbits.com/z/12/05/1205071245-1.jpg"},{"credits":"Tom Cosm\r\n2011\r\nOriginal track written and produced by Tom Cosm\r\nPublished by Copyright Control\r\ncosm.co.nz","number":5,"streaming_url":"http://popplers5.bandcamp.com/download/track?enc=mp3-128&fsig=334c324361b20294053f27bb0cc4018c&id=3800662209&pk=284&stream=1&ts=1357780433.0","downloadable":2,"artist":"Tom Cosm","album_id":405027664,"large_art_url":"http://f0.bcbits.com/z/36/99/3699358562-1.jpg","duration":446.933,"url":"/track/the-opaque-pitch-black-remix?pk=284","track_id":3800662209,"title":"The Opaque (Pitch Black Remix)","band_id":950934886,"small_art_url":"http://f0.bcbits.com/z/17/00/1700900588-1.jpg"},{"credits":"Katchafire\r\n2006\r\nFirst released on \"Homegrown Dub\" (Mai Music)\r\nOrginal track written by Logan Bell, Jordan Bell, Jaimey Ferguson, Ara Adams-Tamatea and T Hohepa\r\nPublished by Local Music/Mushroom Music\r\nKindly licensed from Local Music\r\nkatchafire.co.nz","number":6,"streaming_url":"http://popplers5.bandcamp.com/download/track?enc=mp3-128&fsig=ee87f2604c9a2f8a136be8902242bc8b&id=2747346544&pk=284&stream=1&ts=1357780433.0","downloadable":2,"artist":"Katchafire","album_id":405027664,"large_art_url":"http://f0.bcbits.com/z/30/39/3039059315-1.jpg","duration":243.227,"url":"/track/sensimillia-pitch-blacks-sensi-dub?pk=284","track_id":2747346544,"title":"Sensimillia (Pitch Black's Sensi Dub)","band_id":950934886,"small_art_url":"http://f0.bcbits.com/z/34/85/3485112879-1.jpg"},{"credits":"Pitch Black\r\n1997\r\nThis is the first track we wrote together.\r\nOriginally released on the Curious Records compilation \"On the beat'n'track\"\r\nWritten and produced by Paddy Free and Michael Hodgson\r\nPublished by Native Tongue Music Publishing","number":7,"streaming_url":"http://popplers5.bandcamp.com/download/track?enc=mp3-128&fsig=61e20aa7e4bab6c114f4ba96df19f4de&id=3918113496&pk=284&stream=1&ts=1357780433.0","downloadable":2,"album_id":405027664,"large_art_url":"http://f0.bcbits.com/z/15/18/1518822875-1.jpg","duration":364.12,"url":"/track/im-a-wanderer?pk=284","track_id":3918113496,"title":"I'm a Wanderer","band_id":950934886,"small_art_url":"http://f0.bcbits.com/z/14/62/1462051298-1.jpg"},{"credits":"Mirror System\r\n2006\r\nOriginal written and produced by Steve Hillage, Miquette Giraudy and Mark Neal\r\nPublished by Stage Three Music/Copyright Control.\r\nKindly used by permission of Mirror System / A-Wave Records.\r\na-wave.com","number":8,"streaming_url":"http://popplers5.bandcamp.com/download/track?enc=mp3-128&fsig=1b34b0b12382a607a74a17aee90acaaa&id=298836508&pk=284&stream=1&ts=1357780433.0","downloadable":2,"artist":"Mirror System","album_id":405027664,"large_art_url":"http://f0.bcbits.com/z/87/92/879298162-1.jpg","duration":485.0,"url":"/track/mirror-beach-pitch-blacks-iron-sands-re-rub?pk=284","track_id":298836508,"title":"Mirror Beach (Pitch Black's Iron Sands Re-rub)","band_id":950934886,"small_art_url":"http://f0.bcbits.com/z/27/42/2742882489-1.jpg"},{"credits":"Laya Project\r\n2010\r\nFirst released on \"A New Day - Laya Project Remixed\" (EarthSync)\r\nOriginal written by Patric Sebag + Yotam Agam\r\nPublished by EarthSync\r\nKindly licensed from EarthSync\r\nlayaproject.com","number":9,"streaming_url":"http://popplers5.bandcamp.com/download/track?enc=mp3-128&fsig=1b2d8bcc026ac92187e1c8db0c8b616d&id=1784614291&pk=284&stream=1&ts=1357780433.0","downloadable":2,"artist":"Laya Project","album_id":405027664,"large_art_url":"http://f0.bcbits.com/z/23/52/2352771728-1.jpg","duration":713.4,"url":"/track/a-new-day-pitch-black-remix?pk=284","track_id":1784614291,"title":"A New Day (Pitch Black Remix)","band_id":950934886,"small_art_url":"http://f0.bcbits.com/z/40/85/4085860-1.jpg"},{"credits":"Pitch Black\r\n2003\r\nFirst released on the limited edition \"Flex\" EP, created for our European excursion of 2003\r\nWritten and produced by Paddy Free and Michael Hodgson\r\nPublished by Native Tongue Music Publishing","number":10,"streaming_url":"http://popplers5.bandcamp.com/download/track?enc=mp3-128&fsig=6119547a154586894213322df46d1ca0&id=3919458311&pk=284&stream=1&ts=1357780433.0","downloadable":2,"album_id":405027664,"large_art_url":"http://f0.bcbits.com/z/35/58/3558585391-1.jpg","duration":216.387,"url":"/track/protect-the-grain-2?pk=284","track_id":3919458311,"title":"Protect the Grain","band_id":950934886,"small_art_url":"http://f0.bcbits.com/z/79/14/791476813-1.jpg"},{"credits":"Tiki\r\n2009\r\nFirst released on \"Flux\" (TikiDub)\r\nOriginal written by Tiki and Inuwai Taanetinorau\r\nPublished by Tikidub Production\r\nKindly licensed from Tikidub Productions\r\ntikidub.com","number":11,"streaming_url":"http://popplers5.bandcamp.com/download/track?enc=mp3-128&fsig=7809ef04a78a08dbb23caed6cda2a849&id=122004781&pk=284&stream=1&ts=1357780433.0","downloadable":2,"artist":"Tiki","album_id":405027664,"large_art_url":"http://f0.bcbits.com/z/16/72/1672923578-1.jpg","duration":377.2,"url":"/track/past-present-future-pitch-blacks-sleep-whisperer-mix?pk=284","track_id":122004781,"title":"Past Present Future (Pitch Black's Sleep Whisperer Mix)","band_id":950934886,"small_art_url":"http://f0.bcbits.com/z/22/22/2222529058-1.jpg"},{"number":12,"streaming_url":"http://popplers5.bandcamp.com/download/track?enc=mp3-128&fsig=5237d1ef1ab87cae5a87ec8bc9cfc946&id=1821566106&pk=284&stream=1&ts=1357780433.0","artist":"Across Digital","album_id":405027664,"duration":473.836,"url":"/track/disarray-pitch-blacks-13db-50hz-remix?pk=284","track_id":1821566106,"title":"Disarray (Pitch Black's +13db@50Hz Remix)","band_id":950934886},{"number":13,"streaming_url":"http://popplers5.bandcamp.com/download/track?enc=mp3-128&fsig=29e25af0df2cffbac79038204d07c96e&id=3372180985&pk=284&stream=1&ts=1357780433.0","artist":"Zen Lemonade","album_id":405027664,"duration":339.614,"url":"/track/for-your-digitalize-only-pitch-black-remix?pk=284","track_id":3372180985,"title":"For Your Digitalize Only ( Pitch Black Remix )","about":"For Your Digitalize Only ( Pitch Black Remix ) \r\nZen Lemonade\r\n2009\r\nOriginal Written by Gus Till and Supercozi ( a.k.a Cozi Till Yukimi Yonezawa )\r\nPublished by Electronic Soundscapes \r\nKindly licensed from Electronic Soundscapes \r\nwww.myspace.com/zenlemonade","band_id":950934886}],"large_art_url":"http://f0.bcbits.com/z/16/23/162338784-1.jpg","album_id":405027664,"url":"http://pitchblack.bandcamp.com/album/remixes-rarities?pk=284","title":"Remixes & Rarities","about":"Remixes and Rarities – the latest album from Auckland’s Pitch Black – is a package of rare tracks and lovingly crafted remixes of other artists’ music, chosen by Paddy Free and Mike Hodgson to represent their fifteen year reign as Aotearoa’s favourite electronica act.\r\n\r\nKnown globally for their stomping, genre defying live sets, Remixes and Rarities showcases Pitch Black’s mellower side, the one that also makes them favourites in the living room. The album begins with the call of the kōauau (Māori flute), the intro to a dancefloor friendly, but respectful reworking of the Richard Nunns and Hirini Melbourne original, ‘Te Po’ and ends with an equally haunting version of Tiki’s ‘Past Present Future’. Bookended by these distinctively local soundscapes, Remixes and Rarities represents the past, present and future of the Pitch Black partnership.\r\n\r\nIncluded in the remixes are tracks by fellow Aotearoa/NZ dub trailblazers International Observer (‘House of the Rising Dub’) and Salmonella Dub (‘For the Love of It’), along with ‘The Opaque’ by independent music producer Tom Cosm, and ‘Sensimillia’ by reggae legends Katchafire – all fed through the PB warping machine. Representing from further a field is ‘Mirror Beach’ by Mirror System (the ambient project of Britain’s System 7), and ‘A New Day’, a remix of a Sri Lankan track that Pitch Black remixed for the Laya Project, a collaboration of regional folk musicians affected by the 2004 tsunami.\r\n\r\nFor Mike, the remix process is a chance to share creativity: “We love getting other artists to remix our tunes and we really enjoy remixing others’ music. It gives us a chance to play with different types of sounds and composing techniques. I love getting the parts of these songs and creating a folder of sounds in response to the track. This quite often gives us the sound field and sonic vibe for the remix.”\r\n\r\nWhilst all of Pitch Black’s four studio albums have been followed by a compilation of versions by local and international artists, this is the first to showcase their own remixing output, and Mike and Paddy enjoyed the process of going back over all the old dats.\r\n\r\n“From 1996 to 2011 we have had many chances to remix other artists’ songs, and these have been released on a variety of albums and compilations around the world – this Pitch Black release gives us a chance to put them all in one place. It contains tracks from the very beginning of us working together right up to a track finished earlier this year,” says Paddy.\r\n\r\nIncluded on the album are three Pitch Black originals that were either never released or were on compilations or short limited runs. Purists will love the inclusion of 1996’s ‘I’m a Wanderer’, the first track the pair worked on together.\r\n\r\n“I had a long drums and effects jam that I wanted to turn into a song and Paddy was keen to work together so we took this long evolving track and chopped it up into a structure and then added Paddy’s vibe to it,” remembers Mike. “Pitch Black was born.”\r\n\r\n‘I’m a Wanderer’ showcases the industrial beginnings of what would become the Pitch Black sound – a dynamic balancing act between heavily sculpted basslines and choppy melody that has been acknowledged by many as an evocative soundtrack to the Aotearoa landscape. In contrast, the pastoral ‘Protect the Grain’, a windborne ambient track released on the limited edition EP Flex around the time of widespread anti-GE demonstrations, represents Pitch Black at their gentlest.\r\n\r\nAlso included is ‘Kaikoura Dub’, a previously unreleased track from which a snippet was used on Whalerider to accompany Paikea’s journey away from her village, during the scene when she heard the whales calling her home.\r\n\r\nMike explains how the collaboration came about: “In 2000 I bumped into Niki Caro and she asked if we had any tunes lying around that she could use for Whalerider. We had just come back from a session in Kaikoura where we had jammed a new track into a long 23min mix. I put that on CD for her and she ended up choosing a sliver for the film. We subsequently used the bones of this track for the tune ‘Elements Turn’ on Ape to Angel but it’s great to find the original two track recording and release it.”\r\n\r\nPitch Black have always been more than a dance act, but on Remixes and Rarities they demonstrate the full reach of the musical territory they love to explore.","band_id":950934886,"small_art_url":"http://f0.bcbits.com/z/38/78/3878854390-1.jpg"}

data/spec/fixtures/search.json

@@ -0,0 +1 @@
+{"results":[{"url":"http://pitchblackk.bandcamp.com","subdomain":"pitchblackk","name":"Pitch Black","band_id":12800984,"offsite_url":null},{"url":"http://pitchblackattack.bandcamp.com","subdomain":"pitchblackattack","name":"Pitch Black","band_id":168853150,"offsite_url":"http://www.pitch-black.us"},{"url":"http://pitchblack1.bandcamp.com","subdomain":"pitchblack1","name":"Pitch Black","band_id":181856001,"offsite_url":null},{"url":"http://pitchblack.bandcamp.com","subdomain":"pitchblack","name":"Pitch Black","band_id":950934886,"offsite_url":"http://www.pitchblack.co.nz"},{"url":"http://pitchblack5.bandcamp.com","subdomain":"pitchblack5","name":"PITCH BLACK","band_id":2607764567,"offsite_url":null}]}

data/spec/fixtures/search_no_results.json

@@ -0,0 +1 @@
+{"results":[]}

data/spec/fixtures/tracks.json

@@ -0,0 +1 @@
+{"1735088360":{"number":1,"lyrics":null,"streaming_url":"http://popplers5.bandcamp.com/download/track?enc=mp3-128&fsig=668fdf0d155050f14b3e9193f55cd6e1&id=1735088360&stream=1&ts=1358548398.0","duration":512.779,"track_id":1735088360,"url":"/track/evolution-1-1","large_art_url":null,"title":"Evolution 1:1","small_art_url":null,"about":null,"album_id":171685143,"band_id":1908050684,"downloadable":2,"credits":"(C) & (P) 2012 Ultimae"},"1739611553":{"number":2,"lyrics":null,"streaming_url":"http://popplers5.bandcamp.com/download/track?enc=mp3-128&fsig=c5981223e0c6e724f8c051405ee09dbf&id=1739611553&stream=1&ts=1358548398.0","duration":440.0,"track_id":1739611553,"url":"/track/emoxygen","large_art_url":null,"title":"Emoxygen","small_art_url":null,"about":null,"album_id":165628809,"band_id":1589471525,"downloadable":2,"credits":null}}

data/spec/fixtures/unknown_band.json

@@ -0,0 +1 @@
+{"error":true,"error_message":"unknown band"}

data/spec/fixtures/unknown_band_discography.json

@@ -0,0 +1 @@
+{"discography":[]}

data/spec/fixtures/unknown_url.json

@@ -0,0 +1 @@
+{"error":true,"error_message":"unknown url"}

data/spec/fixtures/url.json

@@ -0,0 +1 @@
+{"band_id":950934886}

data/spec/getter_spec.rb

@@ -0,0 +1,165 @@
+require 'bandcamp/getter'
+require 'bandcamp/request'
+require 'bandcamp/track'
+require 'bandcamp/album'
+
+module Bandcamp
+  describe Getter do
+
+    let(:request) do
+      Class.new do
+
+        def track id
+          case
+          when id.to_s.include?("1111")
+            nil
+          when id.to_s.include?(',')
+            json = File.read(File.join %w(spec fixtures tracks.json))
+            MultiJson.decode json
+          else
+            json = File.read(File.join %w(spec fixtures a_new_day.json))
+            MultiJson.decode json
+          end
+        end
+
+        def band name
+          return nil if name == 111111
+          json = File.read(File.join %w(spec fixtures pitch_black_band.json))
+          MultiJson.decode json
+        end
+
+        def album id
+          return nil if id == 1111
+          json = File.read(File.join %w(spec fixtures remixes_and_rarities_album.json))
+          MultiJson.decode json
+        end
+
+        def search name
+          return nil if name == "Foo and the Bars"
+          json = File.read(File.join %w(spec fixtures search.json))
+          MultiJson.decode(json)["results"]
+        end
+
+        def url bandcamp_url
+          case bandcamp_url
+          when "http://pitchblack.bandcamp.com/"
+            {"band_id"=>950934886}
+          when "http://pitchblack.bandcamp.com/track/a-new-day-pitch-black-remix"
+            {"band_id" => 950934886,"track_id" => 1784614291}
+          when "http://interchill.bandcamp.com/album/power-salad"
+            {"band_id"=>1589471525, "album_id"=>165628809}
+          else
+            nil
+          end
+
+        end
+
+      end.new
+
+    end
+
+    let(:getter){ Getter.new request }
+
+    describe ".new" do
+      it "takes a request object" do
+        expect(Getter.new(request)).to be_a Getter
+      end
+    end
+
+    describe "#track" do
+      context "when passed a track id" do
+        it "returns a Track" do
+          expect(getter.track(1784614291)).to be_a Track
+        end
+
+        it "returns nil if nothing is found" do
+          expect(getter.track 1111).to be_nil
+        end
+      end
+    end
+
+    describe "#album" do
+      context "when the album exists" do
+        it "returns an album" do
+          expect(getter.album(405027664)).to be_an Album
+        end
+      end
+
+      context "when the album does not exist" do
+        it "returns nil" do
+          expect(getter.album(1111)).to be_nil
+        end
+      end
+
+    end
+
+    describe "#tracks" do
+      context "when given an array of track ids" do
+        it "returns an array of tracks" do
+          expect(getter.tracks 1735088360, 1739611553).to have(2).tracks
+        end
+      end
+
+      context "when no tracks are found" do
+        it "returns an empty array" do
+          expect(getter.tracks(1111,1111)).to eq []
+        end
+      end
+    end
+
+    describe "#search" do
+      context "when given a band name" do
+        it "returns an array of Band objects" do
+          expect(getter.search "pitch black").to have(5).bands
+        end
+      end
+      context "when no results are found" do
+        it "returns an empty array" do
+          expect(getter.search "Foo and the Bars").to eq []
+        end
+      end
+    end
+
+    describe "#band" do
+      context "when given a band name" do
+        it "returns a Band object" do
+          expect(getter.band(950934886).name).to eq "Pitch Black"
+        end
+      end
+
+      context "when no band is found" do
+        it "returns nil" do
+          expect(getter.band(111111)).to be_nil
+        end
+      end
+    end
+
+    describe "#url" do
+      context "when given a track url" do
+        it "returns a Track" do
+          expect(getter.url "http://pitchblack.bandcamp.com/track/a-new-day-pitch-black-remix" ).to be_a Track
+        end
+      end
+
+      context "when given a band url" do
+        it "returns a band" do
+          expect(getter.url  "http://pitchblack.bandcamp.com/").to be_a Band
+        end
+      end
+
+      context "when given an album url" do
+        it "returns an album" do
+          expect(getter.url "http://interchill.bandcamp.com/album/power-salad").to be_an Album
+        end
+      end
+
+      context "when given a bad url" do
+        it "returns nil" do
+          expect(getter.url 11111).to be_nil
+        end
+      end
+
+    end
+
+  end
+end

data/spec/methodic_spec.rb

@@ -0,0 +1,35 @@
+require 'spec_helper'
+require 'bandcamp/methodical'
+
+module Bandcamp
+
+  describe Methodical do
+
+    let(:klass) do
+      Class.new do
+
+        include Methodical
+
+        def initialize hash
+          to_methods hash
+        end
+
+      end
+    end
+    let(:data){ {foo: "bar"} }
+
+    describe "#to_methods" do
+
+      it "creates instance methods from a hash" do
+        expect(klass.new(data).public_methods).to include(:foo)
+      end
+
+      it "is a private method" do
+        expect(klass.new(data).private_methods).to include(:to_methods)
+      end
+
+    end
+
+  end
+
+end

data/spec/request_spec.rb

@@ -0,0 +1,206 @@
+require File.expand_path('spec_helper', File.dirname(__FILE__))
+require 'bandcamp/request'
+
+module Bandcamp
+  describe Request do
+
+    let(:request){ Request.new "1234" }
+    let(:track_json){ File.read(File.join(%w(spec fixtures a_new_day.json))) }
+    let(:album_json){ File.read(File.join(%w(spec fixtures remixes_and_rarities_album.json))) }
+    let(:band_json){ File.read(File.join(%w(spec fixtures pitch_black_band.json))) }
+    let(:discography_json){ File.read(File.join(%w(spec fixtures pitch_black_discography.json))) }
+    let(:unknown_band_json){ File.read(File.join(%w(spec fixtures unknown_band.json))) }
+    let(:unknown_band_discography_json){ File.read(File.join(%w(spec fixtures unknown_band_discography.json))) }
+    let(:url_json){ File.read(File.join(%w(spec fixtures url.json))) }
+    let(:url_error_json){ File.read(File.join(%w(spec fixtures unknown_url.json))) }
+
+    let(:search_json){ File.read(File.join(%w(spec fixtures search.json))) }
+    let(:no_results_json){ File.read(File.join(%w(spec fixtures search_no_results.json))) }
+
+    describe '#initialize' do
+      it 'sets the base uri' do
+        expect(request.host).to eq "api.bandcamp.com"
+      end
+
+      it "is instantiated with an API key" do
+        r = Request.new "abc123"
+        expect(r.api_key).to eq "abc123"
+      end
+    end
+
+    describe '#uri' do
+      it 'returns the completed uri' do
+        expect(request.uri).to eq 'http://api.bandcamp.com'
+      end
+    end
+
+    describe '#path' do
+      it 'allows setting an arbitrary path' do
+        request.path = '/foo'
+        expect(request.path).to eq "/foo"
+      end
+
+      it 'rejects craziness' do
+        expect {request.path = '@!#%^$+*(&' }.to raise_error(URI::InvalidComponentError)
+      end
+
+    end
+
+    describe '#type' do
+      # types include: band, album, track, discography, url
+      context "when type is discography" do
+        it "sets the path accordingly" do
+          request.type :discography
+          expect(request.path).to eq "/api/band/3/discography"
+        end
+      end
+
+      context "when type is url" do
+        it "sets the path accordingly" do
+          request.type :url
+          expect(request.path).to eq '/api/url/1/info'
+        end
+      end
+
+      it 'raises an error for unrecognized types' do
+        expect{ request.type(:foo) }.to raise_error(UnknownTypeError)
+      end
+
+    end
+
+    describe '#query' do
+      it 'creates a query string from a hash' do
+        Bandcamp.config.api_key = '1234'
+        request.query = {name: "pitch black", album: "ape to angel"}
+        expect(request.query).to eq "key=1234&name=pitch%20black&album=ape%20to%20angel"
+      end
+    end
+
+    it 'builds a uri' do
+      Bandcamp.config.api_key = 1234
+      request.type :track
+      request.query= {track_id: 1784614291}
+      expect(request.uri).to eq "http://api.bandcamp.com/api/track/3/info?key=1234&track_id=1784614291"
+    end
+
+    describe "#track" do
+      it "requests the correct uri" do
+        uri = URI("http://api.bandcamp.com/api/track/3/info?key=1234&track_id=1784614291")
+        request.should_receive(:get).with(uri).and_return(track_json)
+        request.track(1784614291)
+      end
+
+      it "returns a hash of track attributes" do
+        request.stub(:get).and_return(track_json)
+        expect(request.track(1784614291)).to be_a Hash
+      end
+
+      context "when track does not exist" do
+        it "returns nil" do
+          request.stub(:get).and_return("{}")
+          expect(request.track(11111)).to be_nil
+        end
+      end
+
+    end
+
+    describe "#album" do
+      it "requests the correct url" do
+        uri = URI("http://api.bandcamp.com/api/album/2/info?key=1234&album_id=405027664")
+        request.should_receive(:get).with(uri).and_return(album_json)
+        request.album(405027664)
+      end
+
+      it "returns a hash of album attributes" do
+        request.stub(:get).and_return(album_json)
+        expect(request.album(405027664)).to be_a Hash
+      end
+
+      context "when album does not exist" do
+        it "returns nil" do
+          request.stub(:get).and_return("{}")
+          expect(request.album(11111)).to be_nil
+        end
+      end
+    end
+
+    describe "#band" do
+      it "requests the proper uri" do
+        uri = URI("http://api.bandcamp.com/api/band/3/info?key=1234&band_id=950934886")
+        request.should_receive(:get).with(uri).and_return(band_json)
+        request.band(950934886)
+      end
+
+      it "returns a hash of band attributes" do
+        request.stub(:get).and_return(band_json)
+        expect(request.band(950934886)).to be_a Hash
+      end
+
+      it 'returns nil when no band is found' do
+        request.stub(:get).and_return(unknown_band_json)
+        expect(request.band(1234)).to eq nil
+      end
+    end
+
+    describe "#url" do
+      it "returns a hash of ids" do
+        request.stub(:get).and_return(url_json)
+        expect(request.url("pitchblack.bandcamp.com")).to be_a Hash
+      end
+      it "requests the proper uri" do
+        uri = URI("http://api.bandcamp.com/api/url/1/info?key=1234&url=pitchblack.bandcamp.com")
+        request.should_receive(:get).with(uri).and_return(url_json)
+        request.url "pitchblack.bandcamp.com"
+      end
+      it "returns nil for unknown uris" do
+        uri = URI("http://api.bandcamp.com/api/url/1/info?key=1234&url=foo")
+        request.should_receive(:get).with(uri).and_return(url_error_json)
+        expect(request.url "foo").to be_nil
+      end
+    end
+
+    describe "#search" do
+      it "requests the proper uri" do
+        uri = URI("http://api.bandcamp.com/api/band/3/search?key=1234&name=pitch%20black")
+        request.should_receive(:get).with(uri).and_return(search_json)
+        request.search("pitch black")
+      end
+
+      it "returns an array of hashes" do
+        request.stub(:get).and_return(search_json)
+        expect(request.search("pitch black")).to be_an Array
+      end
+
+      it 'returns nil when no results are found' do
+        request.stub(:get).and_return(no_results_json)
+        expect(request.search("foo")).to eq nil
+      end
+    end
+
+    describe "#discography" do
+      it "requests the proper uri" do
+        uri = URI("http://api.bandcamp.com/api/band/3/discography?key=1234&band_id=950934886")
+        request.should_receive(:get).with(uri).and_return(discography_json)
+        request.discography(950934886)
+      end
+
+      it "returns an array of hashes" do
+        request.stub(:get).and_return(discography_json)
+        expect(request.discography(950934886)).to be_an Array
+      end
+
+      it 'returns nil when no discography is found' do
+        request.stub(:get).and_return(unknown_band_discography_json)
+        expect(request.discography(1234)).to eq nil
+      end
+    end
+
+    describe "#dispatch" do
+      it "calls get with a URI object" do
+        request.should_receive(:get).with(kind_of(URI)).and_return(band_json)
+        request.band 950934886
+      end
+    end
+
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1 @@
+$:.unshift(File.expand_path('../lib', File.dirname(__FILE__)))

data/spec/track_spec.rb

@@ -0,0 +1,43 @@
+require 'spec_helper'
+require 'bandcamp/track'
+require 'multi_json'
+
+module Bandcamp
+
+  describe Track do
+
+    it "includes Bandcamp::Methodical" do
+      expect(Track.ancestors).to include(Bandcamp::Methodical)
+    end
+
+    let(:track_json){ MultiJson.decode(File.read(File.join %w(spec fixtures a_new_day.json))) }
+    let(:track){Track.new(track_json)}
+
+    describe "#new" do
+
+      it "is called with a hash" do
+        Track.should_receive(:new).with(instance_of Hash)
+        track
+      end
+
+      it "creates reader methods from keys and values" do
+        expect(track.track_id).to eq 1784614291
+      end
+
+    end
+
+    describe "#paid?" do
+      it "tells you if the track is paid or not" do
+        expect(track.paid?).to eq true
+      end
+    end
+
+    describe "#free?" do
+      it "tells you if the track is free or not" do
+        expect(track.free?).to eq false
+      end
+    end
+
+  end
+
+end

metadata

@@ -0,0 +1,135 @@
+--- !ruby/object:Gem::Specification
+name: bandcamp_api
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Mike Williamson
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-01-25 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: multi_json
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: A helper library for accessing the Bandcamp.com api
+email:
+- blessedbyvirtuosity@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .rspec
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- bandcamp_api.gemspec
+- lib/bandcamp.rb
+- lib/bandcamp/album.rb
+- lib/bandcamp/band.rb
+- lib/bandcamp/configuration.rb
+- lib/bandcamp/getter.rb
+- lib/bandcamp/methodical.rb
+- lib/bandcamp/request.rb
+- lib/bandcamp/track.rb
+- lib/bandcamp/version.rb
+- lib/bandcamp_api.rb
+- spec/album_spec.rb
+- spec/band_spec.rb
+- spec/bandcamp_spec.rb
+- spec/configuration_spec.rb
+- spec/fixtures/a_new_day.json
+- spec/fixtures/pitch_black_band.json
+- spec/fixtures/pitch_black_discography.json
+- spec/fixtures/remixes_and_rarities_album.json
+- spec/fixtures/search.json
+- spec/fixtures/search_no_results.json
+- spec/fixtures/tracks.json
+- spec/fixtures/unknown_band.json
+- spec/fixtures/unknown_band_discography.json
+- spec/fixtures/unknown_url.json
+- spec/fixtures/url.json
+- spec/getter_spec.rb
+- spec/methodic_spec.rb
+- spec/request_spec.rb
+- spec/spec_helper.rb
+- spec/track_spec.rb
+homepage: 
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.24
+signing_key: 
+specification_version: 3
+summary: A library for communicating with the Bandcamp.com api and wrapping the various
+  types of data to make it easier to work with.
+test_files:
+- spec/album_spec.rb
+- spec/band_spec.rb
+- spec/bandcamp_spec.rb
+- spec/configuration_spec.rb
+- spec/fixtures/a_new_day.json
+- spec/fixtures/pitch_black_band.json
+- spec/fixtures/pitch_black_discography.json
+- spec/fixtures/remixes_and_rarities_album.json
+- spec/fixtures/search.json
+- spec/fixtures/search_no_results.json
+- spec/fixtures/tracks.json
+- spec/fixtures/unknown_band.json
+- spec/fixtures/unknown_band_discography.json
+- spec/fixtures/unknown_url.json
+- spec/fixtures/url.json
+- spec/getter_spec.rb
+- spec/methodic_spec.rb
+- spec/request_spec.rb
+- spec/spec_helper.rb
+- spec/track_spec.rb