Struct musicbrainz_rs::entity::release::Release

pub struct Release {

    pub id: String,
    pub title: String,
    pub status_id: Option<String>,
    pub status: Option<ReleaseStatus>,
    pub date: Option<NaiveDate>,
    pub country: Option<String>,
    pub quality: Option<ReleaseQuality>,
    pub barcode: Option<String>,
    pub disambiguation: Option<String>,
    pub packaging_id: Option<String>,
    pub packaging: Option<ReleasePackaging>,
    pub relations: Option<Vec<Relation>>,
    pub release_group: Option<ReleaseGroup>,
    pub artist_credit: Option<Vec<ArtistCredit>>,
    pub media: Option<Vec<Media>>,
    pub label_info: Option<Vec<LabelInfo>>,
    pub tags: Option<Vec<Tag>>,
    pub aliases: Option<Vec<Alias>>,
    pub genres: Option<Vec<Genre>>,
    pub annotation: Option<String>,
}

A MusicBrainz release represents the unique release (i.e. issuing) of a product on a specific date with specific release information such as the country, label, barcode and packaging. If you walk into a store and purchase an album or single, they are each represented in MusicBrainz as one release.

Each release belongs to a release group and contains at least one medium (commonly referred to as a disc when talking about a CD release). Each medium has a tracklist. A medium is the actual physical medium that stores the audio content. This means that each CD in a multi-disc release will be entered as separate mediums within the release, and that both sides of a vinyl record or cassette will exist on one medium. Mediums have a format (e.g. CD, DVD, vinyl, and cassette) and can optionally also have a title. Sometimes a medium can be a side of a disc. For example, the two sides of a hybrid SACD (the CD side and the SACD side) should be entered as two mediums. Tracklists represent the set and ordering of tracks as listed on a liner, and the same tracklist can appear on more than one release. For example, a boxset compilation that contains previously released CDs would share the same tracklists as the separate releases.

Fields

id: String

See MusicBrainz Identifier.

title: String

The title of the release.

status_id: Option<String>

status: Option<ReleaseStatus>

The status describes how “official” a release is.

date: Option<NaiveDate>

The date the release was issued.

country: Option<String>

The country the release was issued in.

quality: Option<ReleaseQuality>

Data quality indicates how good the data for a release is. It is not a mark of how good or bad the music itself is - for that, use ratings.

barcode: Option<String>

The barcode, if the release has one. The most common types found on releases are 12-digit UPCs and 13-digit EANs.

disambiguation: Option<String>

The disambiguation comments are fields in the database used to help distinguish identically named artists, labels and other entities.

packaging_id: Option<String>

packaging: Option<ReleasePackaging>

The physical packaging that accompanies the release. See the list of packaging for more information.

relations: Option<Vec<Relation>>

release_group: Option<ReleaseGroup>

The release group associated with this release.

artist_credit: Option<Vec<ArtistCredit>>

Artist credits indicate who is the main credited artist (or artists) for releases, release groups, tracks and recordings, and how they are credited.

media: Option<Vec<Media>>

label_info: Option<Vec<LabelInfo>>

The label which issued the release. There may be more than one.

tags: Option<Vec<Tag>>

aliases: Option<Vec<Alias>>

Aliases are alternate names for a release.

genres: Option<Vec<Genre>>

Genres are currently supported in MusicBrainz as part of the tag system.

annotation: Option<String>

Annotations are text fields, functioning like a miniature wiki, that can be added to any existing artists, labels, recordings, releases, release groups and works.

Trait Implementations

impl Browsable for Release

const COUNT_FIELD: &'static str = "release-count"

const OFFSET_FIELD: &'static str = "release-offset"

const ENTITIES_FIELD: &'static str = "releases"

impl Browse<'_> for Release

fn browse() -> BrowseQuery<Self>where
    Self: Sized + Path<'a>,

impl Clone for Release

fn clone(&self) -> Release

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Release

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Release

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>where
    __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Fetch<'_> for Release

fn fetch() -> FetchQuery<Self>where
    Self: Sized + Path<'a>,

impl<'a> FetchCoverart<'a> for Release

fn get_coverart(&self) -> FetchCoverartQuery<Self>

fn fetch_coverart() -> FetchCoverartQuery<Self>where
    Self: Sized + Path<'a>,

impl PartialEq<Release> for Release

fn eq(&self, other: &Release) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Path<'_> for Release

fn path() -> &'static str

impl Search<'_> for Release

fn search(query: String) -> SearchQuery<Self>where
    Self: Sized + Path<'a>,

impl Searchable for Release

const CREATED_FIELD: &'static str = "created"

const COUNT_FIELD: &'static str = "count"

const OFFSET_FIELD: &'static str = "offset"

const ENTITIES_FIELD: &'static str = "releases"

impl Serialize for Release

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>where
    __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for Release