discogs-wrapper 1.1.4 → 2.0.0

data/Rakefile

@@ -1,26 +0,0 @@
-require 'rake'
-require 'rspec'
-require 'rspec/core/rake_task'
-require 'rubygems/package_task'
-
-
-
-desc "Run all specs in spec directory"
-RSpec::Core::RakeTask.new(:spec) do |t|
-  t.rspec_opts = ["--colour"]
-  t.pattern = 'spec/**/*_spec.rb'
-end
-
-desc "Run all specs and generate simplecov report"
-task :cov do |t|
-  ENV['COVERAGE'] = 'true'
-  Rake::Task["spec"].execute
-  `open coverage/index.html`
-end
-
-spec = eval(File.read("discogs.gemspec"))
- 
-Gem::PackageTask.new(spec) do |pkg|
-  # pkg.need_zip = true
-  # pkg.need_tar = true
-end

data/discogs.gemspec

@@ -1,22 +0,0 @@
-Gem::Specification.new do |s|
-  
-  s.name = "discogs-wrapper"
-  s.version = "1.1.4"
-  s.date = "2013-08-13"
-  s.summary = "Discogs::Wrapper is a full wrapper for the http://www.discogs.com API V2"
-  s.homepage = "http://www.github.com/buntine/discogs"
-  s.email = "info@andrewbuntine.com"
-  s.authors = ["Andrew Buntine", "Many more contributors"]
-  
-  s.description = "Discogs::Wrapper is a full wrapper for the http://www.discogs.com API V2"
-  
-  s.files = ["lib/wrapper", "lib/wrapper/resource_mappings.rb", "lib/wrapper/wrapper.rb", "lib/wrapper/resource.rb", "lib/wrapper/resources", "lib/wrapper/resources/format.rb", "lib/wrapper/resources/search.rb", "lib/wrapper/resources/label_release.rb", "lib/wrapper/resources/artist.rb", "lib/wrapper/resources/release_artist.rb", "lib/wrapper/resources/artist_release.rb", "lib/wrapper/resources/release_label.rb", "lib/wrapper/resources/generic_list.rb", "lib/wrapper/resources/search_result.rb", "lib/wrapper/resources/label.rb", "lib/wrapper/resources/image.rb", "lib/wrapper/resources/track.rb", "lib/wrapper/resources/release.rb", "lib/wrapper/resources/master_release.rb", "lib/wrapper/resources/master_release_version.rb", "lib/wrapper/resources/video.rb", "./lib/wrapper/resources/user.rb", "lib/discogs.rb", "Rakefile", "README.markdown", "discogs.gemspec"]
-
-  s.test_files = ["spec/wrapper_methods/get_release_spec.rb", "spec/wrapper_methods/get_master_release_spec.rb", "spec/wrapper_methods/search_spec.rb", "spec/wrapper_methods/get_artist_spec.rb", "spec/wrapper_methods/get_label_spec.rb", "spec/resource_spec.rb", "spec/resources/label_spec.rb", "spec/resources/generic_list_spec.rb", "spec/resources/artist_release_spec.rb", "spec/resources/artist_spec.rb", "spec/resources/release_artist_spec.rb", "spec/resources/search_spec.rb", "spec/resources/label_release_spec.rb", "spec/resources/release_label_spec.rb", "spec/resources/release_spec.rb", "spec/resources/master_release_spec.rb", "spec/resources/master_release_version_spec.rb", "spec/resources/video_spec.rb", "spec/resources/search_result_spec.rb", "spec/resources/image_spec.rb", "spec/resources/track_spec.rb", "spec/resources/format_spec.rb", "spec/wrapper_spec.rb", "spec/spec_helper.rb"]
-
-  s.platform = Gem::Platform::RUBY
-  
-  s.add_development_dependency "rspec", "= 2.12.0"
-  s.add_development_dependency "simplecov", "= 0.7.1"
-
-end

data/lib/wrapper/resource.rb

@@ -1,80 +0,0 @@
-# Represents a generic resource in the Discogs API.
-
-require File.dirname(__FILE__) + "/resource_mappings"
-
-class Discogs::Resource
-
-  include Discogs::ResourceMappings
-
-  def initialize(content)
-    @content = content
-  end
-
-  def original_content
-    @content
-  end
-
-  # Builds the resource with it's content.
-  def build!(remove_resp=true)
-    document = REXML::Document.new(@content, :ignore_whitespace_nodes => :all)
-    root_node = document.root
-
-    # Ignore the <resp> element if necessary.
-    if remove_resp and document.root.expanded_name == "resp"
-      root_node = root_node[0]
-    end
-
-    set_accessors_from_attributes(root_node)
-
-    # Traverse node children.
-    root_node.each_element do |element|
-      name = element.expanded_name.to_sym
-      setter = (name.to_s + "=").to_sym
-
-      singular = find_resource_for_name(name, :singular)
-      plural = singular ? nil : find_resource_for_name(name, :plural)
-
-      # Create an instance of the named resource and build it.
-      if !singular.nil?
-        nested_object = singular.send(:new, element.to_s)
-        self.send(setter, nested_object.build!)
-
-      # Setup an array and build each child.
-      elsif !plural.nil?
-        set_accessors_from_attributes(element)
-
-        self.send(setter, [])
-        element.each_element do |sub_element|
-          nested_object = plural.send(:new, sub_element.to_s)
-          self.send(name) << nested_object.build!
-        end
-
-      elsif self.respond_to? setter
-        self.send(setter, element.text)
-      end
-    end
- 
-    self
-  end
-
-  def build_with_resp!
-    build!(false)
-  end
-
- private
-
-  # Sets accessors on _self_ from the attributes of the given element.
-  def set_accessors_from_attributes(element)
-    element.attributes.each_attribute do |attribute|
-      setter = (attribute.expanded_name + "=").to_sym
-
-      if self.respond_to? setter
-        self.send(setter, attribute.value)
-      end
-    end
-  end
-
-end
-
-# Load in all of the resource definitions.
-Dir[File.join(File.dirname(__FILE__), "resources", "*.rb")].each { |file| require file }

data/lib/wrapper/resource_mappings.rb

@@ -1,80 +0,0 @@
-# Abstracts the resource-mapping class methods. 
-#
-# Each "resource" in the wrapper maps to one or more elements 
-# in the API response. This way they can be recursively built
-# without having to manually specify it in each class.
-
-module Discogs::ResourceMappings
-
-  def self.included(base)
-    base.extend ClassMethods
-  end
-
-  module ClassMethods
-
-    # Helper method to map resource to an element in the API response.
-    def map_to(*elements)
-      self.class_eval <<-EOF
-        def self.element_names
-          #{elements.inspect}
-        end
-      EOF
-    end
-
-    # Helper method to map pluralised resource to element in API response.
-    def map_to_plural(*elements)
-      self.class_eval <<-EOF
-        def self.plural_element_names
-          #{elements.inspect}
-        end
-      EOF
-    end
-
-    # Used by root classes (Discogs::Artist, etc) that should be built internally.
-    def no_mapping
-      self.class_eval <<-EOF
-        def self.element_names; []; end
-        def self.plural_element_names; []; end
-      EOF
-    end
-
-    # Element defaults to prevent excess boilerplate code.
-    def element_names
-      [ self.to_s.split("::")[-1].downcase.to_sym ]
-    end
-    def plural_element_names
-      [ (self.element_names[0].to_s + "s").to_sym ]
-    end
-
-  end
-
- private
-
-  def find_resource_for_name(name, type=:singular)
-    method = (type == :singular) ? :element_names : :plural_element_names
-
-    find_resource do |klass|
-      klass.constants.find do |const|
-        if klass.const_get(const).respond_to? method
-          klass.const_get(const).send(method).any? { |element| element.eql?(name) }
-        end
-      end
-    end
-  end
-
-  # Look in _namespace_ for a matching resource class.
-  # First looks in the children of _self_ namespace, and then looks more 
-  # generally. Returns nil if nothing is found.
-  def find_resource(namespace=self.class, &matcher)
-    match = matcher.call(namespace)
-
-    if match
-      match = namespace.const_get(match)
-    elsif namespace == self.class
-      match = find_resource(Discogs, &matcher)
-    end
-
-    return match
-  end
-
-end

data/lib/wrapper/resources/artist.rb

@@ -1,40 +0,0 @@
-# Represents an artist in the Discogs API.
-
-class Discogs::Artist < Discogs::Resource
-
-  no_mapping
-
-  attr_accessor :id,
-                :name,
-                :realname,
-                :images,
-                :urls,
-                :namevariations,
-                :aliases,
-                :members,
-                :releases,
-                :profile,
-                :data_quality
-
-  def main_releases
-    filter_releases("Main")
-  end
-
-  def bootlegs
-    filter_releases("UnofficialRelease")
-  end
-
-  def appearances
-    filter_releases("Appearance")
-  end
-
- private
-
-  # Simple helper for filtering a particular role of release.
-  def filter_releases(role)
-    self.releases.find_all do |release|
-      release.role == role
-    end
-  end
-
-end

data/lib/wrapper/resources/artist_release.rb

@@ -1,28 +0,0 @@
-# Represents an artist's release in the Discogs API.
-
-require File.dirname(__FILE__) + "/artist"
-
-class Discogs::Artist::Release < Discogs::Resource
-
-  attr_accessor :id,
-                :status,
-                :role,
-                :title,
-                :artist,
-                :format,
-                :year,
-                :label,
-                :thumb,
-                :trackinfo,
-                :main_release
-
-  # Will return either "master" or "release".
-  def release_type
-    if original_content =~ /^\<(\w+)\s/
-      $1
-    else
-      "release"
-    end
-  end
-
-end

data/lib/wrapper/resources/format.rb

@@ -1,11 +0,0 @@
-# Represents a release format in the Discogs API.
-
-require File.dirname(__FILE__) + "/release"
-
-class Discogs::Release::Format < Discogs::Resource
-
-  attr_accessor :name,
-                :qty,
-                :descriptions
-
-end

data/lib/wrapper/resources/generic_list.rb

@@ -1,29 +0,0 @@
-# Represents a generic list of items in the Discogs API.
-
-class Discogs::GenericList < Discogs::Resource
-
-  map_to :descriptions, :genres, :aliases, :namevariations, :styles, :urls, :members, :sublabels
-
-  map_to_plural :lists
-
-  # Overload build method to provide custom process for
-  # converting contents into something useful.
-  def build!
-    @items = []
-    document = REXML::Document.new(@content)
-
-    document.root.each_element do |element|
-      @items << element.text
-    end
-
-    @items
-  end
-
-  # Provides post-build access to the list.
-  def [](index)
-    if @items.is_a?(Array)
-      @items[index]
-    end
-  end
-
-end

data/lib/wrapper/resources/image.rb

@@ -1,11 +0,0 @@
-# Represents an image in the Discogs API.
-
-class Discogs::Image < Discogs::Resource
-
-  attr_accessor :uri,
-                :uri150,
-                :width,
-                :height,
-                :type
-
-end

data/lib/wrapper/resources/label.rb

@@ -1,16 +0,0 @@
-# Represents a label in the Discogs API.
-
-class Discogs::Label < Discogs::Resource
-
-  no_mapping
-
-  attr_accessor :name,
-                :contactinfo,
-                :profile,
-                :parentlabel,
-                :images,
-                :urls,
-                :sublabels,
-                :releases
-
-end

data/lib/wrapper/resources/label_release.rb

@@ -1,17 +0,0 @@
-# Represents a labels release in the Discogs API.
-
-require File.dirname(__FILE__) + "/label"
-
-class Discogs::Label::Release < Discogs::Resource
-
-  attr_accessor :id,
-                :status,
-                :type,
-                :catno,
-                :artist,
-                :title,
-                :format,
-                :year,
-                :trackinfo
-
-end

data/lib/wrapper/resources/master_release.rb

@@ -1,19 +0,0 @@
-# Represents a master release in the Discogs API.
-
-class Discogs::MasterRelease < Discogs::Resource
-
-  no_mapping
-
-  attr_accessor :id,
-                :styles,
-                :genres,
-                :main_release,
-                :notes,
-                :year,
-                :images,
-                :videos,
-                :tracklist,
-                :artists,
-                :versions
-
-end

data/lib/wrapper/resources/master_release_version.rb

@@ -1,17 +0,0 @@
-# Represents an master release version in the Discogs API.
-
-require File.dirname(__FILE__) + "/master_release"
-
-class Discogs::MasterRelease::Version < Discogs::Resource
-
-  attr_accessor :id,
-                :status,
-                :title,
-                :format,
-                :label,
-                :catno,
-                :country,
-                :released,
-                :thumb
-
-end

data/lib/wrapper/resources/release.rb

@@ -1,25 +0,0 @@
-# Represents a release in the Discogs API.
-
-class Discogs::Release < Discogs::Resource
-
-  no_mapping
-
-  attr_accessor :id,
-                :master_id,
-                :status,
-                :title,
-                :country,
-                :released,
-                :notes,
-                :images,
-                :videos,
-                :artists,
-                :extraartists,
-                :labels,
-                :formats,
-                :styles,
-                :genres,
-                :tracklist,
-                :identifiers
-
-end