Backup_Repos/beets
1
0
Fork 0
mirror of https://github.com/beetbox/beets.git synced 2025-12-29 20:12:33 +01:00
Code Issues Projects Releases Wiki Activity

small changes, documentation

Browse source
This commit is contained in:
soergeld 2020-05-12 16:05:08 +02:00
parent 1f93ce5a49
commit 918fea5eca
2 changed files with 12 additions and 5 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

6
beetsplug/parentwork.py
View file

@ -173,10 +173,10 @@ add one at https://musicbrainz.org/recording/{}', item, item.mb_trackid)
return
hasparent = hasattr(item, 'parentwork')
workfalse = True
work_changed = True
if hasattr(item, 'parentwork_workid_current'):
workfalse = item.mb_workid_current != item.mb_workid
if force or not hasparent or workfalse:
work_changed = item.mb_workid_current != item.mb_workid
if force or not hasparent or work_changed:
try:
work_info, work_date = find_parentwork_info(item.mb_workid)
except musicbrainzngs.musicbrainz.WebServiceError as e:

11
docs/plugins/parentwork.rst
View file

@ -18,6 +18,12 @@ example, all the movements of a symphony. This plugin aims to solve this
problem by also fetching the parent work, which would be the whole symphony in
this example.
It uses the ``mb_workid`` tag to retrieve the *parent work* and stores the
``mb_workid`` as ``parentwork_workid_current``. When one executes
``beet parentwork`` it checks if ``mb_workid`` has changed by comparing it
with ``parentwork_workid_current``, if it has changed or if ``force`` is
enabled it fetches the *parent work* again.
This plugin adds six tags:
- **parentwork**: The title of the parent work.
@ -27,7 +33,7 @@ This plugin adds six tags:
- **parent_composer_sort**: The sort name of the parent work composer.
- **work_date**: The composition date of the work, or the first parent work
that has a composition date. Format: yyyy-mm-dd.
- **parentwork_workid_current**: The musicbrainz id of the work as it was when
- **parentwork_workid_current**: The Musicbrainz id of the work as it was when
the parentwork was retrieved. This tag exists only for internal bookkeeping,
to keep track of recordings whose work have changed.
@ -41,7 +47,8 @@ To configure the plugin, make a ``parentwork:`` section in your
configuration file. The available options are:
- **force**: As a default, ``parentwork`` only fetches work info for
recordings that do not already have a ``parentwork`` tag. If ``force``
recordings that do not already have a ``parentwork`` tag or where
``mb_workid`` differs from ``parentwork_workid_current``. If ``force``
is enabled, it fetches it for all recordings.
Default: ``no``