Function absent

Source
pub fn absent<'a>(
    catalog: &Catalog,
    held: &'a Sources,
    aside: &[SetAside],
    everything: bool,
) -> Vec<Absent<'a>>
Expand description

What is credited to your artists and not on your shelf.

Derived, never stored. The comparison happens here, at the moment of reading, so the day an album is added to the library it stops being listed — with nothing to update and nothing to go stale.

Two ways of recognising a record you already have, in this order:

  1. the release-group identifier, when your tags carry one, including a trusted exact lookup’s verified alias. Edition IDs never establish groups.
  2. the normalised title, otherwise. text::normalize is the same function that decides two spellings are one name everywhere else in this program, so a shelf that says “Kind Of Blue” is not told it is missing “Kind of Blue”.

Two things are held back, and everything lifts both.

Only studio albums are reported — see KnownRelease::is_studio_album for why a complete discography would be a true and useless answer — and only records the reader has not set aside. Those are the report’s two filters, and --all is one word for “hold nothing back”, so it lifts both and every row that came back this way carries the reason it would not normally be here. A filter is only honest when the reader can turn it off: saying what is left out and offering no way to see it is a locked door with a label on it.