Add write option to bpm plugin

beetsplug/bpm.py

@@ -64,7 +64,9 @@ def commands(self):
         return [cmd]
 
     def command(self, lib, opts, args):
-        self.get_bpm(lib.items(ui.decargs(args)))
+        items = lib.items(ui.decargs(args))
+        write = ui.should_write()
+        self.get_bpm(items, write)
 
     def get_bpm(self, items, write=False):
         overwrite = self.config['overwrite'].get(bool)

docs/changelog.rst

@@ -22,6 +22,8 @@ New features:
   source in a flexible field; for a usecase see the documentation.
 * :doc:`/plugins/export`: A new plugin to export the data from queries to a
   json format. Thanks to :user:`GuilhermeHideki`.
+* :doc:`/plugins/bpm`: Now uses ``import.write`` option to write tracks after
+  updating their BPM.
 * :doc:`/reference/pathformat`: new functions: %first{} and %ifdef{}
 * :doc:`/reference/config`: option ``terminal_encoding`` now works for some
   inputs

docs/plugins/bpm.rst

@@ -22,6 +22,21 @@ for instance, with ``mpc`` you can do something like::
 
      beet bpm $(mpc |head -1|tr -d "-")
 
+If :ref:`import.write <config-import-write>` is ``yes``, the song's tags are
+written to disk.
+
+Configuration
+-------------
+
+To configure the plugin, make a ``bpm:`` section in your configuration file.
+The available options are:
+
+- **max_strokes**: The maximum number of strokes to accept when tapping out the
+  BPM.
+  Default: 3.
+- **overwrite**: Overwrite the track's existing BPM.
+  Default: ``yes``.
+
 Credit
 ------
 

docs/reference/config.rst

@@ -373,6 +373,8 @@ file that looks like this::
 
 These options are available in this section:
 
+.. _config-import-write:
+
 write
 ~~~~~