class MetalArchives::Artist

Represents a single performer (but not a solo artist)

Attributes

aliases[R]

Returns Array of String

Raises
bands[R]

Returns Array of Hash containing the following keys

Raises
bands

  • :band: Band

  • :active: Boolean

  • :date_active: Array of Range containing NilDate

  • :role: String

biography[R]

Returns raw HTML String

Raises
cause_of_death[R]

Returns String

Raises
country[R]

Returns ISO3166::Country

Raises
date_of_birth[R]

Returns NilDate

Raises
date_of_death[R]

Returns NilDate

Raises
gender[R]

Returns Symbol, either :male or :female

Raises
id[R]

Returns Integer

location[R]

Returns String

Raises
name[R]

Returns String

Raises
photo[R]

Returns URI (rewritten if config option was enabled)

Raises
trivia[R]

Returns raw HTML String

Raises

Protected Class Methods

all() click to toggle source

Get all artists

Returns Collection of Artist

Raises 
# File lib/metal_archives/models/artist.rb, line 359
def all
  search ""
end
find(id) click to toggle source

Find by ID

Returns Artist, even when ID is invalid (because the data is lazily fetched)

id

Integer

# File lib/metal_archives/models/artist.rb, line 222
def find(id)
  return cache[id] if cache.include? id

  Artist.new id: id
end
find!(id) click to toggle source

Find by ID (no lazy loading)

Returns Artist

Raises
id

Integer

# File lib/metal_archives/models/artist.rb, line 241
def find!(id)
  obj = find id
  obj.load! if obj && !obj.loaded?

  obj
end
find_by(query) click to toggle source

Find by attributes

Returns Artist or nil when no results

Raises
query

Hash containing one or more of the following keys:

  • :name: String

# File lib/metal_archives/models/artist.rb, line 262
def find_by(query)
  raise MetalArchives::Errors::ArgumentError unless query.include? :name

  url = "#{MetalArchives.config.default_endpoint}search/ajax-artist-search/"
  params = Parsers::Artist.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.first).xpath("//a/@href").first.value.delete('\\').split("/").last.gsub(/\D/, "").to_i

  find id
end
find_by!(query) click to toggle source

Find by attributes (no lazy loading)

Returns Artist or nil when no results

Raises
query

Hash containing one or more of the following keys:

  • :name: String

# File lib/metal_archives/models/artist.rb, line 294
def find_by!(query)
  obj = find_by query
  obj.load! if obj && !obj.loaded?

  obj
end
search(name) click to toggle source

Search by name

Returns Collection of Artist

Raises
name

String

# File lib/metal_archives/models/artist.rb, line 314
def search(name)
  raise MetalArchives::Errors::ArgumentError unless name.is_a? String

  url = "#{MetalArchives.config.default_endpoint}search/ajax-artist-search/"
  query = { name: name }

  params = Parsers::Artist.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 Artist 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 << Artist.find(id)
      end

      @start += 200

      objects
    end
  end

  MetalArchives::Collection.new l
end