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:
- the release-group identifier, when your tags carry one, including a trusted exact lookup’s verified alias. Edition IDs never establish groups.
- the normalised title, otherwise.
text::normalizeis 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.