Files
minstrel/internal/library/mbids.go
T
bvandeusenandClaude Opus 5.5 7e6228c13f
release / govulncheck (push) Successful in 20s
release / web (push) Successful in 1m20s
release / go (push) Successful in 1m37s
release / integration (push) Successful in 5m15s
release / android (push) Successful in 5m26s
release / Build signed APK (releases and dev) (push) Successful in 5m45s
release / Attach APK to the Release (tag releases only) (push) Skipped
release / Build + push container image (push) Successful in 16s
release / Verify release artifacts (tag releases only) (push) Skipped
docs: library comments say what the scanner and resolver do, not how they came to be (#6277)
Rewrites the internal/library comment blocks to rule 32. Task, milestone,
decision and rule ids are gone; the incidents behind them are restated as
the constraint they left (why a file is deleted before its row, why the
missing mark is a mark, why duplicates block on duration). Counts and
album names from one library are dropped from production comments; test
comments keep the names their fixtures use. The tagReadVersion log keeps
each version's before and after, without the measurements.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-23 12:27:34 -04:00

67 lines
2.4 KiB
Go

package library
import (
"strings"
"github.com/dhowden/tag"
"github.com/dhowden/tag/mbz"
)
// TagMBIDs is what a file's MusicBrainz Picard tags name. Empty means the
// tag is absent.
type TagMBIDs struct {
// Release is musicbrainz_albumid: one edition, what albums.mbid stores.
Release string
Artist string
// ReleaseGroup is musicbrainz_releasegroupid. Wants name albums by
// release group, so re-acquisition and request completion key on it.
ReleaseGroup string
// Recording is what tracks.mbid stores and the ListenBrainz Labs
// similar-recordings API keys on.
Recording string
}
// ReadTagMBIDs reads a file's MusicBrainz IDs, for the scanner, the MBID
// backfills and the importer alike.
//
// Delegates to dhowden/tag/mbz, which knows the per-format Raw() conventions:
// - Vorbis (FLAC/OGG/Opus) keys are lowercased by the parser.
// - ID3v2 (MP3) TXXX frames are stored under "TXXX"/"TXXX_N" with
// a *tag.Comm value whose Description holds the Picard tag name.
// - MP4 (M4A) freeform iTunes atoms are stored under their bare sub-name.
//
// mbz maps keys by name alone, and Picard names the recording differently
// in Vorbis: MUSICBRAINZ_TRACKID there is the recording (the release track
// is MUSICBRAINZ_RELEASETRACKID), so mbz files it under mbz.Track, its name
// for the release track. Read mbz.Recording alone and every FLAC has no
// recording id.
func ReadTagMBIDs(m tag.Metadata) TagMBIDs {
info := mbz.Extract(m)
ids := TagMBIDs{
Release: cleanMBID(info.Get(mbz.Album)),
Artist: cleanMBID(info.Get(mbz.Artist)),
ReleaseGroup: cleanMBID(info.Get(mbz.ReleaseGroup)),
Recording: cleanMBID(info.Get(mbz.Recording)),
}
if ids.Recording == "" && m.Format() == tag.VORBIS {
ids.Recording = cleanMBID(info.Get(mbz.Track))
}
return ids
}
// cleanMBID takes the first non-empty NUL-separated value. dhowden's
// readTextWithDescrFrame (used for ID3v2 TXXX) does NOT strip the
// trailing/embedded NUL bytes that ID3v2.4 uses as frame terminator and
// multi-value separator — so the Text often comes out as "uuid\x00" or
// "uuid1\x00uuid2". Postgres rejects NULs in text columns (SQLSTATE 22021).
// Minstrel uses the primary release artist for MBCAA lookup, so first-wins
// matches the original semantics.
func cleanMBID(s string) string {
for _, part := range strings.Split(s, "\x00") {
if t := strings.TrimSpace(part); t != "" {
return t
}
}
return ""
}