brainz_releases 0.0.1

data/.gitignore

@@ -0,0 +1,4 @@
+*.gem
+.bundle
+Gemfile.lock
+pkg/*

data/Gemfile

@@ -0,0 +1,3 @@
+source "http://rubygems.org"
+
+gemspec

data/README.rdoc

@@ -0,0 +1,46 @@
+= BrainzReleases
+
+Uses the {MusicBrainz XML Web Service (version 2)}[http://musicbrainz.org/doc/XML_Web_Service/Version_2] to extract the releases for an artist and turn them into nice ruby objects.
+
+{Gem Documentation}[http://rubydoc.info/github/paulsturgess/musicbrainz/master/]
+
+== Usage
+
+Example:
+
+  require 'rubygems'
+  require 'brainz_releases'
+
+  releases = BrainzReleases.search do |search|
+    search.user_agent = "YourAppName/x.x" # Required – A string to identify your requests containing your app name and version number (this is required by the MusicBrainz API)
+    search.mbid = "9f9953f0-68bb-4ce3-aace-2f44c87f0aa3" # MusicBrainz artist ID
+    search.name = "Bonobo" # Only necessary if you don't know the MusicBrainz ID
+    search.start_date = Date.parse("1/1/2011") # Optional – defaults to 1 month ago
+    search.end_date = Date.parse("5/5/2011") # Optional – defaults to 1 month in the future
+  end
+  
+  release = releases.first
+  
+  # A BrainzReleases::Release object has a number of methods to easily access the attributes returned by the MusicBrainz api
+  # For example...
+  release.title            # => "Fi"
+  release.date_available   # => "2005-02-08"
+  release.release_type     # => "Album"
+  release.label            # => "Mush Records"
+  release.format           # => "CD"
+  release.track_count      # => "17"
+  release.country          # => "US"
+  release.mbid             # => "4a46ee61-75b5-4e2b-ac2e-81ef2ccec0f9"
+  release.artist           # => "Bibio"
+  release.artist_mbid      # => "9f9953f0-68bb-4ce3-aace-2f44c87f0aa3"
+
+
+== Warnings
+
+The MusicBrainz Web Service allows only ONE web service request per second. This gem DOES NOT implement any time based delay and takes no responsibility if you abuse the request limit.
+
+{MusicBrainz API documentation}[http://musicbrainz.org/doc/XML_Web_Service/Version_2]
+
+== Installation
+
+  gem install brainz_releases

data/Rakefile

@@ -0,0 +1,2 @@
+require 'bundler'
+Bundler::GemHelper.install_tasks

data/brainz_releases.gemspec

@@ -0,0 +1,25 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "brainz_releases/version"
+
+Gem::Specification.new do |s|
+  s.name        = "brainz_releases"
+  s.version     = BrainzReleases::VERSION
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = ["Paul Sturgess"]
+  s.email       = ["paulsturgess@gmail.com"]
+  s.homepage    = "https://github.com/paulsturgess/brainz_releases"
+  s.summary     = "Provides a ruby inteface for extracting the releases for an artist from MusicBrainz"
+  s.description = "Uses the MusicBrainz XML Web Service (version 2) to extract the releases for an artist and turn them into nice ruby objects."
+
+  s.rubyforge_project = "brainz_releases"
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+
+  s.add_runtime_dependency "nokogiri", "~> 1.4"
+  s.add_development_dependency "rspec", "~> 2.6"
+  s.add_development_dependency "fakeweb", "~> 1.3.0"
+end

data/lib/brainz_releases/release.rb

@@ -0,0 +1,26 @@
+module BrainzReleases
+  class Release
+
+    attr_accessor :mbid, :title, :release_type, :date_available, :artist, :artist_mbid, :label, :track_count, :country, :format
+
+    def initialize(*args, &block)
+      self.instance_eval(&block) if block
+    end
+
+    def self.build_from_node(node)
+      Release.new do |release|
+        release.mbid = node["id"]
+        release.artist = node.xpath("//xmlns:release[@id='#{release.mbid}']/xmlns:artist-credit/xmlns:name-credit/xmlns:artist/xmlns:name").first.content rescue nil
+        release.artist_mbid = node.xpath("//xmlns:release[@id='#{release.mbid}']/xmlns:artist-credit/xmlns:name-credit/xmlns:artist").first['id']
+        release.title = node.xpath("//xmlns:release[@id='#{release.mbid}']/xmlns:title").first.content rescue nil
+        release.release_type = node.xpath("//xmlns:release[@id='#{release.mbid}']/xmlns:release-group").first['type']
+        release.date_available = node.xpath("//xmlns:release[@id='#{release.mbid}']/xmlns:date").first.content rescue nil
+        release.track_count = node.xpath("//xmlns:release[@id='#{release.mbid}']/xmlns:medium-list/xmlns:track-count").first.content rescue nil
+        release.format = node.xpath("//xmlns:release[@id='#{release.mbid}']/xmlns:medium-list/xmlns:medium/xmlns:format").first.content rescue nil
+        release.label = node.xpath("//xmlns:release[@id='#{release.mbid}']/xmlns:label-info-list/xmlns:label-info/xmlns:label/xmlns:name").first.content rescue nil
+        release.country = node.xpath("//xmlns:release[@id='#{release.mbid}']/xmlns:country").first.content rescue nil
+      end
+    end
+
+  end
+end

data/lib/brainz_releases/search.rb

@@ -0,0 +1,73 @@
+require 'nokogiri'
+require 'open-uri'
+require 'net/http'
+require 'CGI'
+require 'Date'
+
+module BrainzReleases
+  class Search
+
+    class Error < StandardError; end
+    class ResponseError < Error; end
+    class ConfigError < Error; end
+    
+    attr_accessor :name, :mbid, :start_date, :end_date, :user_agent
+    
+    def self.search(*args, &block)
+      Search.new(*args, &block).results
+    end
+    
+    def initialize(*args, &block)
+      (block.arity < 1 ? self.instance_eval(&block) : block.call(self)) if block
+      raise ConfigError, "You must provide a :name or :mbid parameter" if [name, mbid].all?(&:nil?)
+      raise ConfigError, "You must provide a user_agent parameter to identify your requests" if user_agent.nil?
+    end
+    
+    def start_date
+      @start_date ||= Date.today << 1
+    end
+    
+    def end_date
+      @end_date ||= Date.today >> 1
+    end
+
+    #http://musicbrainz.org/ws/2/release/?type=xml&query=arid:2ff0dfc6-0542-4bbc-a44a-60605c074ba6
+
+    # Musicbrainz uri to request releases
+    def uri
+      URI.parse("http://musicbrainz.org/ws/2/release/?type=xml&query=#{query}")
+    end
+
+    def releases_xml
+      http = Net::HTTP.new(uri.host)
+      request = Net::HTTP::Get.new(uri.request_uri, {"User-Agent" => user_agent})
+      response = http.request(request)
+      case response.code
+      when "200"
+        @releases_xml = Nokogiri::XML(response.body)
+      else
+        raise ResponseError, "There is a problem accessing the Music Brainz api"
+      end
+    end
+
+    # Returns an array of BrainzReleases::Release objects
+    def results
+      (releases = []).tap do 
+        releases_xml.xpath('//xmlns:release').each do |node|
+          releases << BrainzReleases::Release.build_from_node(node)
+        end
+      end
+    end
+    
+    private 
+    
+    def query
+      CGI.escape("#{artist_param} AND date:[#{start_date.to_s} TO #{end_date.to_s}]")
+    end
+
+    def artist_param
+      mbid ? "arid:#{mbid}" : "artist:#{name}"
+    end
+
+  end
+end

data/lib/brainz_releases/version.rb

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

data/lib/brainz_releases.rb

@@ -0,0 +1,10 @@
+module BrainzReleases
+    
+  def self.search(&block)
+    BrainzReleases::Search.search &block
+  end
+  
+end
+
+require 'brainz_releases/search'
+require 'brainz_releases/release'

data/spec/brainz_releases_spec.rb

@@ -0,0 +1,14 @@
+require 'spec_helper.rb'
+
+describe BrainzReleases do
+
+  describe "::search" do    
+    it "should call search" do
+      BrainzReleases::Search.should_receive(:search)
+      BrainzReleases.search do |search| 
+        search.mbid = "123"
+      end
+    end
+  end
+
+end

data/spec/fixtures/ok.xml

@@ -0,0 +1,724 @@
+<metadata xmlns="http://musicbrainz.org/ns/mmd-2.0#" xmlns:ext="http://musicbrainz.org/ns/ext#-2.0">
+  <release-list offset="0" count="20">
+    <release ext:score="100" id="4a46ee61-75b5-4e2b-ac2e-81ef2ccec0f9">
+      <title>Fi</title>
+      <status>Official</status>
+      <text-representation>
+        <language>eng</language>
+        <script>Latn</script>
+      </text-representation>
+      <artist-credit>
+        <name-credit>
+          <artist id="9f9953f0-68bb-4ce3-aace-2f44c87f0aa3">
+            <name>Bibio</name>
+            <sort-name>Bibio</sort-name>
+          </artist>
+        </name-credit>
+      </artist-credit>
+      <release-group type="Album" id="02f2abd4-155b-36e8-abe8-dc99d3083958"/>
+      <date>2005-02-08</date>
+      <country>US</country>
+      <barcode>663405123424</barcode>
+      <asin>B0006ZXJ8O</asin>
+      <label-info-list>
+        <label-info>
+          <catalog-number>MH-234</catalog-number>
+          <label id="05e6e753-0f22-438d-9cdd-cdc57eb56433">
+            <name>Mush Records</name>
+          </label>
+        </label-info>
+      </label-info-list>
+      <medium-list count="1">
+        <track-count>17</track-count>
+        <medium>
+          <format>CD</format>
+          <disc-list count="1"/>
+          <track-list count="17"/>
+        </medium>
+      </medium-list>
+    </release>
+    <release ext:score="100" id="40504860-1d87-4632-adb1-67bb94f928ed">
+      <title>Hand Cranked</title>
+      <status>Official</status>
+      <text-representation>
+        <language>eng</language>
+        <script>Latn</script>
+      </text-representation>
+      <artist-credit>
+        <name-credit>
+          <artist id="9f9953f0-68bb-4ce3-aace-2f44c87f0aa3">
+            <name>Bibio</name>
+            <sort-name>Bibio</sort-name>
+          </artist>
+        </name-credit>
+      </artist-credit>
+      <release-group type="Album" id="662f6134-c6e9-3869-ad67-3bdee1bfeb1c"/>
+      <date>2006-03-07</date>
+      <country>US</country>
+      <label-info-list>
+        <label-info>
+          <catalog-number>MH-244</catalog-number>
+          <label id="05e6e753-0f22-438d-9cdd-cdc57eb56433">
+            <name>Mush Records</name>
+          </label>
+        </label-info>
+      </label-info-list>
+      <medium-list count="1">
+        <track-count>14</track-count>
+        <medium>
+          <format>CD</format>
+          <disc-list count="1"/>
+          <track-list count="14"/>
+        </medium>
+      </medium-list>
+    </release>
+    <release ext:score="100" id="835c99e1-e7ac-4ee1-b294-083113921fe8">
+      <title>Sheila Sets Sail</title>
+      <status>Official</status>
+      <text-representation>
+        <language>eng</language>
+        <script>Latn</script>
+      </text-representation>
+      <artist-credit>
+        <name-credit>
+          <artist id="9f9953f0-68bb-4ce3-aace-2f44c87f0aa3">
+            <name>Bibio</name>
+            <sort-name>Bibio</sort-name>
+          </artist>
+        </name-credit>
+      </artist-credit>
+      <release-group type="Single" id="12dd993b-2d1a-37fc-b32e-0cf5b7717533"/>
+      <date>2006</date>
+      <country>GB</country>
+      <medium-list count="1">
+        <track-count>2</track-count>
+        <medium>
+          <disc-list count="0"/>
+          <track-list count="2"/>
+        </medium>
+      </medium-list>
+    </release>
+    <release ext:score="100" id="f414d3cc-c6f3-44bc-8e43-cef73f289d3c">
+      <title>Vignetting the Compost</title>
+      <status>Official</status>
+      <text-representation>
+        <language>eng</language>
+        <script>Latn</script>
+      </text-representation>
+      <artist-credit>
+        <name-credit>
+          <artist id="9f9953f0-68bb-4ce3-aace-2f44c87f0aa3">
+            <name>Bibio</name>
+            <sort-name>Bibio</sort-name>
+          </artist>
+        </name-credit>
+      </artist-credit>
+      <release-group type="Album" id="1860599e-1a1e-3a42-8fdc-eb7af9b9e190"/>
+      <date>2009-02-03</date>
+      <country>US</country>
+      <barcode>663405126326</barcode>
+      <asin>B001NJY5LW</asin>
+      <label-info-list>
+        <label-info>
+          <catalog-number>MH-263</catalog-number>
+          <label id="05e6e753-0f22-438d-9cdd-cdc57eb56433">
+            <name>Mush Records</name>
+          </label>
+        </label-info>
+      </label-info-list>
+      <medium-list count="1">
+        <track-count>16</track-count>
+        <medium>
+          <format>CD</format>
+          <disc-list count="1"/>
+          <track-list count="16"/>
+        </medium>
+      </medium-list>
+    </release>
+    <release ext:score="100" id="a7bf4f6b-babb-48ea-aaf3-d17538137654">
+      <title>Ovals and Emeralds</title>
+      <status>Official</status>
+      <text-representation>
+        <language>eng</language>
+        <script>Latn</script>
+      </text-representation>
+      <artist-credit>
+        <name-credit>
+          <artist id="9f9953f0-68bb-4ce3-aace-2f44c87f0aa3">
+            <name>Bibio</name>
+            <sort-name>Bibio</sort-name>
+          </artist>
+        </name-credit>
+      </artist-credit>
+      <release-group type="EP" id="9c5b0bb0-d421-366f-929a-19a8b9850fc8"/>
+      <date>2009-03-03</date>
+      <country>XW</country>
+      <label-info-list>
+        <label-info>
+          <catalog-number>MH-042</catalog-number>
+          <label id="05e6e753-0f22-438d-9cdd-cdc57eb56433">
+            <name>Mush Records</name>
+          </label>
+        </label-info>
+      </label-info-list>
+      <medium-list count="1">
+        <track-count>6</track-count>
+        <medium>
+          <format>Digital Media</format>
+          <disc-list count="0"/>
+          <track-list count="6"/>
+        </medium>
+      </medium-list>
+    </release>
+    <release ext:score="100" id="244d8104-820b-4fc3-9ed6-336c3a317d5c">
+      <title>Ambivalence Avenue</title>
+      <status>Official</status>
+      <text-representation>
+        <language>eng</language>
+        <script>Latn</script>
+      </text-representation>
+      <artist-credit>
+        <name-credit>
+          <artist id="9f9953f0-68bb-4ce3-aace-2f44c87f0aa3">
+            <name>Bibio</name>
+            <sort-name>Bibio</sort-name>
+          </artist>
+        </name-credit>
+      </artist-credit>
+      <release-group type="Album" id="a4c6be15-bfc4-4078-b80b-d9f03a4049b1"/>
+      <date>2009-06-22</date>
+      <country>GB</country>
+      <barcode>801061017729</barcode>
+      <asin>B00292SQNA</asin>
+      <label-info-list>
+        <label-info>
+          <catalog-number>WARPCD177</catalog-number>
+          <label id="46f0f4cd-8aab-4b33-b698-f459faf64190">
+            <name>Warp Records</name>
+          </label>
+        </label-info>
+      </label-info-list>
+      <medium-list count="1">
+        <track-count>12</track-count>
+        <medium>
+          <format>CD</format>
+          <disc-list count="1"/>
+          <track-list count="12"/>
+        </medium>
+      </medium-list>
+    </release>
+    <release ext:score="100" id="e479ca69-79b4-40f0-8e44-c09a065e3136">
+      <title>Ambivalence Avenue / Fire Ant</title>
+      <status>Official</status>
+      <text-representation>
+        <language>eng</language>
+        <script>Latn</script>
+      </text-representation>
+      <artist-credit>
+        <name-credit>
+          <artist id="9f9953f0-68bb-4ce3-aace-2f44c87f0aa3">
+            <name>Bibio</name>
+            <sort-name>Bibio</sort-name>
+          </artist>
+        </name-credit>
+      </artist-credit>
+      <release-group type="Single" id="67cd2404-7a3e-4cf8-b6f0-4f7eb2f489e7"/>
+      <date>2009-06-08</date>
+      <country>GB</country>
+      <barcode>0801061927974</barcode>
+      <asin>B002A03J1A</asin>
+      <label-info-list>
+        <label-info>
+          <catalog-number>7WAP279</catalog-number>
+          <label id="46f0f4cd-8aab-4b33-b698-f459faf64190">
+            <name>Warp Records</name>
+          </label>
+        </label-info>
+      </label-info-list>
+      <medium-list count="1">
+        <track-count>2</track-count>
+        <medium>
+          <format>Vinyl</format>
+          <disc-list count="0"/>
+          <track-list count="2"/>
+        </medium>
+      </medium-list>
+    </release>
+    <release ext:score="100" id="d542e30e-b50e-4f48-b622-18471f4641b1">
+      <title>The Apple and The Tooth</title>
+      <status>Official</status>
+      <text-representation>
+        <language>eng</language>
+        <script>Latn</script>
+      </text-representation>
+      <artist-credit>
+        <name-credit>
+          <artist id="9f9953f0-68bb-4ce3-aace-2f44c87f0aa3">
+            <name>Bibio</name>
+            <sort-name>Bibio</sort-name>
+          </artist>
+        </name-credit>
+      </artist-credit>
+      <release-group type="EP" id="54494aea-4596-464c-b3fa-e984b13b59b7"/>
+      <date>2009-11-10</date>
+      <country>US</country>
+      <barcode>0801061019020</barcode>
+      <asin>B002QXIO20</asin>
+      <label-info-list>
+        <label-info>
+          <catalog-number>WARPCD190</catalog-number>
+          <label id="46f0f4cd-8aab-4b33-b698-f459faf64190">
+            <name>Warp Records</name>
+          </label>
+        </label-info>
+      </label-info-list>
+      <medium-list count="1">
+        <track-count>12</track-count>
+        <medium>
+          <format>CD</format>
+          <disc-list count="1"/>
+          <track-list count="12"/>
+        </medium>
+      </medium-list>
+    </release>
+    <release ext:score="100" id="23df32ab-b08a-39b7-8fbb-d33a7f1bc1d6">
+      <title>The Apple and The Tooth</title>
+      <status>Official</status>
+      <text-representation>
+        <language>eng</language>
+        <script>Latn</script>
+      </text-representation>
+      <artist-credit>
+        <name-credit>
+          <artist id="9f9953f0-68bb-4ce3-aace-2f44c87f0aa3">
+            <name>Bibio</name>
+            <sort-name>Bibio</sort-name>
+          </artist>
+        </name-credit>
+      </artist-credit>
+      <release-group type="EP" id="54494aea-4596-464c-b3fa-e984b13b59b7"/>
+      <date>2009-11-09</date>
+      <country>GB</country>
+      <barcode>0801061019020</barcode>
+      <asin>B002QXIO20</asin>
+      <label-info-list>
+        <label-info>
+          <catalog-number>WARPCD190</catalog-number>
+          <label id="46f0f4cd-8aab-4b33-b698-f459faf64190">
+            <name>Warp Records</name>
+          </label>
+        </label-info>
+      </label-info-list>
+      <medium-list count="1">
+        <track-count>12</track-count>
+        <medium>
+          <format>CD</format>
+          <disc-list count="1"/>
+          <track-list count="12"/>
+        </medium>
+      </medium-list>
+    </release>
+    <release ext:score="100" id="f98ddb9c-98a1-3695-ace2-7be211730663">
+      <title>The Apple and The Tooth</title>
+      <status>Official</status>
+      <text-representation>
+        <language>eng</language>
+        <script>Latn</script>
+      </text-representation>
+      <artist-credit>
+        <name-credit>
+          <artist id="9f9953f0-68bb-4ce3-aace-2f44c87f0aa3">
+            <name>Bibio</name>
+            <sort-name>Bibio</sort-name>
+          </artist>
+        </name-credit>
+      </artist-credit>
+      <release-group type="EP" id="54494aea-4596-464c-b3fa-e984b13b59b7"/>
+      <date>2009-11-09</date>
+      <country>GB</country>
+      <barcode>0801061019013</barcode>
+      <label-info-list>
+        <label-info>
+          <catalog-number>WARPLP190</catalog-number>
+          <label id="46f0f4cd-8aab-4b33-b698-f459faf64190">
+            <name>Warp Records</name>
+          </label>
+        </label-info>
+      </label-info-list>
+      <medium-list count="1">
+        <track-count>12</track-count>
+        <medium>
+          <format>Vinyl</format>
+          <disc-list count="0"/>
+          <track-list count="12"/>
+        </medium>
+      </medium-list>
+    </release>
+    <release ext:score="100" id="8ac778dd-18f8-3593-9475-5315407f05f3">
+      <title>The Apple and The Tooth</title>
+      <status>Official</status>
+      <text-representation>
+        <language>eng</language>
+        <script>Latn</script>
+      </text-representation>
+      <artist-credit>
+        <name-credit>
+          <artist id="9f9953f0-68bb-4ce3-aace-2f44c87f0aa3">
+            <name>Bibio</name>
+            <sort-name>Bibio</sort-name>
+          </artist>
+        </name-credit>
+      </artist-credit>
+      <release-group type="EP" id="54494aea-4596-464c-b3fa-e984b13b59b7"/>
+      <date>2009-11-10</date>
+      <country>US</country>
+      <barcode>0801061019013</barcode>
+      <label-info-list>
+        <label-info>
+          <catalog-number>WARPLP190</catalog-number>
+          <label id="46f0f4cd-8aab-4b33-b698-f459faf64190">
+            <name>Warp Records</name>
+          </label>
+        </label-info>
+      </label-info-list>
+      <medium-list count="1">
+        <track-count>12</track-count>
+        <medium>
+          <format>Vinyl</format>
+          <disc-list count="0"/>
+          <track-list count="12"/>
+        </medium>
+      </medium-list>
+    </release>
+    <release ext:score="100" id="a1c72efd-ec9d-40c3-8331-ad10077a152f">
+      <title>Mind Bokeh</title>
+      <status>Official</status>
+      <text-representation>
+        <language>eng</language>
+        <script>Latn</script>
+      </text-representation>
+      <artist-credit>
+        <name-credit>
+          <artist id="9f9953f0-68bb-4ce3-aace-2f44c87f0aa3">
+            <name>Bibio</name>
+            <sort-name>Bibio</sort-name>
+          </artist>
+        </name-credit>
+      </artist-credit>
+      <release-group type="Album" id="2f155de9-53b1-4167-b206-ccbaffcece50"/>
+      <date>2011-04-04</date>
+      <country>GB</country>
+      <barcode>801061020927</barcode>
+      <asin>B004IMDCJC</asin>
+      <label-info-list>
+        <label-info>
+          <catalog-number>WARPCD209</catalog-number>
+          <label id="46f0f4cd-8aab-4b33-b698-f459faf64190">
+            <name>Warp Records</name>
+          </label>
+        </label-info>
+      </label-info-list>
+      <medium-list count="1">
+        <track-count>12</track-count>
+        <medium>
+          <format>CD</format>
+          <disc-list count="1"/>
+          <track-list count="12"/>
+        </medium>
+      </medium-list>
+    </release>
+    <release ext:score="100" id="d548c96b-0852-3933-b8cd-f7e5b0407df9">
+      <title>Mind Bokeh</title>
+      <status>Official</status>
+      <text-representation>
+        <language>eng</language>
+        <script>Latn</script>
+      </text-representation>
+      <artist-credit>
+        <name-credit>
+          <artist id="9f9953f0-68bb-4ce3-aace-2f44c87f0aa3">
+            <name>Bibio</name>
+            <sort-name>Bibio</sort-name>
+          </artist>
+        </name-credit>
+      </artist-credit>
+      <release-group type="Album" id="2f155de9-53b1-4167-b206-ccbaffcece50"/>
+      <date>2011-03-29</date>
+      <country>US</country>
+      <barcode>801061020927</barcode>
+      <asin>B004IMDCJC</asin>
+      <label-info-list>
+        <label-info>
+          <catalog-number>WARPCD209</catalog-number>
+          <label id="46f0f4cd-8aab-4b33-b698-f459faf64190">
+            <name>Warp Records</name>
+          </label>
+        </label-info>
+      </label-info-list>
+      <medium-list count="1">
+        <track-count>12</track-count>
+        <medium>
+          <format>CD</format>
+          <disc-list count="1"/>
+          <track-list count="12"/>
+        </medium>
+      </medium-list>
+    </release>
+    <release ext:score="100" id="d9990af1-9604-3324-bf90-9f6ea46a3b02">
+      <title>Mind Bokeh</title>
+      <status>Official</status>
+      <text-representation>
+        <language>eng</language>
+        <script>Latn</script>
+      </text-representation>
+      <artist-credit>
+        <name-credit>
+          <artist id="9f9953f0-68bb-4ce3-aace-2f44c87f0aa3">
+            <name>Bibio</name>
+            <sort-name>Bibio</sort-name>
+          </artist>
+        </name-credit>
+      </artist-credit>
+      <release-group type="Album" id="2f155de9-53b1-4167-b206-ccbaffcece50"/>
+      <date>2011-03-29</date>
+      <country>US</country>
+      <label-info-list>
+        <label-info>
+          <label id="46f0f4cd-8aab-4b33-b698-f459faf64190">
+            <name>Warp Records</name>
+          </label>
+        </label-info>
+      </label-info-list>
+      <medium-list count="1">
+        <track-count>12</track-count>
+        <medium>
+          <format>Digital Media</format>
+          <disc-list count="0"/>
+          <track-list count="12"/>
+        </medium>
+      </medium-list>
+    </release>
+    <release ext:score="100" id="35a6a938-b84c-3239-851e-3ded19b79cff">
+      <title>Mind Bokeh</title>
+      <status>Official</status>
+      <text-representation>
+        <language>eng</language>
+        <script>Latn</script>
+      </text-representation>
+      <artist-credit>
+        <name-credit>
+          <artist id="9f9953f0-68bb-4ce3-aace-2f44c87f0aa3">
+            <name>Bibio</name>
+            <sort-name>Bibio</sort-name>
+          </artist>
+        </name-credit>
+      </artist-credit>
+      <release-group type="Album" id="2f155de9-53b1-4167-b206-ccbaffcece50"/>
+      <date>2011-04-04</date>
+      <country>XW</country>
+      <label-info-list>
+        <label-info>
+          <label id="46f0f4cd-8aab-4b33-b698-f459faf64190">
+            <name>Warp Records</name>
+          </label>
+        </label-info>
+      </label-info-list>
+      <medium-list count="1">
+        <track-count>12</track-count>
+        <medium>
+          <format>Digital Media</format>
+          <disc-list count="0"/>
+          <track-list count="12"/>
+        </medium>
+      </medium-list>
+    </release>
+    <release ext:score="100" id="039f78b8-6c06-4b8f-9451-93a2aba37c0c">
+      <title>Excuses</title>
+      <status>Official</status>
+      <text-representation>
+        <language>eng</language>
+        <script>Latn</script>
+      </text-representation>
+      <artist-credit>
+        <name-credit>
+          <artist id="9f9953f0-68bb-4ce3-aace-2f44c87f0aa3">
+            <name>Bibio</name>
+            <sort-name>Bibio</sort-name>
+          </artist>
+        </name-credit>
+      </artist-credit>
+      <release-group type="Single" id="9c1db9c1-2b92-419a-9fc2-3db348f8d524"/>
+      <date>2011-02-28</date>
+      <country>GB</country>
+      <barcode>0801061931414</barcode>
+      <asin>B004MCH0SC</asin>
+      <label-info-list>
+        <label-info>
+          <catalog-number>10WAP314</catalog-number>
+          <label id="46f0f4cd-8aab-4b33-b698-f459faf64190">
+            <name>Warp Records</name>
+          </label>
+        </label-info>
+      </label-info-list>
+      <medium-list count="1">
+        <track-count>2</track-count>
+        <medium>
+          <format>Vinyl</format>
+          <disc-list count="0"/>
+          <track-list count="2"/>
+        </medium>
+      </medium-list>
+    </release>
+    <release ext:score="100" id="0e5c7946-9b8f-457c-802d-a3154b3caae7">
+      <title>Willenhall / Baskerville Grinch</title>
+      <status>Official</status>
+      <text-representation>
+        <language>eng</language>
+        <script>Latn</script>
+      </text-representation>
+      <artist-credit>
+        <name-credit joinphrase=" / ">
+          <artist id="9f9953f0-68bb-4ce3-aace-2f44c87f0aa3">
+            <name>Bibio</name>
+            <sort-name>Bibio</sort-name>
+          </artist>
+        </name-credit>
+        <name-credit>
+          <name>Clark</name>
+          <artist id="5d0c202c-e30f-40c4-abf5-c0007af0d1cc">
+            <name>Chris Clark</name>
+            <sort-name>Clark, Chris</sort-name>
+            <disambiguation>of Warp Records</disambiguation>
+          </artist>
+        </name-credit>
+      </artist-credit>
+      <release-group type="Single" id="5fcfd2af-4a90-4eb8-84df-5cdb7c14d90d"/>
+      <date>2011-04-16</date>
+      <country>GB</country>
+      <barcode>801061931810</barcode>
+      <label-info-list>
+        <label-info>
+          <catalog-number>WAP318</catalog-number>
+          <label id="46f0f4cd-8aab-4b33-b698-f459faf64190">
+            <name>Warp Records</name>
+          </label>
+        </label-info>
+      </label-info-list>
+      <medium-list count="1">
+        <track-count>2</track-count>
+        <medium>
+          <format>Vinyl</format>
+          <disc-list count="0"/>
+          <track-list count="2"/>
+        </medium>
+      </medium-list>
+    </release>
+    <release ext:score="100" id="eb980750-8eb2-4ac3-8328-0f0ca8d9e414">
+      <title>K Is for Kelson</title>
+      <status>Official</status>
+      <text-representation>
+        <language>eng</language>
+        <script>Latn</script>
+      </text-representation>
+      <artist-credit>
+        <name-credit>
+          <artist id="9f9953f0-68bb-4ce3-aace-2f44c87f0aa3">
+            <name>Bibio</name>
+            <sort-name>Bibio</sort-name>
+          </artist>
+        </name-credit>
+      </artist-credit>
+      <release-group type="Single" id="abeec470-b316-4795-a2df-4f4e8d7bd5eb"/>
+      <date>2011-05-23</date>
+      <country>GB</country>
+      <asin>B004XKBD5E</asin>
+      <label-info-list>
+        <label-info>
+          <catalog-number>WAP316</catalog-number>
+          <label id="46f0f4cd-8aab-4b33-b698-f459faf64190">
+            <name>Warp Records</name>
+          </label>
+        </label-info>
+      </label-info-list>
+      <medium-list count="1">
+        <track-count>4</track-count>
+        <medium>
+          <format>12" Vinyl</format>
+          <disc-list count="0"/>
+          <track-list count="4"/>
+        </medium>
+      </medium-list>
+    </release>
+    <release ext:score="100" id="4ec17c32-daca-4c95-ad5e-10fef55bf876">
+      <title>K Is for Kelson</title>
+      <status>Official</status>
+      <text-representation>
+        <language>eng</language>
+        <script>Latn</script>
+      </text-representation>
+      <artist-credit>
+        <name-credit>
+          <artist id="9f9953f0-68bb-4ce3-aace-2f44c87f0aa3">
+            <name>Bibio</name>
+            <sort-name>Bibio</sort-name>
+          </artist>
+        </name-credit>
+      </artist-credit>
+      <release-group type="Single" id="abeec470-b316-4795-a2df-4f4e8d7bd5eb"/>
+      <date>2011-05-23</date>
+      <country>GB</country>
+      <asin>B005099E1W</asin>
+      <label-info-list>
+        <label-info>
+          <catalog-number>WAP316D</catalog-number>
+          <label id="46f0f4cd-8aab-4b33-b698-f459faf64190">
+            <name>Warp Records</name>
+          </label>
+        </label-info>
+      </label-info-list>
+      <medium-list count="1">
+        <track-count>4</track-count>
+        <medium>
+          <format>Digital Media</format>
+          <disc-list count="0"/>
+          <track-list count="4"/>
+        </medium>
+      </medium-list>
+    </release>
+    <release ext:score="100" id="4b53cfcc-ae4c-4c5b-9881-ffcee23709b3">
+      <title>T.O.Y.S.</title>
+      <status>Official</status>
+      <text-representation>
+        <language>eng</language>
+        <script>Latn</script>
+      </text-representation>
+      <artist-credit>
+        <name-credit>
+          <artist id="9f9953f0-68bb-4ce3-aace-2f44c87f0aa3">
+            <name>Bibio</name>
+            <sort-name>Bibio</sort-name>
+          </artist>
+        </name-credit>
+      </artist-credit>
+      <release-group type="Single" id="7d0bcfad-54cd-4fde-973c-ff934004a0d1"/>
+      <date>2011-08-01</date>
+      <country>GB</country>
+      <label-info-list>
+        <label-info>
+          <catalog-number>WAP320D</catalog-number>
+          <label id="46f0f4cd-8aab-4b33-b698-f459faf64190">
+            <name>Warp Records</name>
+          </label>
+        </label-info>
+      </label-info-list>
+      <medium-list count="1">
+        <track-count>4</track-count>
+        <medium>
+          <format>Digital Media</format>
+          <disc-list count="0"/>
+          <track-list count="4"/>
+        </medium>
+      </medium-list>
+    </release>
+  </release-list>
+</metadata>

data/spec/release_spec.rb

@@ -0,0 +1,28 @@
+require 'spec_helper.rb'
+
+describe BrainzReleases::Release do
+
+    
+  describe "build_from_node" do
+    
+    before do
+      node = Nokogiri::XML(File.read("spec/fixtures/ok.xml")).xpath('//xmlns:release').first
+      @release = BrainzReleases::Release.build_from_node(node)
+    end
+    
+    it "should set the attributes" do
+      @release.mbid.should == "4a46ee61-75b5-4e2b-ac2e-81ef2ccec0f9"
+      @release.artist.should == "Bibio"
+      @release.artist_mbid.should == "9f9953f0-68bb-4ce3-aace-2f44c87f0aa3"
+      @release.title.should == "Fi"
+      @release.release_type.should == "Album"
+      @release.date_available.should == "2005-02-08"
+      @release.track_count.should == "17"
+      @release.format.should == "CD"
+      @release.label.should == "Mush Records"
+      @release.country.should == "US"
+    end
+    
+  end
+
+end

data/spec/search_spec.rb

@@ -0,0 +1,155 @@
+require 'spec_helper.rb'
+
+describe BrainzReleases::Search do
+
+  before { FakeWeb.allow_net_connect = false }
+  after  { FakeWeb.allow_net_connect = true }
+
+  describe "initialize" do
+
+    context "when all attributes are set" do
+      before do
+        @brainz_search = BrainzReleases::Search.new do |search|
+          search.user_agent = "Testing/0.1"
+          search.start_date = Date.parse("1/1/2011")
+          search.end_date = Date.parse("5/5/2011")
+          search.name = "Bonobo"
+          search.mbid = "123"
+        end
+      end
+      
+      it "should initialize the user agent" do
+        @brainz_search.user_agent.should == "Testing/0.1"
+      end
+
+      it "should initialize the start date" do
+        @brainz_search.start_date.should == Date.parse("1/1/2011")
+      end
+
+      it "should initialize the end date" do
+        @brainz_search.end_date.should == Date.parse("5/5/2011")
+      end
+
+      it "should initialize the name" do
+        @brainz_search.name.should == "Bonobo"
+      end
+
+      it "should initialize the mbid" do
+        @brainz_search.mbid.should == "123"
+      end
+    end
+
+    context "when the name and mbid are missing" do
+      it "should raise an exception" do
+        lambda {BrainzReleases::Search.new { |search| search.user_agent = "Foo"}}.should raise_exception(BrainzReleases::Search::ConfigError)
+      end
+    end
+    
+    context "when the user agent is missing" do
+      it "should raise an exception" do
+        lambda {BrainzReleases::Search.new { |search| search.mbid = "123"}}.should raise_exception(BrainzReleases::Search::ConfigError)
+      end
+    end
+
+    context "when start date and end date are missing" do
+      before do
+        Date.stub(:now){Date.parse("1/1/2011")}
+        @brainz_search = BrainzReleases::Search.new do |search|
+          search.user_agent = "Testing/0.1"
+          search.name = "Bonobo"
+          search.mbid = "123"
+        end
+      end
+
+      it "should initialize the start date" do
+        @brainz_search.start_date.should_not be_nil
+      end
+
+      it "should initialize the end date" do
+        @brainz_search.end_date.should_not be_nil
+      end
+    end
+
+  end
+
+  describe "uri" do
+
+    context "when both the name and mbid are set" do
+      before do
+        @brainz_search = BrainzReleases::Search.new do |search|
+          search.user_agent = "Testing/0.1"
+          search.start_date = Date.parse("1/1/2011")
+          search.end_date = Date.parse("5/5/2011")
+          search.name = "Bonobo"
+          search.mbid = "123"
+        end
+      end
+
+      it "should use the mbid" do        
+        @brainz_search.uri.should == URI.parse("http://musicbrainz.org/ws/2/release/?type=xml&query=arid%3A123+AND+date%3A%5B2011-01-01+TO+2011-05-05%5D")
+      end
+
+    end
+
+  end
+
+  # Note that you cannot compare two Nokogiri documents that have been parsed, even if you are parsing the same document
+  # In any case we're not testing that Nokogiri works, we're testing that Nokogiri is called with the correct options
+  describe "releases_xml" do
+
+    before do
+      @brainz_search = BrainzReleases::Search.new do |search|
+        search.user_agent = "Testing/0.1"
+        search.start_date = Date.parse("1/1/2011")
+        search.end_date = Date.parse("5/5/2011")
+        search.name = "Bonobo"
+        search.mbid = "123"
+      end
+    end
+
+    context "when the result is ok" do
+      before do
+        FakeWeb.register_uri(:get, "http://example.com", :body => File.read("spec/fixtures/ok.xml"))
+        @brainz_search.stub(:uri){URI.parse("http://example.com")}
+      end
+      it "should call the artists url with Nokogiri parse to get the xml" do
+        Nokogiri::XML::Document.should_receive(:parse).with(Net::HTTP.get(URI.parse("http://example.com")), nil, nil, 1)
+        @brainz_search.releases_xml
+      end
+      it "should not raise the error message as an exception" do
+        lambda {@brainz_search.releases_xml}.should_not raise_exception(BrainzReleases::Search::ResponseError)
+      end
+    end
+    context "when the result is failed" do
+      before do
+        FakeWeb.register_uri(:get, "http://example.com", :body => "Some problem", :status => ["403", "Forbidden"])
+        @brainz_search.stub(:uri){URI.parse("http://example.com")}
+      end
+      it "should raise the a ResponseError exception" do
+        lambda {@brainz_search.releases_xml}.should raise_exception(BrainzReleases::Search::ResponseError)
+      end
+    end
+  end
+
+  describe "results" do
+
+    before do
+      @brainz_search = BrainzReleases::Search.new do |search|
+        search.user_agent = "Testing/0.1"
+        search.start_date = Date.parse("1/1/2011")
+        search.end_date = Date.parse("5/5/2011")
+        search.name = "Bonobo"
+        search.mbid = "123"
+      end
+      @brainz_search.stub(:releases_xml).and_return(Nokogiri::XML(File.read("spec/fixtures/ok.xml")))
+    end
+
+    it "should include the releases returned by releases_xml" do
+      @brainz_search.results.map(&:artist).should include("Bibio")
+      @brainz_search.results.map(&:title).should include("Mind Bokeh")
+      @brainz_search.results.first.should be_kind_of(BrainzReleases::Release)
+      @brainz_search.results.length.should == 20
+    end
+  end
+
+end

data/spec/spec_helper.rb

@@ -0,0 +1,2 @@
+Dir["#{File.dirname(__FILE__)}/../lib/**/*.rb"].each { |f| require f }
+require 'fakeweb'

metadata

@@ -0,0 +1,108 @@
+--- !ruby/object:Gem::Specification 
+name: brainz_releases
+version: !ruby/object:Gem::Version 
+  prerelease: 
+  version: 0.0.1
+platform: ruby
+authors: 
+- Paul Sturgess
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-09-13 00:00:00 +01:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: nokogiri
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        version: "1.4"
+  type: :runtime
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        version: "2.6"
+  type: :development
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: fakeweb
+  prerelease: false
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        version: 1.3.0
+  type: :development
+  version_requirements: *id003
+description: Uses the MusicBrainz XML Web Service (version 2) to extract the releases for an artist and turn them into nice ruby objects.
+email: 
+- paulsturgess@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- .DS_Store
+- .gitignore
+- Gemfile
+- README.rdoc
+- Rakefile
+- brainz_releases.gemspec
+- lib/.DS_Store
+- lib/brainz_releases.rb
+- lib/brainz_releases/release.rb
+- lib/brainz_releases/search.rb
+- lib/brainz_releases/version.rb
+- spec/brainz_releases_spec.rb
+- spec/fixtures/ok.xml
+- spec/release_spec.rb
+- spec/search_spec.rb
+- spec/spec_helper.rb
+has_rdoc: true
+homepage: https://github.com/paulsturgess/brainz_releases
+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: brainz_releases
+rubygems_version: 1.6.2
+signing_key: 
+specification_version: 3
+summary: Provides a ruby inteface for extracting the releases for an artist from MusicBrainz
+test_files: 
+- spec/brainz_releases_spec.rb
+- spec/fixtures/ok.xml
+- spec/release_spec.rb
+- spec/search_spec.rb
+- spec/spec_helper.rb