Make musicbrainzngs dependency optional and requests required

Author: snejus

.github/workflows/ci.yaml

@@ -58,15 +58,15 @@ jobs:
       - if: ${{ env.IS_MAIN_PYTHON != 'true' }}
         name: Test without coverage
         run: |
-          poetry install --without=lint --extras=autobpm --extras=lyrics --extras=replaygain --extras=reflink --extras=fetchart --extras=chroma --extras=sonosupdate
+          poetry install --without=lint --extras=autobpm --extras=lyrics --extras=replaygain --extras=reflink --extras=fetchart --extras=chroma --extras=sonosupdate --extras=parentwork
           poe test
 
       - if: ${{ env.IS_MAIN_PYTHON == 'true' }}
         name: Test with coverage
         env:
           LYRICS_UPDATED: ${{ steps.lyrics-update.outputs.any_changed }}
         run: |
-          poetry install --extras=autobpm --extras=lyrics --extras=docs --extras=replaygain --extras=reflink --extras=fetchart --extras=chroma --extras=sonosupdate
+          poetry install --extras=autobpm --extras=lyrics --extras=docs --extras=replaygain --extras=reflink --extras=fetchart --extras=chroma --extras=sonosupdate --extras=parentwork
           poe docs
           poe test-with-coverage
 

docs/plugins/listenbrainz.rst

@@ -9,13 +9,12 @@ service.
 Installation
 ------------
 
-To enable the ListenBrainz plugin, add the following to your beets configuration
-file (config.yaml_):
+To use the ``listenbrainz`` plugin, first enable it in your configuration (see
+:ref:`using-plugins`). Then, install ``beets`` with ``listenbrainz`` extra
 
-.. code-block:: yaml
+.. code-block:: bash
 
-    plugins:
-        - listenbrainz
+    pip install "beets[listenbrainz]"
 
 You can then configure the plugin by providing your Listenbrainz token (see
 intructions here_) and username:

docs/plugins/mbcollection.rst

@@ -6,9 +6,18 @@ maintain your `music collection`_ list there.
 
 .. _music collection: https://musicbrainz.org/doc/Collections
 
-To begin, just enable the ``mbcollection`` plugin in your configuration (see
-:ref:`using-plugins`). Then, add your MusicBrainz username and password to your
-:doc:`configuration file </reference/config>` under a ``musicbrainz`` section:
+Installation
+------------
+
+To use the ``mbcollection`` plugin, first enable it in your configuration (see
+:ref:`using-plugins`). Then, install ``beets`` with ``mbcollection`` extra
+
+.. code-block:: bash
+
+    pip install "beets[mbcollection]"
+
+Then, add your MusicBrainz username and password to your :doc:`configuration
+file </reference/config>` under a ``musicbrainz`` section:
 
 ::
 

docs/plugins/missing.rst

@@ -5,12 +5,21 @@ This plugin adds a new command, ``missing`` or ``miss``, which finds and lists
 missing tracks for albums in your collection. Each album requires one network
 call to album data source.
 
+Installation
+------------
+
+To use the ``missing`` plugin, first enable it in your configuration (see
+:ref:`using-plugins`). Then, install ``beets`` with ``missing`` extra
+
+.. code-block:: bash
+
+    pip install "beets[missing]"
+
 Usage
 -----
 
-Add the ``missing`` plugin to your configuration (see :ref:`using-plugins`). The
-``beet missing`` command fetches album information from the origin data source
-and lists names of the **tracks** that are missing from your library.
+The ``beet missing`` command fetches album information from the origin data
+source and lists names of the **tracks** that are missing from your library.
 
 It can also list the names of missing **albums** for each artist, although this
 is limited to albums from the MusicBrainz data source only.

docs/plugins/parentwork.rst

@@ -38,8 +38,15 @@ This plugin adds seven tags:
   to keep track of recordings whose works have changed.
 - **parentwork_date**: The composition date of the parent work.
 
-To use the ``parentwork`` plugin, enable it in your configuration (see
-:ref:`using-plugins`).
+Installation
+------------
+
+To use the ``parentwork`` plugin, first enable it in your configuration (see
+:ref:`using-plugins`). Then, install ``beets`` with ``parentwork`` extra
+
+.. code-block:: bash
+
+    pip install "beets[parentwork]"
 
 Configuration
 -------------

poetry.lock

@@ -48,10 +48,10 @@ confuse = ">=1.5.0"
 jellyfish = "*"
 lap = ">=0.5.12"
 mediafile = ">=0.12.0"
-musicbrainzngs = ">=0.4"
 numpy = ">=1.24.4"
 platformdirs = ">=3.5.0"
 pyyaml = "*"
+requests = ">=2.32.5"
 requests-ratelimiter = ">=0.7.0"
 typing_extensions = "*"
 unidecode = ">=1.3.6"
@@ -62,6 +62,7 @@ flask = { version = "*", optional = true }
 flask-cors = { version = "*", optional = true }
 langdetect = { version = "*", optional = true }
 librosa = { version = "^0.10.2.post1", optional = true }
+musicbrainzngs = { version = ">=0.4", optional = true }
 mutagen = { version = ">=1.33", optional = true }
 Pillow = { version = "*", optional = true }
 py7zr = { version = "*", optional = true }
@@ -73,7 +74,6 @@ python3-discogs-client = { version = ">=2.3.15", optional = true }
 pyxdg = { version = "*", optional = true }
 rarfile = { version = "*", optional = true }
 reflink = { version = "*", optional = true }
-requests = { version = "*", optional = true }
 resampy = { version = ">=0.4.3", optional = true }
 requests-oauthlib = { version = ">=0.6.1", optional = true }
 soco = { version = "*", optional = true }
@@ -152,9 +152,13 @@ import = ["py7zr", "rarfile"]
 kodiupdate = ["requests"]
 lastgenre = ["pylast"]
 lastimport = ["pylast"]
+listenbrainz = ["musicbrainzngs"]
 lyrics = ["beautifulsoup4", "langdetect", "requests"]
+mbcollection = ["musicbrainzngs"]
 metasync = ["dbus-python"]
+missing = ["musicbrainzngs"]
 mpdstats = ["python-mpd2"]
+parentwork = ["musicbrainzngs"]
 plexupdate = ["requests"]
 reflink = ["reflink"]
 replaygain = [