Update documentation, changelog, and contributors

list for new `.coveragerc.toml` configuration file support.

Author: OlenaYefymenko

CHANGES.rst

@@ -23,7 +23,12 @@ upgrading your version of coverage.py.
 Unreleased
 ----------
 
-Nothing yet.
+- Feature: Added support for ``.coveragerc.toml`` configuration files. This 
+  provides a more flexible approach to manage coverage settings as many 
+  projects have switched to TOML configurations. Closes `issue 1643`_. 
+
+.. _issue 1643: https://github.com/nedbat/coveragepy/issues/1643
+.. _pull 1952: https://github.com/nedbat/coveragepy/pull/1952
 
 
 .. start-releases

CONTRIBUTORS.txt

@@ -185,6 +185,7 @@ Nils Kattenbeck
 Noel O'Boyle
 Oleg Höfling
 Oleh Krehel
+Olena Yefymenko
 Olivier Grisel
 Ori Avtalion
 Pablo Carballo

doc/config.rst

@@ -39,12 +39,13 @@ environment variable.
 
 If ``.coveragerc`` doesn't exist and another file hasn't been specified, then
 coverage.py will look for settings in other common configuration files, in this
-order: setup.cfg, tox.ini, or pyproject.toml.  The first file found with
+order: .coveragerc.toml, setup.cfg, tox.ini, or pyproject.toml.  The first file found with
 coverage.py settings will be used and other files won't be consulted.
 
-Coverage.py will read from "pyproject.toml" if TOML support is available,
+Coverage.py will read from ".coveragerc.toml" and "pyproject.toml" if TOML support is available,
 either because you are running on Python 3.11 or later, or because you
-installed with the ``toml`` extra (``pip install coverage[toml]``).
+installed with the ``toml`` extra (``pip install coverage[toml]``). Both files
+use the same ``[tool.coverage]`` section structure.
 
 
 Syntax
@@ -136,6 +137,35 @@ Here's a sample configuration file, in each syntax:
             [html]
             directory = coverage_html_report
             """,
+
+        coveragerc_toml=r"""
+            [tool.coverage.run]
+            branch = true
+
+            [tool.coverage.report]
+            # Regexes for lines to exclude from consideration
+            exclude_also = [
+                # Don't complain about missing debug-only code:
+                "def __repr__",
+                "if self\\.debug",
+
+                # Don't complain if tests don't hit defensive assertion code:
+                "raise AssertionError",
+                "raise NotImplementedError",
+
+                # Don't complain if non-runnable code isn't run:
+                "if 0:",
+                "if __name__ == .__main__.:",
+
+                # Don't complain about abstract methods, they aren't run:
+                "@(abc\\.)?abstractmethod",
+                ]
+
+            ignore_errors = true
+
+            [tool.coverage.html]
+            directory = "coverage_html_report"
+            """,
         toml=r"""
             [tool.coverage.run]
             branch = true
@@ -198,6 +228,36 @@ Here's a sample configuration file, in each syntax:
         [html]
         directory = coverage_html_report
 
+    .. code-tab:: toml
+        :caption: .coveragerc.toml
+
+        [tool.coverage.run]
+        branch = true
+
+        [tool.coverage.report]
+        # Regexes for lines to exclude from consideration
+        exclude_also = [
+            # Don't complain about missing debug-only code:
+            "def __repr__",
+            "if self\\.debug",
+
+            # Don't complain if tests don't hit defensive assertion code:
+            "raise AssertionError",
+            "raise NotImplementedError",
+
+            # Don't complain if non-runnable code isn't run:
+            "if 0:",
+            "if __name__ == .__main__.:",
+
+            # Don't complain about abstract methods, they aren't run:
+            "@(abc\\.)?abstractmethod",
+            ]
+
+        ignore_errors = true
+
+        [tool.coverage.html]
+        directory = "coverage_html_report"
+
     .. code-tab:: toml
         :caption: pyproject.toml