Use aliases for tracks, releases and release groups

[Morikko]

Description

This PR add support for aliases to releases, release-groups and recordings.

This PR is a must have (IMO at least) for people that listen to Japanese, Chinese and other songs that has other symbols for letters. With this, not only the artist name will use the alias if available, but now the album and track name will also use aliases.

Follow up from #5277 based on the recent new mechanism to query musicbrainz (#6052).

To Do

• Documentation
• Changelog
• Tests

API examples

• Aliases for releases, recordings and release groups: http://musicbrainz.org/ws/2/release/59211ea4-ffd2-4ad9-9a4e-941d3148024a?inc=recordings+aliases+release-groups&fmt=json
• Aliases for recordings: https://musicbrainz.org/ws/2/recording/b9ad642e-b012-41c7-b72a-42cf4911f9ff?inc=aliases&fmt=json

[sourcery-ai]

Hey - I've found 2 issues, and left some high level feedback:

• The logic for choosing an alias over the default title is now duplicated for recordings, releases, and release groups; consider extracting a small helper (e.g., _title_with_alias(obj, fallback_key="title")) to centralize this behavior and reduce the chance of inconsistent future changes.
• In album_info, _preferred_alias(track["recording"].get("aliases", ())) is computed separately from the earlier track_info call that already chooses the recording alias; consider reusing or passing through that decision to avoid recomputing and to make the precedence between recording aliases and track titles clearer.

Prompt for AI Agents

Please address the comments from this code review:

## Overall Comments
- The logic for choosing an alias over the default title is now duplicated for recordings, releases, and release groups; consider extracting a small helper (e.g., `_title_with_alias(obj, fallback_key="title")`) to centralize this behavior and reduce the chance of inconsistent future changes.
- In `album_info`, `_preferred_alias(track["recording"].get("aliases", ()))` is computed separately from the earlier `track_info` call that already chooses the recording alias; consider reusing or passing through that decision to avoid recomputing and to make the precedence between recording aliases and track titles clearer.

## Individual Comments

### Comment 1
<location> `test/plugins/test_musicbrainz.py:183-187` </location>
<code_context>
         disambiguation=None,
         remixer=False,
         multi_artist_credit=False,
+        aliases=None,
     ):
</code_context>

<issue_to_address>
**issue (testing):** Track alias tests may not exercise the actual alias lookup path (aliases are attached to the track, not the recording).

Production code reads aliases from `recording.get("aliases", ())`, but `_make_track` currently sets `track["aliases"]`, not `track["recording"]["aliases"]`. Unless something later moves this field, tests using `_make_track(..., aliases=...)` aren’t exercising the real alias lookup path. Consider either assigning aliases to `track["recording"]["aliases"]` in `_make_track`, or having tests build the `recording` dict (with an `aliases` field) explicitly so they validate `_preferred_alias(recording["aliases"])` as intended.
</issue_to_address>

### Comment 2
<location> `docs/changelog.rst:39` </location>
<code_context>
       resolve differences in metadata source styles.
 - :doc:`plugins/spotify`: Added support for multi-artist albums and tracks,
       saving all contributing artists to the respective fields.
+- :doc:`plugins/musicbrainz`: Use title alias for releases, release groups and
+     recordings.

 Bug fixes:
</code_context>

<issue_to_address>
**suggestion (typo):** Use plural "aliases" when referring to multiple releases, release groups, and recordings.

Consider updating the sentence to: “Use title aliases for releases, release groups, and recordings.” for clearer grammar.

```suggestion
- :doc:`plugins/musicbrainz`: Use title aliases for releases, release groups, and
```
</issue_to_address>

---

Sourcery is free for open source - if you like our reviews please consider sharing them ✨

• X
• Mastodon
• LinkedIn
• Facebook

_{Help me be more useful! Please click 👍 or 👎 on each comment and I'll use the feedback to improve your reviews.}

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 69.52%. Comparing base (abd77b3) to head (548bd9b).
⚠️ Report is 16 commits behind head on master.
✅ All tests successful. No failed tests found.

Additional details and impacted files

@@           Coverage Diff           @@
##           master    #6231   +/-   ##
=======================================
  Coverage   69.52%   69.52%           
=======================================
  Files         141      141           
  Lines       18475    18475           
  Branches     3020     3020           
=======================================
  Hits        12844    12844           
  Misses       4997     4997           
  Partials      634      634           

🚀 New features to boost your workflow:

• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

[snejus]

Sorry that it took so long to respond to your PR! This won't get delayed any more and get merged soon.

I think sourcery's comments are legitimate and need resolving.

In addition, there have been a fair bit of updates since this PR was submitted, so you want to merge master into your branch again.

And finally, I wonder whether this should be configurable by the user? For example, use_aliases configuration with a default yes.

[Morikko]

And finally, I wonder whether this should be configurable by the user? For example, use_aliases configuration with a default yes.

It is already to some extents. There is a languages config. I extended the doc in the PR to inform the fields it applies on. The default is to do nothing:

Defaults to an empty list, meaning that no language is preferred.

[Copilot]

Pull request overview

PR add MusicBrainz alias picking for more titles, so import can use locale-friendly names (not only artist).

Changes:

• Use preferred aliases for recording title (track), release title (album), and release-group title.
• Adjust track title preference so track title override not stomp preferred recording alias.
• Add tests + docs + changelog note for new alias behavior.

Reviewed changes

Copilot reviewed 4 out of 4 changed files in this pull request and generated 3 comments.

File	Description
beetsplug/musicbrainz.py	Pick preferred alias for recording/release/release-group titles during MB parsing.
test/plugins/test_musicbrainz.py	Add regression tests for alias selection on release, release group, and tracks.
docs/reference/config.rst	Document that import.languages affects more fields (needs wording tweak).
docs/changelog.rst	Changelog entry for new alias behavior.

[snejus]

^ See some legitimate comments from Copilot. It all looks good to me, I'll have another look once the above comments are addressed!

[snejus]

Lovely stuff, thanks