Finish up #967. Thanks, Bernát Gábor

Author: nedbat

CHANGES.rst

@@ -28,7 +28,13 @@ Unreleased
   decorated async functions (`issue 946`_).  This is now fixed. Thanks, Kjell
   Braden.
 
+- The :meth:`~coverage.Coverage.get_option` and
+  :meth:`~coverage.Coverage.set_option` methods can now manipulate the
+  ``[paths]`` configuration setting.  Thanks to Bernát Gábor for the fix for
+  `issue 967`_.
+
 .. _issue 946: https://github.com/nedbat/coveragepy/issues/946
+.. _issue 967: https://github.com/nedbat/coveragepy/issues/967
 
 
 .. _changes_504:

CONTRIBUTORS.txt

@@ -20,6 +20,7 @@ Arcadiy Ivanov
 Aron Griffis
 Artem Dayneko
 Ben Finney
+Bernát Gábor
 Bill Hart
 Brandon Rhodes
 Brett Cannon

coverage/config.py

@@ -421,6 +421,7 @@ def set_option(self, option_name, value):
         `value` is the new value for the option.
 
         """
+        # Special-cased options.
         if option_name == "paths":
             self.paths = value
             return
@@ -451,6 +452,7 @@ def get_option(self, option_name):
         Returns the value of the option.
 
         """
+        # Special-cased options.
         if option_name == "paths":
             return self.paths
 

coverage/control.py

@@ -367,7 +367,11 @@ def get_option(self, option_name):
         option name.  For example, the ``branch`` option in the ``[run]``
         section of the config file would be indicated with `"run:branch"`.
 
-        Returns the value of the option.
+        Returns the value of the option.  The type depends on the option
+        selected.
+
+        As a special case, an `option_name` of ``"paths"`` will return an
+        OrderedDict with the entire ``[paths]`` section value.
 
         .. versionadded:: 4.0
 
@@ -394,6 +398,9 @@ def set_option(self, option_name, value):
             [run]
             branch = True
 
+        As a special case, an `option_name` of ``"paths"`` will replace the
+        entire ``[paths]`` section.  The value should be an OrderedDict.
+
         .. versionadded:: 4.0
 
         """