:py:mod:`calliope.resolvers`
============================

.. py:module:: calliope.resolvers

.. autoapi-nested-parse::

   Select Musicbrainz matches for playlist items by weighted priorities



Module Contents
---------------


Functions
~~~~~~~~~

.. autoapisummary::

   calliope.resolvers.select_best
   calliope.resolvers.select_interactive



.. py:function:: select_best(item, candidates)

   Automatically select the best match Item from a list of candidates for a given item.

   For each candidate, a number of weighted priorities is computed, which
   comprise its overall priority. The item with the best priority is automatically
   selected if it is higher than 90%.

   :param item: A calliope playlist item to match
   :param candidates: A list of candidates

   :returns: The best match Item or None if no good match was found.


.. py:function:: select_interactive(item, candidates)

   Select the best match Item from a list of candidates for a given item,
   with asking the user for help if in doubt.

   For each candidate, a number of weighted priorities is computed, which
   comprise its overall priority. The item with the best priority is automatically
   selected if it is higher than 95%, otherwise the user is asked for help.

   :param item: A calliope playlist item to match
   :param candidates: A list of candidates

   :returns: The best match Item or None if no good match was found.