metal_archives 2.1.1 → 2.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 5b077092f1a7e727aee29d04339faf31468b704b
-  data.tar.gz: 00674c9f439ba8c1f8a014cd60c4da6ec5289e22
+  metadata.gz: 3d67ee1fe72c3fb58bf95f48ee68bda41232857e
+  data.tar.gz: cfa4704bb7020f4176ad6a14de0b979249e11976
 SHA512:
-  metadata.gz: 9217a15df5ae47a552a8214fba23a374bb9788611103d0366078aff6e72069505bf2d43fcfc0c437624aae8bbf3f9a342bbcfa67abd512ed712473a51dc56a9b
-  data.tar.gz: 22a44ac5667e462eab891c019c98f17340e2469ffa7ff71d79e5f6dc9b6d6a5eb5482ef10fcba9f0b4a320ad9fb9795d32f7df7b4122dd463bb865192613e6b2
+  metadata.gz: be9295ee982e7600ad2aba6f5a9ae60fdcdcb5db1039e51a76c18a2fedc53e7899e3ee3c068763c171a3a7a232cbca325d3885d07f1598c4852f73ba7c4b5e17
+  data.tar.gz: 7a121ab78954206854de8d73d1131030684864dccc68c53429ddc2054cb6cc836b7014b5f8044778992bcd27317caa2f8da0f6c020c4a7f72ae848fd1b84aa39

data/.rubocop.yml

@@ -1,6 +1,9 @@
 Metrics/LineLength:
   Max: 120
 
+Metrics/ClassLength:
+  Enabled: false
+
 Metrics/MethodLength:
   Enabled: false
 

data/lib/metal_archives.rb

@@ -20,11 +20,13 @@ require 'metal_archives/models/base_model'
 require 'metal_archives/models/label'
 require 'metal_archives/models/artist'
 require 'metal_archives/models/band'
+require 'metal_archives/models/release'
 
 require 'metal_archives/parsers/parser'
 require 'metal_archives/parsers/label'
 require 'metal_archives/parsers/artist'
 require 'metal_archives/parsers/band'
+require 'metal_archives/parsers/release'
 
 require 'metal_archives/http_client'
 

data/lib/metal_archives/models/band.rb

@@ -291,7 +291,7 @@ module MetalArchives
       #     - +:name+: +String+
       #     - +:exact+: +Boolean+
       #     - +:genre+: +String+
-      #     - +:country+: +ISO366::Country+
+      #     - +:country+: +ISO3166::Country+
       #     - +:year_formation+: rdoc-ref:Range of rdoc-ref:NilDate
       #     - +:comment+: +String+
       #     - +:status+: see rdoc-ref:Band.status
@@ -331,7 +331,7 @@ module MetalArchives
       #     - +:name+: +String+
       #     - +:exact+: +Boolean+
       #     - +:genre+: +String+
-      #     - +:country+: +ISO366::Country+
+      #     - +:country+: +ISO3166::Country+
       #     - +:year_formation+: rdoc-ref:Range of +Date+
       #     - +:comment+: +String+
       #     - +:status+: see rdoc-ref:Band.status
@@ -363,7 +363,7 @@ module MetalArchives
       #     - +:name+: +String+
       #     - +:exact+: +Boolean+
       #     - +:genre+: +String+
-      #     - +:country+: +ISO366::Country+
+      #     - +:country+: +ISO3166::Country+
       #     - +:year_formation+: rdoc-ref:Range of +Date+
       #     - +:comment+: +String+
       #     - +:status+: see rdoc-ref:Band.status

data/lib/metal_archives/models/release.rb

@@ -0,0 +1,353 @@
+# frozen_string_literal: true
+
+require 'date'
+
+module MetalArchives
+  ##
+  # Represents a release
+  #
+  class Release < MetalArchives::BaseModel
+    ##
+    # :attr_reader: id
+    #
+    # Returns +Integer+
+    #
+    property :id, :type => Integer
+
+    ##
+    # :attr_reader: title
+    #
+    # Returns +String+
+    #
+    # [Raises]
+    # - rdoc-ref:MetalArchives::Errors::InvalidIDError when no or invalid id
+    # - rdoc-ref:MetalArchives::Errors::APIError when receiving a status code >= 400 (except 404)
+    #
+    property :title
+
+    # TODO: band
+
+    ##
+    # :attr_reader: type
+    #
+    # Returns +:full_length+, +:live+, +:demo+, +:single+, +:ep+, +:video+, +:boxed_set+, +:split+, +:compilation+, +:split_video+, +:collaboration+
+    #
+    # [Raises]
+    # - rdoc-ref:MetalArchives::Errors::InvalidIDError when no or invalid id
+    # - rdoc-ref:MetalArchives::Errors::APIError when receiving a status code >= 400 (except 404)
+    #
+    enum :type, :values => %i[full_length live demo single ep video boxed_set split compilation split_video collaboration]
+
+    ##
+    # :attr_reader: date_released
+    #
+    # Returns rdoc-ref:NilDate
+    #
+    # [Raises]
+    # - rdoc-ref:MetalArchives::Errors::InvalidIDError when no or invalid id
+    # - rdoc-ref:MetalArchives::Errors::APIError when receiving a status code >= 400 (except 404)
+    #
+    property :date_released, :type => NilDate
+
+    ##
+    # :attr_reader_: catalog_id
+    #
+    # Return +String+
+    #
+    # [Raises]
+    # - rdoc-ref:MetalArchives::Errors::InvalidIDError when no or invalid id
+    # - rdoc-ref:MetalArchives::Errors::APIError when receiving a status code >= 400 (except 404)
+    #
+    property :catalog_id
+
+    ##
+    # :attr_reader_: version_description
+    #
+    # Return +String+
+    #
+    # [Raises]
+    # - rdoc-ref:MetalArchives::Errors::InvalidIDError when no or invalid id
+    # - rdoc-ref:MetalArchives::Errors::APIError when receiving a status code >= 400 (except 404)
+    #
+    property :version_description
+
+    # TODO: label
+
+    ##
+    # :attr_reader: format
+    #
+    # Returns +:cd+, +:cassette+, +:vinyl+, +:vhs+, +:dvd+, +:digital+, +:blu_ray+, +:other+
+    #
+    # [Raises]
+    # - rdoc-ref:MetalArchives::Errors::InvalidIDError when no or invalid id
+    # - rdoc-ref:MetalArchives::Errors::APIError when receiving a status code >= 400 (except 404)
+    #
+    property :format
+
+    ##
+    # :attr_reader: limitation
+    #
+    # Returns +Integer+
+    #
+    # [Raises]
+    # - rdoc-ref:MetalArchives::Errors::InvalidIDError when no or invalid id
+    # - rdoc-ref:MetalArchives::Errors::APIError when receiving a status code >= 400 (except 404)
+    #
+    property :limitation
+
+    # TODO: reviews
+    # TODO: songs
+    # TODO: lineup
+    # TODO: other versions
+    # TODO: links
+
+    ##
+    # :attr_reader: notes
+    #
+    # Returns raw HTML +String+
+    #
+    # [Raises]
+    # - rdoc-ref:MetalArchives::Errors::InvalidIDError when no or invalid id
+    # - rdoc-ref:MetalArchives::Errors::APIError when receiving a status code >= 400 (except 404)
+    #
+    property :notes
+
+    protected
+
+    ##
+    # Fetch the data and assemble the model
+    #
+    # [Raises]
+    # - rdoc-ref:MetalArchives::Errors::InvalidIDError when receiving a status code == 404
+    # - rdoc-ref:MetalArchives::Errors::APIError when receiving a status code >= 400 (except 404)
+    #
+    def assemble # :nodoc:
+      ## Base attributes
+      url = "#{MetalArchives.config.default_endpoint}albums/view/id/#{id}"
+      response = HTTPClient.get url
+
+      properties = Parsers::Release.parse_html response.body
+
+      properties
+    end
+
+    class << self
+      ##
+      # Find by ID
+      #
+      # Returns rdoc-ref:Release, even when ID is invalid (because the data is lazily fetched)
+      #
+      # [+id+]
+      #     +Integer+
+      #
+      def find(id)
+        return cache[id] if cache.include? id
+
+        Release.new :id => id
+      end
+
+      ##
+      # Find by ID (no lazy loading)
+      #
+      # Returns rdoc-ref:Release
+      #
+      # [Raises]
+      # - rdoc-ref:MetalArchives::Errors::InvalidIDError when no or invalid id
+      # - rdoc-ref:MetalArchives::Errors::APIError when receiving a status code >= 400 (except 404)
+      # - rdoc-ref:MetalArchives::Errors::ParserError when parsing failed. Please report this error.
+      #
+      # [+id+]
+      #     +Integer+
+      #
+      def find!(id)
+        obj = find id
+        obj.load! if obj && !obj.loaded?
+
+        obj
+      end
+
+      ##
+      # Find by attributes
+      #
+      # Refer to {MA's FAQ}[http://www.metal-archives.com/content/help?index=3#tab_db] for search tips.
+      #
+      # Returns rdoc-ref:Release or nil when no results
+      #
+      # [Raises]
+      # - rdoc-ref:MetalArchives::Errors::APIError when receiving a status code >= 400
+      # - rdoc-ref:MetalArchives::Errors::ParserError when parsing failed. Please report this error.
+      #
+      # [+query+]
+      #     Hash containing one or more of the following keys:
+      #     - +:band_name+: +String+
+      #     - +:title+: +String+
+      #     - +:from_year+: +Integer+
+      #     - +:from_month+: +Integer+
+      #     - +:to_year+: +Integer+
+      #     - +:to_month+: +Integer+
+      #     - +:country+: +ISO3166::Country+ or +Array+ of ISO3166::Country
+      #     - +:location+: +String+
+      #     - +:label_name+: +String+
+      #     - +:indie+: +Boolean+
+      #     - +:catalog_id+: +String+
+      #     - +:identifier+: +String+, identifier (barcode, matrix, etc.)
+      #     - +:recording_info+: +String+, recording information (studio, city, etc.)
+      #     - +:version_description+: +String+, version description (country, digipak, etc.)
+      #     - +:notes+: +String+
+      #     - +:genre+: +String+
+      #     - +:types+: +Array+ of +Symbol+, see rdoc-ref:Release.type
+      #     - +:formats+: +Array+ of +Symbol+, see rdoc-ref:Release.format
+      #
+      def find_by(query)
+        url = "#{MetalArchives.config.default_endpoint}search/ajax-advanced/searching/albums"
+        params = Parsers::Release.map_params query
+
+        response = HTTPClient.get url, params
+        json = JSON.parse response.body
+
+        return nil if json['aaData'].empty?
+
+        data = json['aaData'].first
+        id = Nokogiri::HTML(data[1]).xpath('//a/@href').first.value.delete('\\').split('/').last.gsub(/\D/, '').to_i
+
+        find id
+      end
+
+      ##
+      # Find by attributes (no lazy loading)
+      #
+      # Refer to {MA's FAQ}[http://www.metal-archives.com/content/help?index=3#tab_db] for search tips.
+      #
+      # Returns rdoc-ref:Release or nil when no results
+      #
+      # [Raises]
+      # - rdoc-ref:MetalArchives::Errors::APIError when receiving a status code >= 400
+      # - rdoc-ref:MetalArchives::Errors::ParserError when parsing failed. Please report this error.
+      #
+      # [+query+]
+      #     Hash containing one or more of the following keys:
+      #     - +:band_name+: +String+
+      #     - +:title+: +String+
+      #     - +:from_year+: +Integer+
+      #     - +:from_month+: +Integer+
+      #     - +:to_year+: +Integer+
+      #     - +:to_month+: +Integer+
+      #     - +:country+: +ISO3166::Country+ or +Array+ of ISO3166::Country
+      #     - +:location+: +String+
+      #     - +:label_name+: +String+
+      #     - +:indie+: +Boolean+
+      #     - +:catalog_id+: +String+
+      #     - +:identifier+: +String+, identifier (barcode, matrix, etc.)
+      #     - +:recording_info+: +String+, recording information (studio, city, etc.)
+      #     - +:version_description+: +String+, version description (country, digipak, etc.)
+      #     - +:notes+: +String+
+      #     - +:genre+: +String+
+      #     - +:types+: +Array+ of +Symbol+, see rdoc-ref:Release.type
+      #     - +:formats+: +Array+ of +Symbol+, see rdoc-ref:Release.format
+      #
+      def find_by!(query)
+        obj = find_by query
+        obj.load! if obj && !obj.loaded?
+
+        obj
+      end
+
+      ##
+      # Search by attributes
+      #
+      # Refer to {MA's FAQ}[http://www.metal-archives.com/content/help?index=3#tab_db] for search tips.
+      #
+      # Returns rdoc-ref:Collection of rdoc-ref:Release
+      #
+      # [Raises]
+      # - rdoc-ref:MetalArchives::Errors::APIError when receiving a status code >= 400
+      # - rdoc-ref:MetalArchives::Errors::ParserError when parsing failed. Please report this error.
+      #
+      # [+query+]
+      #     Hash containing one or more of the following keys:
+      #     - +:band_name+: +String+
+      #     - +:title+: +String+
+      #     - +:from_year+: +Integer+
+      #     - +:from_month+: +Integer+
+      #     - +:to_year+: +Integer+
+      #     - +:to_month+: +Integer+
+      #     - +:country+: +ISO3166::Country+ or +Array+ of ISO3166::Country
+      #     - +:location+: +String+
+      #     - +:label_name+: +String+
+      #     - +:indie+: +Boolean+
+      #     - +:catalog_id+: +String+
+      #     - +:identifier+: +String+, identifier (barcode, matrix, etc.)
+      #     - +:recording_info+: +String+, recording information (studio, city, etc.)
+      #     - +:version_description+: +String+, version description (country, digipak, etc.)
+      #     - +:notes+: +String+
+      #     - +:genre+: +String+
+      #     - +:types+: +Array+ of +Symbol+, see rdoc-ref:Release.type
+      #     - +:formats+: +Array+ of +Symbol+, see rdoc-ref:Release.format
+      #
+      def search_by(query)
+        url = "#{MetalArchives.config.default_endpoint}search/ajax-advanced/searching/albums"
+
+        params = Parsers::Release.map_params query
+
+        l = lambda do
+          @start ||= 0
+
+          if @max_items && @start >= @max_items
+            []
+          else
+            response = HTTPClient.get url, params.merge(:iDisplayStart => @start)
+            json = JSON.parse response.body
+
+            @max_items = json['iTotalRecords']
+
+            objects = []
+
+            json['aaData'].each do |data|
+              # Create Release object for every ID in the results list
+              id = Nokogiri::HTML(data.first).xpath('//a/@href').first.value.delete('\\').split('/').last.gsub(/\D/, '').to_i
+              objects << Release.find(id)
+            end
+
+            @start += 200
+
+            objects
+          end
+        end
+
+        MetalArchives::Collection.new l
+      end
+
+      ##
+      # Search by title, resolves to rdoc-ref:Release.search_by <tt>(:title => title)</tt>
+      #
+      # Refer to {MA's FAQ}[http://www.metal-archives.com/content/help?index=3#tab_db] for search tips.
+      #
+      # Returns (possibly empty) +Array+ of rdoc-ref:Release
+      #
+      # [Raises]
+      # - rdoc-ref:MetalArchives::Errors::APIError when receiving a status code >= 400
+      # - rdoc-ref:MetalArchives::Errors::ArgumentError when +title+ isn't a +String+
+      #
+      # [+title+]
+      #     +String+
+      #
+      def search(title)
+        raise MetalArchives::Errors::ArgumentError unless title.is_a? String
+        search_by :title => title
+      end
+
+      ##
+      # Get all releases
+      #
+      # Returns rdoc-ref:Collection of rdoc-ref:Release
+      #
+      # [Raises]
+      # - rdoc-ref:MetalArchives::Errors::APIError when receiving a status code >= 400
+      # - rdoc-ref:MetalArchives::Errors::ParserError when parsing failed. Please report this error.
+      #
+      def all
+        search ''
+      end
+    end
+  end
+end

data/lib/metal_archives/parsers/release.rb

@@ -0,0 +1,233 @@
+# frozen_string_literal: true
+
+require 'json'
+require 'date'
+
+module MetalArchives
+  module Parsers
+    ##
+    # Release parser
+    #
+    class Release < Parser # :nodoc:
+      class << self
+        TYPE_TO_QUERY = {
+          :full_length => 1,
+          :live => 2,
+          :demo => 3,
+          :single => 4,
+          :ep => 5,
+          :video => 6,
+          :boxed_set => 7,
+          :split => 8,
+          :compilation => 10,
+          :split_video => 12,
+          :collaboration => 13
+        }.freeze
+
+        TYPE_TO_SYM = {
+          'Full-length' => :full_length,
+          'Live album' => :live,
+          'Demo' => :demo,
+          'Single' => :single,
+          'EP' => :ep,
+          'Video' => :video,
+          'Boxed set' => :boxed_set,
+          'Split' => :split,
+          'Compilation' => :compilation,
+          'Split video' => :split_video,
+          'Collaboration' => :collaboration
+        }.freeze
+
+        FORMAT_TO_QUERY = {
+          :cd => 'CD',
+          :cassette => 'Cassette',
+          :vinyl => 'Vinyl*',
+          :vhs => 'VHS',
+          :dvd => 'DVD',
+          :digital => 'Digital',
+          :blu_ray => 'Blu-ray*',
+          :other => 'Other'
+        }.freeze
+
+        FORMAT_TO_SYM = {
+          'CD' => :cd,
+          'Cassette' => :cassette,
+          'VHS' => :vhs,
+          'DVD' => :dvd,
+          'Digital' => :digital,
+          'Other' => :other
+        }
+
+        ##
+        # Map attributes to MA attributes
+        #
+        # Returns +Hash+
+        #
+        # [+params+]
+        #     +Hash+
+        #
+        def map_params(query)
+          params = {
+            :bandName => query[:band_name] || '',
+            :releaseTitle => query[:title] || '',
+            :releaseYearFrom => query[:from_year] || '',
+            :releaseMonthFrom => query[:from_month] || '',
+            :releaseYearTo => query[:to_year] || '',
+            :releaseMonthTo => query[:to_month] || '',
+            :country => map_countries(query[:country]) || '',
+            :location => query[:location] || '',
+            :releaseLabelName => query[:label_name] || '',
+            :releaseCatalogNumber => query[:catalog_id] || '',
+            :releaseIdentifiers => query[:identifier] || '',
+            :releaseRecordingInfo => query[:recording_info] || '',
+            :releaseDescription => query[:version_description] || '',
+            :releaseNotes => query[:notes] || '',
+            :genre => query[:genre] || '',
+            :releaseType => map_types(query[:types]),
+            :releaseFormat => map_formats(query[:formats])
+          }
+
+          params
+        end
+
+        ##
+        # Parse main HTML page
+        #
+        # Returns +Hash+
+        #
+        # [Raises]
+        # - rdoc-ref:MetalArchives::Errors::ParserError when parsing failed. Please report this error.
+        #
+        def parse_html(response)
+          props = {}
+          doc = Nokogiri::HTML response
+
+          props[:title] = sanitize doc.css('#album_info .album_name a').first.content
+
+          doc.css('#album_info dl').each do |dl|
+            dl.search('dt').each do |dt|
+              content = sanitize dt.next_element.content
+
+              next if content == 'N/A'
+
+              case sanitize(dt.content)
+              when 'Type:'
+                props[:type] = map_type content
+              when 'Release date:'
+                begin
+                  props[:date_released] = NilDate.parse content
+                rescue MetalArchives::Errors::ArgumentError => e
+                  dr = Date.parse content
+                  props[:date_released] = NilDate.new dr.year, dr.month, dr.day
+                end
+              when 'Catalog ID:'
+                props[:catalog_id] = content
+              when 'Identifier:'
+                props[:identifier] = content
+              when 'Version desc.:'
+                props[:version_description] = content
+              when 'Label:'
+                # TODO: label
+              when 'Format:'
+                props[:format] = map_format content
+              when 'Limitation:'
+                props[:limitation] = content.to_i
+              when 'Reviews:'
+                next if content == 'None yet'
+                # TODO: reviews
+              else
+                raise MetalArchives::Errors::ParserError, "Unknown token: #{dt.content}"
+              end
+            end
+          end
+
+          props
+        rescue => e
+          e.backtrace.each { |b| MetalArchives.config.logger.error b }
+          raise Errors::ParserError, e
+        end
+
+        private
+
+        ##
+        # Map MA countries to query parameters
+        #
+        # Returns +Array+ of +ISO3166::Country+
+        #
+        # [+types+]
+        #     +Array+ containing one or more +String+s
+        #
+        def map_countries(countries)
+          countries && countries.map { |c| c.alpha2 }
+        end
+
+        ##
+        # Map MA release type to query parameters
+        #
+        # Returns +Array+ of +Integer+
+        #
+        # [+types+]
+        #     +Array+ containing one or more +Symbol+, see rdoc-ref:Release.type
+        #
+        def map_types(type_syms)
+          return unless type_syms
+
+          types = []
+          type_syms.each do |type|
+            raise MetalArchives::Errors::ParserError, "Unknown type: #{type}" unless TYPE_TO_QUERY[type]
+
+            types << TYPE_TO_QUERY[type]
+          end
+
+          types
+        end
+
+        ##
+        # Map MA release type to +Symbol+
+        #
+        # Returns +Symbol+, see rdoc-ref:Release.type
+        #
+        def map_type(type)
+          raise MetalArchives::Errors::ParserError, "Unknown type: #{type}" unless TYPE_TO_SYM[type]
+
+          TYPE_TO_SYM[type]
+        end
+
+        ##
+        # Map MA release format to query parameters
+        #
+        # Returns +Array+ of +Integer+
+        #
+        # [+types+]
+        #     +Array+ containing one or more +Symbol+, see rdoc-ref:Release.type
+        #
+        def map_formats(format_syms)
+          return unless format_syms
+
+          formats = []
+          format_syms.each do |format|
+            raise MetalArchives::Errors::ParserError, "Unknown format: #{format}" unless FORMAT_TO_QUERY[format]
+
+            formats << FORMAT_TO_QUERY[format]
+          end
+
+          formats
+        end
+
+        ##
+        # Map MA release format to +Symbol+
+        #
+        # Returns +Symbol+, see rdoc-ref:Release.format
+        #
+        def map_format(format)
+          return :vinyl if format =~ /[Vv]inyl/
+          return :blu_ray if format =~ /[Bb]lu.?[Rr]ay/
+
+          raise MetalArchives::Errors::ParserError, "Unknown format: #{format}" unless FORMAT_TO_SYM[format]
+
+          FORMAT_TO_SYM[format]
+        end
+      end
+    end
+  end
+end

data/lib/metal_archives/version.rb

@@ -4,5 +4,5 @@ module MetalArchives
   ##
   # MetalArchives API version
   #
-  VERSION = '2.1.1'
+  VERSION = '2.2.0'
 end

data/spec/models/release_spec.rb

@@ -0,0 +1,133 @@
+# frozen_string_literal: true
+
+RSpec.describe MetalArchives::Release do
+  describe 'properties' do
+    it 'Tales of Ancient Prophecies has properties' do
+      release = MetalArchives::Release.find 416934
+
+      expect(release).to be_instance_of MetalArchives::Release
+      expect(release.id).to eq 416934
+      expect(release.title).to eq 'Tales of Ancient Prophecies'
+      expect(release.type).to eq :full_length
+      expect(release.date_released).to eq MetalArchives::NilDate.new(2014, 6, 4)
+      expect(release.catalog_id).to eq 'BLOD091CD'
+      expect(release.version_description).to be_nil
+      expect(release.format).to eq :cd
+      expect(release.limitation).to be_nil
+      expect(release.notes).to be_nil
+    end
+
+    it '...And Oceans has properties' do
+      release = MetalArchives::Release.find 123563
+
+      expect(release).to be_instance_of MetalArchives::Release
+      expect(release.id).to eq 123563
+      expect(release.title).to eq '...and Oceans'
+      expect(release.type).to eq :compilation
+      expect(release.date_released).to eq MetalArchives::NilDate.new(2000)
+      expect(release.catalog_id).to eq 'NMLP 025'
+      expect(release.version_description).to be_nil
+      expect(release.format).to eq :vinyl
+      expect(release.limitation).to be_nil
+      expect(release.notes).to be_nil
+    end
+
+    it 'uses NilDate' do
+      release = MetalArchives::Release.find 123563
+
+      expect(release.title).to eq '...and Oceans'
+      expect(release.date_released).to be_instance_of MetalArchives::NilDate
+      expect(release.date_released).to eq MetalArchives::NilDate.new(2000, nil, nil)
+    end
+  end
+
+  describe 'methods' do
+    describe 'find' do
+      it 'finds a release' do
+        release = MetalArchives::Release.find 416934
+
+        expect(release).not_to be_nil
+        expect(release).to be_instance_of MetalArchives::Release
+        expect(release.id).to eq 416934
+        expect(release.title).to eq 'Tales of Ancient Prophecies'
+      end
+
+      it 'lazily loads' do
+        release = MetalArchives::Release.find -1
+
+        expect(release).to be_instance_of MetalArchives::Release
+      end
+    end
+
+    describe 'find!' do
+      it 'finds a release' do
+        release = MetalArchives::Release.find! 416934
+
+        expect(release).to be_instance_of MetalArchives::Release
+        expect(release.title).to eq 'Tales of Ancient Prophecies'
+      end
+
+      it 'raises on invalid id' do
+        expect(-> { MetalArchives::Release.find! -1 }).to raise_error MetalArchives::Errors::APIError
+        expect(-> { MetalArchives::Release.find! 0 }).to raise_error MetalArchives::Errors::InvalidIDError
+        expect(-> { MetalArchives::Release.find! nil }).to raise_error MetalArchives::Errors::InvalidIDError
+      end
+    end
+
+    describe 'find_by' do
+      it 'finds a release by title' do
+        release = MetalArchives::Release.find_by :title => 'Tales of Ancient Prophecies'
+
+        expect(release).to be_instance_of MetalArchives::Release
+        expect(release.id).to eq 416934
+      end
+
+      it 'returns nil on invalid id' do
+        release = MetalArchives::Release.find_by :title => 'SomeNonExistantName'
+
+        expect(release).to be_nil
+      end
+    end
+
+    describe 'find_by!' do
+      it 'finds a release' do
+        release = MetalArchives::Release.find_by! :title => 'Tales of Ancient Prophecies'
+
+        expect(release).to be_instance_of MetalArchives::Release
+        expect(release.id).to eq 416934
+      end
+
+      it 'returns nil on invalid id' do
+        release = MetalArchives::Release.find_by! :title => 'SomeNonExistantName'
+
+        expect(release).to be_nil
+      end
+    end
+
+    describe 'search' do
+      it 'returns a collection' do
+        collection = MetalArchives::Release.search 'Rhapsody'
+
+        expect(collection).to be_instance_of MetalArchives::Collection
+        expect(collection.first).to be_instance_of MetalArchives::Release
+      end
+
+      it 'returns an empty collection' do
+        expect(MetalArchives::Release.search 'SomeNoneExistantName').to be_empty
+      end
+
+      it 'searches by title' do
+        expect(MetalArchives::Release.search_by(:title => 'Rhapsody').count).to eq 13
+        # expect(MetalArchives::Release.search_by(:title => 'Lost Horizon').count).to eq 3
+        # expect(MetalArchives::Release.search_by(:title => 'Lost Horizon', :exact => true).count).to eq 2
+        # expect(MetalArchives::Release.search_by(:title => 'Alquimia', :genre => 'Melodic Power').count).to eq 2
+      end
+    end
+
+    describe 'all' do
+      it 'returns a collection' do
+        expect(MetalArchives::Release.all).to be_instance_of MetalArchives::Collection
+      end
+    end
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: metal_archives
 version: !ruby/object:Gem::Version
-  version: 2.1.1
+  version: 2.2.0
 platform: ruby
 authors:
 - Florian Dejonckheere
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2017-06-12 00:00:00.000000000 Z
+date: 2017-06-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: byebug
@@ -220,10 +220,12 @@ files:
 - lib/metal_archives/models/band.rb
 - lib/metal_archives/models/base_model.rb
 - lib/metal_archives/models/label.rb
+- lib/metal_archives/models/release.rb
 - lib/metal_archives/parsers/artist.rb
 - lib/metal_archives/parsers/band.rb
 - lib/metal_archives/parsers/label.rb
 - lib/metal_archives/parsers/parser.rb
+- lib/metal_archives/parsers/release.rb
 - lib/metal_archives/utils/collection.rb
 - lib/metal_archives/utils/lru_cache.rb
 - lib/metal_archives/utils/nil_date.rb
@@ -239,6 +241,7 @@ files:
 - spec/models/artist_spec.rb
 - spec/models/band_spec.rb
 - spec/models/base_model_spec.rb
+- spec/models/release_spec.rb
 - spec/parser_spec.rb
 - spec/spec_helper.rb
 - spec/support/factory_girl.rb
@@ -280,6 +283,7 @@ test_files:
 - spec/models/artist_spec.rb
 - spec/models/band_spec.rb
 - spec/models/base_model_spec.rb
+- spec/models/release_spec.rb
 - spec/parser_spec.rb
 - spec/spec_helper.rb
 - spec/support/factory_girl.rb