musicbrainz_wrapper 0.0.1

checksums.yaml

@@ -0,0 +1,15 @@
+---
+!binary "U0hBMQ==":
+  metadata.gz: !binary |-
+    ODllMmEwOGE4NzU5NjdiNGZhMTU0NGU4YzUzMzIyOWMxZmUxNGI2Yg==
+  data.tar.gz: !binary |-
+    Y2YzNDVmYzhiM2JiMDFjZDA1YzFiZmQ5NzEwOGIyZWE3OTBhNzkxYQ==
+!binary "U0hBNTEy":
+  metadata.gz: !binary |-
+    ODgxNjZkZDVjMWRiNzcxMWJjM2RjZGRjODg4ZjQ1M2Q2NDAyZWMxMmMzNjM1
+    N2ZkNzRkZjk2ZDE0MGM4YWVkNjBhZWI5OTk3ODViMjgyNmE2Y2I5Y2RjYWJi
+    ZjZjNjM2ZDdiODAwNzdkZWYyODg1YWJkNjM4OTgxNmNkNDJiOGQ=
+  data.tar.gz: !binary |-
+    Zjk3YjJhZTJmYWU5YWQ4ZjEzZDFmYzBiMTZhM2E5NWViMzM1MTdmNGU3MGFk
+    M2MyZTFlNDhjZTI0MjkxY2M1ODBiYWJkMzFlZjM5YWJmY2FmYzc1MTU5MzE0
+    YWM1NWMwNjZmNDg3Mzk0ZDAwYWFmZjA1OTJlODZiZDUyY2Q1MTA=

data/.gitignore

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

data/Gemfile

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

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2014 tomallen400
+
+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,29 @@
+# MusicbrainzWrapper
+
+TODO: Write a gem description
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'musicbrainz_wrapper'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install musicbrainz_wrapper
+
+## Usage
+
+TODO: Write usage instructions here
+
+## 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

data/Rakefile

@@ -0,0 +1,7 @@
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new
+
+task :default => :spec
+task :test => :spec

data/lib/musicbrainz.rb

@@ -0,0 +1,6 @@
+module Musicbrainz
+  
+end
+
+# Loading sequence.
+require File.dirname(__FILE__) + "/wrapper/wrapper"

data/lib/musicbrainz_wrapper.rb

@@ -0,0 +1,2 @@
+require "musicbrainz_wrapper/version"
+require "musicbrainz"

data/lib/musicbrainz_wrapper/version.rb

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

data/lib/wrapper/resources/alias.rb

@@ -0,0 +1,11 @@
+class Musicbrainz::Alias
+	
+	attr_accessor :name, :sort_name, :locale, :type, :primary, :begin_date, :end_date
+	
+	def initialize args
+		args.each do |k, v|
+  		instance_variable_set("@#{k.gsub('-', '_')}", v) unless v.nil?
+  	end
+	end
+	
+end

data/lib/wrapper/resources/area.rb

@@ -0,0 +1,11 @@
+class Musicbrainz::Area
+	
+	attr_accessor :id, :name, :sort_name, :disambiguation, :iso_3166_3_codes, :iso_3166_2_codes, :iso_3166_1_codes
+	
+	def initialize args
+		args.each do |k, v|
+  		instance_variable_set("@#{k.gsub('-', '_')}", v) unless v.nil?
+  	end
+	end
+	
+end

data/lib/wrapper/resources/artist.rb

@@ -0,0 +1,36 @@
+class Musicbrainz::Artist
+	
+	attr_accessor :id, :name, :sort_name, :disambiguation, :ipis, :type, :country, :area, :begin_area, :life_span, :aliases, :tags
+	
+	def initialize args
+		args.each do |k, v|
+  		instance_variable_set("@#{k.gsub('-', '_')}", v) unless v.nil?
+  	end
+  	self.child_initializers
+	end
+	
+	def child_initializers
+		self.area = Musicbrainz::Area.new(self.area) if self.area
+		self.begin_area = Musicbrainz::Area.new(self.begin_area) if self.begin_area
+		self.life_span = Musicbrainz::Area.new(self.life_span) if self.life_span
+		self.aliases_initialize if self.aliases
+		self.tags_initialize if self.tags
+	end
+	
+	def aliases_initialize
+		array = []
+		self.aliases.each do |a|
+			array << Musicbrainz::Alias.new(a)
+		end
+		self.aliases = array
+	end
+	
+	def tags_initialize
+		array = []
+		self.tags.each do |a|
+			array << Musicbrainz::Tag.new(a)
+		end
+		self.tags = array
+	end
+	
+end

data/lib/wrapper/resources/cover_art_archive.rb

@@ -0,0 +1,11 @@
+class Musicbrainz::CoverArtArchive
+	
+	attr_accessor :count, :front, :artwork, :back, :darkened
+	
+	def initialize args
+		args.each do |k, v|
+  		instance_variable_set("@#{k.gsub('-', '_')}", v) unless v.nil?
+  	end
+	end
+	
+end

data/lib/wrapper/resources/label.rb

@@ -0,0 +1,26 @@
+class Musicbrainz::Label
+	
+	attr_accessor :id, :name, :sort_name, :country, :disambiguation, :ipis, :type, :score, :label_code, :country, :area, :life_span, :tags
+	
+	def initialize args
+		args.each do |k, v|
+  		instance_variable_set("@#{k.gsub('-', '_')}", v) unless v.nil?
+  	end
+  	self.child_initializers
+	end
+	
+	def child_initializers
+		self.area = Musicbrainz::Area.new(self.area) if self.area
+		self.life_span = Musicbrainz::Area.new(self.life_span) if self.life_span
+		self.tags_initialize if self.tags
+	end
+	
+	def tags_initialize
+		array = []
+		self.tags.each do |a|
+			array << Musicbrainz::Tag.new(a)
+		end
+		self.tags = array
+	end
+	
+end

data/lib/wrapper/resources/label_info.rb

@@ -0,0 +1,12 @@
+class Musicbrainz::LabelInfo
+	
+	attr_accessor :catalog_number, :label
+	
+	def initialize args
+		args.each do |k, v|
+  		instance_variable_set("@#{k.gsub('-', '_')}", v) unless v.nil?
+  	end
+  	self.label = Musicbrainz::Label.new(self.label) if self.label
+	end
+	
+end

data/lib/wrapper/resources/life_span.rb

@@ -0,0 +1,11 @@
+class Musicbrainz::LifeSpan
+	
+	attr_accessor :begin, :end, :ended
+	
+	def initialize args
+		args.each do |k, v|
+  		instance_variable_set("@#{k.gsub('-', '_')}", v) unless v.nil?
+  	end
+	end
+	
+end

data/lib/wrapper/resources/media.rb

@@ -0,0 +1,11 @@
+class Musicbrainz::Media
+	
+	attr_accessor :format, :disc_count, :track_count
+	
+	def initialize args
+		args.each do |k, v|
+  		instance_variable_set("@#{k.gsub('-', '_')}", v) unless v.nil?
+  	end
+	end
+	
+end

data/lib/wrapper/resources/recording.rb

@@ -0,0 +1,53 @@
+class Musicbrainz::Recording
+	
+	attr_accessor :id, :title, :disambiguation, :score, :length, :video, :artist_credit, :releases, :tags, :relations, :recording, :work
+	
+	def initialize args
+		args.each do |k, v|
+  		instance_variable_set("@#{k.gsub('-', '_')}", v) unless v.nil?
+  	end
+  	self.child_initializers
+	end
+	
+	def child_initializers
+		self.recording = Musicbrainz::Recording.new(self.recording) if self.recording
+		self.work = Musicbrainz::Work.new(self.work) if self.work
+		self.artists_initialize if self.artist_credit
+		self.tags_initialize if self.tags
+		self.releases_initialize if self.releases
+		self.relations_initialize if self.relations
+	end
+	
+	def artists_initialize
+		array = []
+		self.artist_credit.each do |a|
+			array << Musicbrainz::Artist.new(a["artist"]) if a["artist"]
+		end
+		self.artist_credit = array
+	end
+	
+	def tags_initialize
+		array = []
+		self.tags.each do |a|
+			array << Musicbrainz::Tag.new(a)
+		end
+		self.tags = array
+	end
+	
+	def releases_initialize
+		array = []
+		self.releases.each do |a|
+			array << Musicbrainz::Release.new(a)
+		end
+		self.releases = array
+	end
+	
+	def relations_initialize
+		array = []
+		self.relations.each do |a|
+			array << Musicbrainz::Relation.new(a)
+		end
+		self.relations = array
+	end
+	
+end

data/lib/wrapper/resources/relation.rb

@@ -0,0 +1,18 @@
+class Musicbrainz::Relation
+	
+	attr_accessor :type, :type_id, :direction, :artist, :end, :ended, :begin, :attributes, :work, :recording
+	
+	def initialize args
+		args.each do |k, v|
+  		instance_variable_set("@#{k.gsub('-', '_')}", v) unless v.nil?
+  	end
+  	self.child_initializers
+	end
+	
+	def child_initializers
+		self.recording = Musicbrainz::Recording.new(self.recording) if self.recording
+		self.artist = Musicbrainz::Artist.new(self.artist) if self.artist
+		self.work = Musicbrainz::Work.new(self.work) if self.work
+	end
+	
+end

data/lib/wrapper/resources/release.rb

@@ -0,0 +1,64 @@
+class Musicbrainz::Release
+	
+	attr_accessor :id, :title, :score, :count, :status, :text_representation, :artist_credit, :release_group, :area, :date, :country, :release_events, :label_info, :barcode, :asin, :track_count, :media, :cover_art_archive, :quality, :relations
+	
+	def initialize args
+		args.each do |k, v|
+  		instance_variable_set("@#{k.gsub('-', '_')}", v) unless v.nil?
+  	end
+  	self.child_initializers
+	end
+	
+	def child_initializers
+		self.area = Musicbrainz::Area.new(self.area) if self.area
+		self.text_representation = Musicbrainz::TextRepresentation.new(self.text_representation) if self.text_representation
+		self.release_group = Musicbrainz::ReleaseGroup.new(self.release_group) if self.release_group
+		self.cover_art_archive = Musicbrainz::CoverArtArchive.new(self.cover_art_archive) if self.cover_art_archive
+		self.artists_initialize if self.artist_credit
+		self.media_initialize if self.media
+		self.label_info_initialize if self.label_info
+		self.release_events_initialize if self.release_events
+		self.relations_initialize if self.relations
+	end
+	
+	def artists_initialize
+		array = []
+		self.artist_credit.each do |a|
+			array << Musicbrainz::Artist.new(a["artist"]) if a["artist"]
+		end
+		self.artist_credit = array
+	end
+	
+	def media_initialize
+		array = []
+		self.media.each do |a|
+			array << Musicbrainz::Media.new(a)
+		end
+		self.media = array
+	end
+	
+	def label_info_initialize
+		array = []
+		self.label_info.each do |a|
+			array << Musicbrainz::LabelInfo.new(a)
+		end
+		self.label_info = array
+	end
+	
+	def release_events_initialize
+		array = []
+		self.release_events.each do |a|
+			array << Musicbrainz::ReleaseEvent.new(a)
+		end
+		self.release_events = array
+	end
+	
+	def relations_initialize
+		array = []
+		self.relations.each do |a|
+			array << Musicbrainz::Relation.new(a)
+		end
+		self.relations = array
+	end
+	
+end

data/lib/wrapper/resources/release_event.rb

@@ -0,0 +1,12 @@
+class Musicbrainz::ReleaseEvent
+	
+	attr_accessor :area, :date
+	
+	def initialize args
+		args.each do |k, v|
+  		instance_variable_set("@#{k.gsub('-', '_')}", v) unless v.nil?
+  	end
+  	self.area = Musicbrainz::Area.new(self.area) if self.area
+	end
+	
+end

data/lib/wrapper/resources/release_group.rb

@@ -0,0 +1,42 @@
+class Musicbrainz::ReleaseGroup
+	
+	attr_accessor :id, :title, :count, :score, :primary_type, :secondary_types, :artist_credit, :disambiguation, :first_release_date, :releases, :tags
+	
+	def initialize args
+		args.each do |k, v|
+  		instance_variable_set("@#{k.gsub('-', '_')}", v) unless v.nil?
+  	end
+  	self.child_initializers
+	end
+	
+	def child_initializers
+		self.artists_initialize if self.artist_credit
+		self.releases_initialize if self.releases
+		self.tags_initialize if self.tags
+	end
+	
+	def artists_initialize
+		array = []
+		self.artist_credit.each do |a|
+			array << Musicbrainz::Artist.new(a["artist"]) if a["artist"]
+		end
+		self.artist_credit = array
+	end
+	
+	def releases_initialize
+		array = []
+		self.releases.each do |a|
+			array << Musicbrainz::Release.new(a)
+		end
+		self.releases = array
+	end
+	
+	def tags_initialize
+		array = []
+		self.tags.each do |a|
+			array << Musicbrainz::Tag.new(a)
+		end
+		self.tags = array
+	end
+	
+end

data/lib/wrapper/resources/tag.rb

@@ -0,0 +1,11 @@
+class Musicbrainz::Tag
+	
+	attr_accessor :count, :name
+	
+	def initialize args
+		args.each do |k, v|
+  		instance_variable_set("@#{k.gsub('-', '_')}", v) unless v.nil?
+  	end
+	end
+	
+end

data/lib/wrapper/resources/text_representation.rb

@@ -0,0 +1,11 @@
+class Musicbrainz::TextRepresentation
+	
+	attr_accessor :language, :script
+	
+	def initialize args
+		args.each do |k, v|
+  		instance_variable_set("@#{k.gsub('-', '_')}", v) unless v.nil?
+  	end
+	end
+	
+end

data/lib/wrapper/resources/work.rb

@@ -0,0 +1,20 @@
+class Musicbrainz::Work
+	
+	attr_accessor :id, :title, :type, :score, :language, :relations, :iswcs, :disambiguation
+	
+	def initialize args
+		args.each do |k, v|
+  		instance_variable_set("@#{k.gsub('-', '_')}", v) unless v.nil?
+  	end
+  	self.relations_initialize if self.relations
+	end
+	
+	def relations_initialize
+		array = []
+		self.relations.each do |a|
+			array << Musicbrainz::Relation.new(a)
+		end
+		self.relations = array
+	end
+	
+end

data/lib/wrapper/wrapper.rb

@@ -0,0 +1,217 @@
+class Musicbrainz::Wrapper
+
+	require 'net/https'
+	require 'uri'
+	require 'json'
+	
+	attr_accessor :username, :password
+	
+	@@api_url = "http://musicbrainz.org/ws/2/"
+	
+	Dir[File.join(File.dirname(__FILE__), "resources", "*.rb")].each { |file| require file }
+	
+	def initialize args
+		args.each do |k, v|
+  		instance_variable_set("@#{k}", v) unless v.nil?
+  	end
+	end
+	
+	# artist, label, recording, release, release-group, work, area, url, isrc, iswc, discid
+	# discids, media, isrcs, artist-credits, various-artists, aliases, annotation, tags, ratings, user-tags, user-ratings
+	# artist-rels, label-rels, recording-rels, release-rels, release-group-rels, url-rels, work-rels
+	# recording-level-rels, work-level-rels
+	
+	def artist(params)
+		# artist(:id => "id", :inc => {:isrcs => true, :artist-rels => true})
+		response = self.query(Musicbrainz::Wrapper.create_query_string('artist', params), :single)
+		Musicbrainz::Artist.new(response) if !response.nil?
+	end
+	
+	def artists(params)
+		response = self.query(Musicbrainz::Wrapper.create_query_string('artist', params), :multiple)
+		if !response.nil?
+			array = []
+			response.each do |a|
+				array << Musicbrainz::Artist.new(a)
+			end
+			array
+		end
+	end
+	
+	def label(params)
+		response = self.query(Musicbrainz::Wrapper.create_query_string('label', params), :single)
+		Musicbrainz::Label.new(response) if !response.nil?
+	end
+	
+	def labels(params)
+		response = self.query(Musicbrainz::Wrapper.create_query_string('label', params), :multiple)
+		if !response.nil?
+			array = []
+			response.each do |a|
+				array << Musicbrainz::Label.new(a)
+			end
+			array
+		end
+	end
+	
+	def recording(params)
+		response = self.query(Musicbrainz::Wrapper.create_query_string('recording', params), :single)
+		Musicbrainz::Recording.new(response) if !response.nil?
+	end
+	
+	def recordings(params)
+		response = self.query(Musicbrainz::Wrapper.create_query_string('recording', params), :multiple)
+		if !response.nil?
+			array = []
+			response.each do |a|
+				array << Musicbrainz::Recording.new(a)
+			end
+			array
+		end
+	end
+	
+	def release(params)
+		response = self.query(Musicbrainz::Wrapper.create_query_string('release', params), :single)
+		Musicbrainz::Release.new(response) if !response.nil?
+	end
+	
+	def releases(params)
+		response = self.query(Musicbrainz::Wrapper.create_query_string('release', params), :multiple)
+		if !response.nil?
+			array = []
+			response.each do |a|
+				array << Musicbrainz::Release.new(a)
+			end
+			array
+		end
+	end
+	
+	def release_group(params)
+		response = self.query(Musicbrainz::Wrapper.create_query_string('release-group', params), :single)
+		Musicbrainz::ReleaseGroup.new(response) if !response.nil?
+	end
+	
+	def release_groups(params)
+		response = self.query(Musicbrainz::Wrapper.create_query_string('release-group', params), :multiple)
+		if !response.nil?
+			array = []
+			response.each do |a|
+				array << Musicbrainz::ReleaseGroup.new(a)
+			end
+			array
+		end
+	end
+	
+	def work(params)
+		response = self.query(Musicbrainz::Wrapper.create_query_string('work', params), :single)
+		Musicbrainz::Work.new(response) if !response.nil?
+	end
+	
+	def works(params)
+		response = self.query(Musicbrainz::Wrapper.create_query_string('work', params), :multiple)
+		if !response.nil?
+			array = []
+			response.each do |a|
+				array << Musicbrainz::Work.new(a)
+			end
+			array
+		end
+	end
+	
+	# Query String
+		# releases(:artist => "The Rolling Stones", :release => "Sticky Fingers", :inc => {:isrcs => true, :artist-rels => true})
+		# release/?query=artist:The%20Rolling%20Stones+release=Sticky%20Fingers&inc=isrcs&fmt=json
+		# release(:id => "id", :inc => {:isrcs => true, :artist-rels => true})
+		# recording/8d2338a2-4acc-4d99-b2a7-1151f428cab6?inc=isrcs+artist-rels&fmt=json
+	def self.create_query_string(start, params)
+  	if params.is_a?(Hash) && params.count > 0
+			ending = hash_to_query_string(params)
+			"#{start}/#{ending}#{question_mark_or_ampersand(ending)}fmt=json"
+		else
+			"#{start}/"
+  	end
+  end
+  
+  def self.hash_to_query_string(hash)
+  	if hash[:id]
+  		string = hash[:id]
+  	else
+  		string = '?query='
+  		string += query_array(hash).join('+')
+  	end
+  	append_inc(string, hash)
+  end
+  
+  def self.query_array(hash)
+  	array = []
+  	hash.each do |k, v|
+  		array << "#{k}:#{URI.encode(v, Regexp.new("[^#{URI::PATTERN::UNRESERVED}]"))}" unless k == :inc
+  	end
+  	array
+  end
+  
+  def self.append_inc(url, hash)
+  	if hash[:inc]
+  		"#{url}#{question_mark_or_ampersand(url)}inc=#{inc_values_array(hash[:inc]).join('+')}"
+  	else
+  		url
+  	end
+  end
+  
+  def self.inc_values_array(hash)
+  	array = []
+  	hash.each do |k, v|
+  		array << k.to_s.gsub('_', '-') if v == true
+  	end
+  	array
+  end
+  
+  def self.question_mark_or_ampersand(string)
+  	if string.include?('?')
+  		'&'
+  	else
+  		'?'
+  	end
+  end
+	
+	# Hit Musicbrainz API
+	def query(ending, type)
+  	query = @@api_url + ending
+  	response = self.send_query(query)
+  	Musicbrainz::Wrapper.parse_response(response, type)
+  end
+  
+  def send_query(query)
+  	sleep 1
+  	uri = URI.parse(query)
+  	http = Net::HTTP.new(uri.host, uri.port)
+		request = Net::HTTP::Get.new(uri.request_uri)
+    http.request(request)
+  end
+  
+  def self.parse_response(response, type)
+		if response.is_a?(Net::HTTPOK)
+			json = JSON.parse(response.body) rescue {}
+			if type == :multiple
+				if json["artist"]
+					json["artist"]
+				elsif json["labels"]
+					json["labels"]
+				elsif json["release-groups"]
+					json["release-groups"]
+				elsif json["releases"]
+					json["releases"]
+				elsif json["recording"]
+					json["recording"]
+				elsif json["work"]
+					json["work"]
+				else
+					json
+				end
+			else
+				json
+			end
+  	end
+  end
+
+end

data/musicbrainz_wrapper.gemspec

@@ -0,0 +1,23 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'musicbrainz_wrapper/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "musicbrainz_wrapper"
+  spec.version       = MusicbrainzWrapper::VERSION
+  spec.authors       = ["tomallen400"]
+  spec.email         = ["tomallen4000@gmail.com"]
+  spec.description   = "A object orientated gem for the Musizbrainz API"
+  spec.summary       = "A object orientated gem for the Musizbrainz API"
+  spec.homepage      = ""
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files`.split($/)
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 1.3"
+  spec.add_development_dependency "rake"
+end

data/spec/musicbrainz_wrapper_spec.rb

@@ -0,0 +1,5 @@
+require 'spec_helper'
+
+describe Musicbrainz do
+	
+end

data/spec/spec_helper.rb

@@ -0,0 +1,20 @@
+# This file was generated by the `rspec --init` command. Conventionally, all
+# specs live under a `spec` directory, which RSpec adds to the `$LOAD_PATH`.
+# Require this file using `require "spec_helper"` to ensure that it is only
+# loaded once.
+#
+# See http://rubydoc.info/gems/rspec-core/RSpec/Core/Configuration
+RSpec.configure do |config|
+  config.treat_symbols_as_metadata_keys_with_true_values = true
+  config.run_all_when_everything_filtered = true
+  config.filter_run :focus
+  config.color_enabled = true
+
+  # Run specs in random order to surface order dependencies. If you find an
+  # order dependency and want to debug it, you can fix the order by providing
+  # the seed, which is printed after each run.
+  #     --seed 1234
+  config.order = 'random'
+end
+
+require 'musicbrainz_wrapper'

data/spec/wrapper/wrapper_spec.rb

@@ -0,0 +1,164 @@
+require 'spec_helper'
+
+describe Musicbrainz::Wrapper do
+	
+	let(:wrapper) { Musicbrainz::Wrapper.new(:username => 'username', :password => 'password') }
+	let(:api_point) { 'http://musicbrainz.org/ws/2/' }
+	let(:album_query) { 'release/d883e644-5ec0-4928-9ccd-fc78bc306a46?fmt=json' }
+	let(:albums_query) { 'release/?query=artist:The%20Rolling%20Stones&fmt=json' }
+	subject { wrapper }
+	
+	it { should respond_to(:username) }
+	it { should respond_to(:password) }
+	
+	# Query String
+	describe "create_query_string" do
+		subject { Musicbrainz::Wrapper.create_query_string('release', {:artist => "The Rolling Stones", :release => "Sticky Fingers", :inc => {:isrcs => true, :artist_rels => true}}) }
+		it { should be_an_instance_of String }
+		it { should include('artist:The%20Rolling%20Stones+release:Sticky%20Fingers') }
+		it "should add id to string preceded by a / if id supplied" do
+			Musicbrainz::Wrapper.create_query_string('release', {:id => "id", :inc => {:isrcs => true, :artist_rels => true}}).should include('/id')
+		end
+		it "should add each of the passed queries preceded by ?query= and separate with +s" do
+			should include('?query=artist:The%20Rolling%20Stones+release:Sticky%20Fingers')
+		end
+		it "should add all incs" do
+			should include('&inc=isrcs+artist-rels')
+		end
+		it "should add &fmt=json to end of string" do
+			should include('&fmt=json')
+		end
+		it "should return the start if passed blank hash" do
+			Musicbrainz::Wrapper.create_query_string('release', {}).should == 'release/'
+		end
+		it "should return the start if not passed hash" do
+			Musicbrainz::Wrapper.create_query_string('release', nil).should == 'release/'
+		end
+	end
+	
+	describe "hash_to_query_string" do
+		it "should return a string" do
+			Musicbrainz::Wrapper.hash_to_query_string(:id => "123456").should be_an_instance_of String
+		end
+		it "should return id if id supplied" do
+			Musicbrainz::Wrapper.hash_to_query_string(:id => "123456").should == "123456"
+		end
+		it "should return ?query=queries if no id" do
+			Musicbrainz::Wrapper.hash_to_query_string(:artist => "The Rolling Stones", :release => "Sticky Fingers").should == "?query=artist:The%20Rolling%20Stones+release:Sticky%20Fingers"
+		end
+	end
+	
+	describe "query_array" do
+		subject { Musicbrainz::Wrapper.query_array(:artist => "Stones", :release => "Sticky Fingers", :inc => {:isrcs => true, :artist_rels => true}) }
+		it { should be_an_instance_of Array }
+		it { subject.first.should be_an_instance_of String }
+		it { should have(2).Strings }
+		it { should include('artist:Stones') }
+		it { should include('release:Sticky%20Fingers') }
+	end
+	
+	describe "append_inc" do
+		subject { Musicbrainz::Wrapper.append_inc('string', {:artist => "The Rolling Stones", :release => "Sticky Fingers", :inc => {:isrcs => true, :artist_rels => true}}) }
+		it { should be_an_instance_of String }
+		context "when inc exists" do
+			it { should include('?inc=') }
+			it "should include &inc= if string does contain ?" do
+				Musicbrainz::Wrapper.append_inc('?string', {:artist => "The Rolling Stones", :release => "Sticky Fingers", :inc => {:isrcs => true, :artist_rels => true}}).should include('&inc=')
+			end
+			it { should include('inc=isrcs+artist-rels') }
+		end
+		context "when inc doesn't exist" do
+			it "should return the original string if inc does not exist" do
+				Musicbrainz::Wrapper.append_inc('string', {:artist => "The Rolling Stones", :release => "Sticky Fingers"}).should == 'string'
+			end
+		end
+	end
+	
+	describe "inc_values_array" do
+		subject { Musicbrainz::Wrapper.inc_values_array(:isrcs => true, :artist_rels => true, :something_else => false) }
+		it { should be_an_instance_of Array }
+		it { subject.first.should be_an_instance_of String }
+		it "should have a value for each that has true" do
+			should have(2).Strings
+		end
+		it "should replace all _ with -" do
+			should include('artist-rels')
+		end
+	end
+	
+	describe "question_mark_or_ampersand" do
+		it "should return a string" do
+			Musicbrainz::Wrapper.question_mark_or_ampersand("string").should be_an_instance_of String
+		end
+		it "should return a ? if one is not already in string" do
+			Musicbrainz::Wrapper.question_mark_or_ampersand("string").should == '?'
+		end
+		it "should return a & if a ? is in string" do
+			Musicbrainz::Wrapper.question_mark_or_ampersand("string?").should == '&'
+		end
+	end
+	
+	# Hit Musicbrainz API
+	describe "query", :slow => true do
+		context "is passed a plural object" do
+			it "should return an array" do
+				wrapper.query(albums_query).should be_an_instance_of Array
+			end
+		end
+		context "is passed a single object" do
+			it "should return a hash" do
+				wrapper.query(album_query).should be_an_instance_of Hash
+			end
+		end
+		context "is passed bad data" do
+			it "should return nil" do
+				wrapper.query("something_else").should be_nil
+			end
+		end
+	end
+	
+	describe "send_query", :slow => true do
+		context "when sent a good request" do
+			it "should return a Net::HTTPOK object" do
+				wrapper.send_query(api_point + album_query).should be_an_instance_of Net::HTTPOK
+			end
+			it "should return a string as the body" do
+				wrapper.send_query(api_point + album_query).body.should be_an_instance_of String
+			end
+		end
+		context "when sent a bad request" do
+			it "should return a Net::HTTPBadRequest object" do
+				wrapper.send_query(api_point + 'release/d8').should be_an_instance_of Net::HTTPBadRequest
+			end
+		end
+		context "when not finding an object" do
+			it "should return a Net::HTTPNotFound object" do
+				wrapper.send_query(api_point + 'release/d883e644-5ec0-4928-9ccd-fc78bc306a47').should be_an_instance_of Net::HTTPNotFound
+			end
+		end
+	end
+	
+	describe "parse_response", :slow => true do
+		context "when passed a good response" do
+			context "for a single object" do
+				it "should return a hash" do
+					response = wrapper.send_query(api_point + album_query)
+					Musicbrainz::Wrapper.parse_response(response).should be_an_instance_of Hash
+				end
+			end
+			context "for multiple objects" do
+				it "should return an array" do
+					response = wrapper.send_query(api_point + albums_query)
+					Musicbrainz::Wrapper.parse_response(response).should be_an_instance_of Array
+				end
+			end
+		end
+		context "when passed a bad response" do
+			it "should return nil" do
+				response = wrapper.send_query(api_point + 'release/d8')
+				Musicbrainz::Wrapper.parse_response(response).should be_nil
+			end
+		end
+	end
+	
+end

metadata

@@ -0,0 +1,107 @@
+--- !ruby/object:Gem::Specification
+name: musicbrainz_wrapper
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- tomallen400
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-03-07 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.3'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: A object orientated gem for the Musizbrainz API
+email:
+- tomallen4000@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .DS_Store
+- .gitignore
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- lib/.DS_Store
+- lib/musicbrainz.rb
+- lib/musicbrainz_wrapper.rb
+- lib/musicbrainz_wrapper/version.rb
+- lib/wrapper/.DS_Store
+- lib/wrapper/resources/alias.rb
+- lib/wrapper/resources/area.rb
+- lib/wrapper/resources/artist.rb
+- lib/wrapper/resources/cover_art_archive.rb
+- lib/wrapper/resources/label.rb
+- lib/wrapper/resources/label_info.rb
+- lib/wrapper/resources/life_span.rb
+- lib/wrapper/resources/media.rb
+- lib/wrapper/resources/recording.rb
+- lib/wrapper/resources/relation.rb
+- lib/wrapper/resources/release.rb
+- lib/wrapper/resources/release_event.rb
+- lib/wrapper/resources/release_group.rb
+- lib/wrapper/resources/tag.rb
+- lib/wrapper/resources/text_representation.rb
+- lib/wrapper/resources/work.rb
+- lib/wrapper/wrapper.rb
+- musicbrainz_wrapper.gemspec
+- spec/musicbrainz_wrapper_spec.rb
+- spec/spec_helper.rb
+- spec/wrapper/wrapper_spec.rb
+homepage: ''
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.0.3
+signing_key: 
+specification_version: 4
+summary: A object orientated gem for the Musizbrainz API
+test_files:
+- spec/musicbrainz_wrapper_spec.rb
+- spec/spec_helper.rb
+- spec/wrapper/wrapper_spec.rb