Struct musicbrainz_rs::entity::artist::Artist

pub struct Artist {

    pub id: String,
    pub name: String,
    pub sort_name: String,
    pub disambiguation: String,
    pub artist_type: Option<ArtistType>,
    pub gender: Option<Gender>,
    pub area: Option<Area>,
    pub begin_area: Option<Area>,
    pub relations: Option<Vec<Relation>>,
    pub releases: Option<Vec<Release>>,
    pub works: Option<Vec<Work>>,
    pub release_groups: Option<Vec<ReleaseGroup>>,
    pub recordings: Option<Vec<Recording>>,
    pub aliases: Option<Vec<Alias>>,
    pub tags: Option<Vec<Tag>>,
    pub genres: Option<Vec<Genre>>,
    pub rating: Option<Rating>,
    pub country: Option<String>,
    pub annotation: Option<String>,
    pub life_span: Option<LifeSpan>,
}

An artist is generally a musician (or musician persona), group of musicians, or other music professional (like a producer or engineer). Occasionally, it can also be a non-musical person (like a photographer, an illustrator, or a poet whose writings are set to music), or even a fictional character. For some other special cases, see special purpose artists.

Fields

id: String

See MusicBrainz Identifier.

name: String

The official name of an artist, be it a person or a band.

sort_name: String

The sort name is a variant of the artist name which would be used when sorting artists by name, such as in record shops or libraries. Among other things, sort names help to ensure that all the artists that start with “The” don’t end up up under “T”. The guidelines for sort names are the best place to check for more specific usage info.

disambiguation: String

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

artist_type: Option<ArtistType>

The type is used to state whether an artist is a person, a group, or something else.

gender: Option<Gender>

The gender is used to explicitly state whether a person or character identifies as male, female or neither. Groups do not have genders.

area: Option<Area>

The artist area, as the name suggests, indicates the area with which an artist is primarily identified with. It is often, but not always, its birth/formation country.

begin_area: Option<Area>

The artist begin area, as the name suggests, indicates the area with which an artist started to perform.

relations: Option<Vec<Relation>>

releases: Option<Vec<Release>>

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.

works: Option<Vec<Work>>

A work is a distinct intellectual or artistic creation, which can be expressed in the form of one or more audio recordings.

release_groups: Option<Vec<ReleaseGroup>>

recordings: Option<Vec<Recording>>

aliases: Option<Vec<Alias>>

Aliases are used to store alternate names or misspellings. For more information and examples, see the page about aliases.

tags: Option<Vec<Tag>>

genres: Option<Vec<Genre>>

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

rating: Option<Rating>

country: Option<String>

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.

life_span: Option<LifeSpan>

The begin and end dates indicate when an artist started and finished its existence. Its exact meaning depends on the type of artist:

• For a person Begin date represents date of birth, and end date represents date of death.

  • For a group (or orchestra/choir) Begin date represents the date when the group first formed: if a group dissolved and then reunited, the date is still that of when they first formed. End date represents the date when the group last dissolved: if a group dissolved and then reunited, the date is that of when they last dissolved (if they are together, it should be blank!). For listing other inactivity periods, just use the annotation and the “member of” relationships.

  • For a character Begin date represents the date (in real life) when the character concept was created. The End date should not be set, since new media featuring a character can be created at any time. In particular, the Begin and End date fields should not be used to hold the fictional birth or death dates of a character. (This information can be put in the annotation.)

  • For others There are no clear indications about how to use dates for artists of the type Other at the moment.

Trait Implementations

impl Browsable for Artist

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

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

const ENTITIES_FIELD: &'static str = "artists"

impl Browse<'_> for Artist

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

impl Clone for Artist

fn clone(&self) -> Artist

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Artist

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

Formats the value using the given formatter.

impl Default for Artist

fn default() -> Artist

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Artistwhere
    Artist: Default,

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

Deserialize this value from the given Serde deserializer.

impl Fetch<'_> for Artist

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

impl PartialEq<Artist> for Artist

fn eq(&self, other: &Artist) -> 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 Artist

fn path() -> &'static str

impl Search<'_> for Artist

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

impl Searchable for Artist

const CREATED_FIELD: &'static str = "created"

const COUNT_FIELD: &'static str = "count"

const OFFSET_FIELD: &'static str = "offset"

const ENTITIES_FIELD: &'static str = "artists"

impl Serialize for Artist

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 Artist