Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Clean up MusicBrainz nomenclature #364

Merged
merged 2 commits into from
Feb 13, 2019

Conversation

Freso
Copy link
Member

@Freso Freso commented Feb 13, 2019

A series of commits for cleaning up various internal (e.g., variable names) and external uses of terms fetched from MusicBrainz that do not match up with what MusicBrainz calls the same concepts. This is mostly to make the code a bit clearer for someone familiar with MusicBrainz, but also to clear up some inconsistencies—e.g., you would have "%A: album artist" but "%y: release year" before, even though they're both referring to an MB Release "object".

See explanations for changes in individual commits.

whipper/result/logger.py Outdated Show resolved Hide resolved
In general, "albums" in everyday usage is what on MusicBrainz would be
considered a release group[1] while as far as I can tell, every single
instance of it being used in whipper is referring to a single "edition"
of an album, which is what would be called a "release" in
MusicBrainz terminology[2].

[1] https://musicbrainz.org/doc/Release_Group
[2] https://musicbrainz.org/doc/Release

Signed-off-by: Frederik “Freso” S. Olesen <freso.dk@gmail.com>
@Freso Freso force-pushed the task/cleanup-musicbrainz-nomenclature branch from 9389131 to 75c5646 Compare February 13, 2019 13:55
For historical reasons there is some confusion between Tracks[1] and
Recordings[2] in MusicBrainz. Essentially what should be saved to
`MUSICBRAINZ_TRACKID` is the Recording MBID—which is what whipper is
correctly doing, but the value storing this value was called `mbidTrack`
rather than `mbidRecording`, which could potentially cause confusion.

[1] https://musicbrainz.org/doc/Track
[2] https://musicbrainz.org/doc/Recording

Signed-off-by: Frederik “Freso” S. Olesen <freso.dk@gmail.com>
@Freso Freso changed the title WIP: Clean up MusicBrainz nomenclature Clean up MusicBrainz nomenclature Feb 13, 2019
@JoeLametta JoeLametta merged commit 8266368 into develop Feb 13, 2019
@JoeLametta
Copy link
Collaborator

Thanks for the cleanup and the detailed descriptions!

@JoeLametta JoeLametta deleted the task/cleanup-musicbrainz-nomenclature branch February 13, 2019 14:31
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants