Struct TrackFacts

pub struct TrackFacts {
    pub recording: Option<String>,
    pub score: Option<u8>,
    pub title: Option<String>,
    pub artists: Vec<String>,
    pub album: Option<String>,
    pub works: Vec<WorkLink>,
    pub credits: Vec<CreditLink>,
    pub relationships_complete: bool,
    pub relationships_for: Option<String>,
}

What a source says about one recorded performance.

A recording, not a release. AcoustID answers what is playing, and the same performance sits on the original album, the compilation and the deluxe reissue alike — so this identifies the track and says nothing about which pressing the file was ripped from, which the tags answer better.

AcoustID records arrive as Confidence::Matched: a fingerprint match is a strong guess and is wrong in ways that are easy to picture — two masterings of one recording fingerprint alike, and a very short or silent track matches a great deal. A later MusicBrainz identifier lookup is Confidence::Identified and can add relationship evidence to the same source record without turning it into a local tag.

Fields

recording: Option<String>

The MusicBrainz recording identifier the source named.

score: Option<u8>

How sure the source said it was, as a percentage.

Rounded on the way in, from the fraction the service states. A stored float compares badly — two records that are the same answer would not be equal — and the difference between 98.12 % and 98 % is one nobody acts on. What a reader wants is a number to put beside a tag.

title: Option<String>

The title, as the source spells it.

artists: Vec<String>

The artists credited, in the order given.

album: Option<String>

One release group the recording appears on, when the source named one.

works: Vec<WorkLink>

Compositions MusicBrainz explicitly says this recording realizes.

Kept as source evidence rather than copied into the catalog: the same recording may be linked to several works (for example a medley), and a later reconciliation must be able to show exactly who made each claim.

credits: Vec<CreditLink>

Credits attached directly to the recorded performance.

relationships_complete: bool

Whether the recording relationship lookup completed, including when it returned no work or credit. This distinguishes “nothing there” from an older record that has never been asked for rich relationships.

relationships_for: Option<String>

Recording selector whose completed lookup confirmed this identity.

A merged MusicBrainz ID can return a different canonical recording. Keeping the question separately lets a corrected local ID reopen the lookup without repeatedly requesting unchanged aliases. Refreshing the same canonical recording retains an earlier verified alias. Legacy receipts use their source identifier until the next successful lookup. A completed MusicBrainz snapshot with a consistent canonical recording can also establish this alias during identity checks, without overriding its confidence or explicit review.

Trait Implementations

impl Clone for TrackFacts

fn clone(&self) -> TrackFacts

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TrackFacts

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

Formats the value using the given formatter.

impl Default for TrackFacts

fn default() -> TrackFacts

Returns the “default value” for a type.

impl PartialEq for TrackFacts

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

Tests for self and other values to be equal, and is used by ==.

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

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

impl Eq for TrackFacts

impl StructuralPartialEq for TrackFacts