Class | MusicBrainz::Model::Release |
In: |
lib/rbrainz/model/release.rb
|
Parent: | Entity |
A release in the MusicBrainz DB.
A release within MusicBrainz is an Entity which contains Track objects. Releases may be of more than one type: There can be albums, singles, compilations, live recordings, official releases, bootlegs etc.
See: | musicbrainz.org/doc/Release. |
Note: | The current MusicBrainz server implementation supports only a limited set of types. See wiki.musicbrainz.org/ReleaseAttribute for more information. |
TYPE_NONE | = | NS_MMD_1 + 'None' | A type for not a type. Currently unsupported by MusicBrainz | |
TYPE_ALBUM | = | NS_MMD_1 + 'Album' | An album, perhaps better defined as a "Long Play" (LP) release, generally consists of previously unreleased material. This includes release re-issues, with or without bonus tracks. | |
TYPE_AUDIOBOOK | = | NS_MMD_1 + 'Audiobook' | An audiobook is a book read by a narrator without music. | |
TYPE_COMPILATION | = | NS_MMD_1 + 'Compilation' | A compilation is a collection of previously released tracks by one or more artists. Please note that this is a simplified description of a compilation. | |
TYPE_EP | = | NS_MMD_1 + 'EP' | An EP is a so-called "Extended Play" release and often contains the letters EP in the title. | |
TYPE_INTERVIEW | = | NS_MMD_1 + 'Interview' | An interview release contains an interview, generally with an Artist. | |
TYPE_LIVE | = | NS_MMD_1 + 'Live' | A release that was recorded live. | |
TYPE_REMIX | = | NS_MMD_1 + 'Remix' | A release that primarily contains remixed material. | |
TYPE_SINGLE | = | NS_MMD_1 + 'Single' | A single typically has one main song and possibly a handful of additional tracks or remixes of the main track. A single is usually named after its main song. | |
TYPE_SOUNDTRACK | = | NS_MMD_1 + 'Soundtrack' | A soundtrack is the musical score to a movie, TV series, stage show, computer game etc. | |
TYPE_SPOKENWORD | = | NS_MMD_1 + 'Spokenword' | Non-music spoken word releases. | |
TYPE_OTHER | = | NS_MMD_1 + 'Other' | Any release that does not fit or can‘t decisively be placed in any of the categories above. | |
TYPE_OFFICIAL | = | NS_MMD_1 + 'Official' | Any release officially sanctioned by the artist and/or their record company. (Most releases will fit into this category.) | |
TYPE_PROMOTION | = | NS_MMD_1 + 'Promotion' | A giveaway release or a release intended to promote an upcoming official release. (e.g. prerelease albums or releases included with a magazine, versions supplied to radio DJs for air-play, etc). | |
TYPE_BOOTLEG | = | NS_MMD_1 + 'Bootleg' | An unofficial/underground release that was not sanctioned by the artist and/or the record company. | |
TYPE_PSEUDO_RELEASE | = | NS_MMD_1 + 'PseudoRelease' | A pseudo-release is a duplicate release for translation/transliteration purposes. |
artist | [RW] | The main artist of this release. | ||
asin | [RW] |
The amazon shop identifier.
The ASIN is a 10-letter code (except for books) assigned by Amazon, which looks like ‘B000002IT2’ or ‘B00006I4YD’. |
||
discs | [R] |
The list of associated discs.
Note that under rare circumstances (identical TOCs), a Disc could be associated with more than one release. |
||
release_events | [R] |
The list of release events.
A Release may contain a list of so-called release events, each represented using a ReleaseEvent object. Release events specify where and when this release was, well, released. |
||
release_group | [RW] | The release group this release is part of. | ||
text_language | [RW] |
The language used in release and track titles.
To represent the language, the ISO-639-2/T standard is used, which provides three-letter terminological language codes like ‘ENG’, ‘DEU’, ‘JPN’, ‘KOR’, ‘ZHO’ or ‘YID’. Note that this refers to release and track titles, not lyrics.
|
||
text_script | [RW] |
The script used in release and track titles.
To represent the script, ISO-15924 script codes are used. Valid codes are, among others: ‘Latn’, ‘Cyrl’, ‘Hans’, ‘Hebr‘ Note that this refers to release and track titles, not lyrics.
|
||
title | [RW] | The title of this release. | ||
tracks | [R] | The list of tracks. | ||
types | [R] |
The list of types for this release.
To test for release types, you can use the constants TYPE_ALBUM, TYPE_SINGLE, etc. |
Returns the date of the earliest release event or nil.
See: | earliest_release_event |
Returns the earliest release date as an IncompleteDate.
This favours complete dates. For example, ‘2006-09’ is returned if there is ‘2000’, too. If there is no release event associated with this release, nil is returned.
See: | earliest_release_date |
Checks if this is a single artist‘s release.
Returns true if the release‘s main artist (artist) is also the main artist for all of the tracks. This is checked by comparing the artist IDs.
Note that the release‘s artist has to be set (see artist=) for this. The track artists may be unset.
Raises: | RuntimeError |