Class: ListenBrainz::ReleaseGroup

Inherits:

Base

• Object
• Dry::Struct
• Base
• ListenBrainz::ReleaseGroup

Defined in:

lib/listenbrainz/models/release_group.rb

Overview

Model class for release groups.

Defined Under Namespace

Classes: Payload

Instance Attribute Summary

• #artist_mbids ⇒ Array<String> readonly
• #artist_name ⇒ String readonly
• #listen_count ⇒ Integer readonly
• #release_group_mbid ⇒ String^? (also: #mbid) readonly
• #release_group_name ⇒ String^? (also: #name) readonly

Class Method Summary

• .get(username = ListenBrainz.client.username, count: nil, offset: nil, range: nil) ⇒ Payload

  Retrieves the top release groups for the given user.

• .sitewide(count: nil, offset: nil, range: nil) ⇒ Payload

  Retrieves site-wide top release groups.

Methods inherited from Base

#as_json

Instance Attribute Details

#artist_mbids ⇒ Array<String> (readonly)

Returns:

• (Array<String>)

# File 'lib/listenbrainz/models/release_group.rb', line 70

attribute :artist_mbids, Types::Array.of(Types::String)

#artist_name ⇒ String (readonly)

Returns:

• (String)

# File 'lib/listenbrainz/models/release_group.rb', line 74

attribute :artist_name, Types::String

#listen_count ⇒ Integer (readonly)

Returns:

• (Integer)

# File 'lib/listenbrainz/models/release_group.rb', line 78

attribute :listen_count, Types::Integer

#release_group_mbid ⇒ String^? (readonly) Also known as: mbid

Returns:

• (String, nil)

# File 'lib/listenbrainz/models/release_group.rb', line 82

attribute? :release_group_mbid, Types::String.optional

#release_group_name ⇒ String^? (readonly) Also known as: name

Returns:

• (String, nil)

# File 'lib/listenbrainz/models/release_group.rb', line 87

attribute? :release_group_name, Types::String.optional

Class Method Details

.get(username = ListenBrainz.client.username, count: nil, offset: nil, range: nil) ⇒ Payload

Retrieves the top release groups for the given user.

Parameters:

• username (String, nil) (defaults to: ListenBrainz.client.username)
• count (Integer, nil) (defaults to: nil)
• offset (Integer, nil) (defaults to: nil)
• range (Symbol, nil) (defaults to: nil)

Returns:

• (Payload)

See Also:

• https://rain0r.github.io/listenbrainz-openapi/index.html#/lbStats/topReleaseGroupsForUser

# File 'lib/listenbrainz/models/release_group.rb', line 18

def self.get(
  username = ListenBrainz.client.username, count: nil, offset: nil,
  range: nil
)
  params = { count:, offset:, range: }.compact
  ListenBrainz.client.query(
    :get, "1/stats/user/#{username}/release-groups", params:
  ).fetch(:payload).then { Payload.new(_1) }
end

.sitewide(count: nil, offset: nil, range: nil) ⇒ Payload

Retrieves site-wide top release groups.

Parameters:

• count (Integer, nil) (defaults to: nil)
• offset (Integer, nil) (defaults to: nil)
• range (Symbol, nil) (defaults to: nil)

Returns:

• (Payload)

See Also:

• https://rain0r.github.io/listenbrainz-openapi/index.html#/lbStats/sitewideTopReleaseGroups

# File 'lib/listenbrainz/models/release_group.rb', line 38

def self.sitewide(count: nil, offset: nil, range: nil)
  params = { count:, offset:, range: }.compact
  ListenBrainz.client.query(
    :get, '1/stats/sitewide/release-groups', params:
  ).fetch(:payload).then { Payload.new(_1) }
end