Add documentation on avoiding PytestReturnNotNoneWarning

matplotlib · Nov 3, 2022 · e4dca96 · e4dca96
1 parent 8ce4878
commit e4dca96
Show file tree

Hide file tree

Showing 2 changed files with 10 additions and 0 deletions.
diff --git a/README.rst b/README.rst
@@ -120,6 +120,11 @@ and the tests will pass if the images are the same. If you omit the
 ``--mpl`` option, the tests will run but will only check that the code
 runs, without checking the output images.
 
+If pytest-mpl is not installed, the image comparison tests will cause pytest
+to show a warning, ``PytestReturnNotNoneWarning``. Installing pytest-mpl will
+solve this issue. Alternativly, the image comparison tests can be deselected
+by running pytest with ``-m "not mpl_image_compare"``.
+
 
 Generating a Test Summary
 ^^^^^^^^^^^^^^^^^^^^^^^^^

diff --git a/docs/usage.rst b/docs/usage.rst
@@ -86,3 +86,8 @@ against, the tests can be run with::
 and the tests will pass if the images are the same. If you omit the
 ``--mpl`` option, the tests will run but will only check that the code
 runs, without checking the output images.
+
+If pytest-mpl is not installed, the image comparison tests will cause pytest
+to show a warning, ``PytestReturnNotNoneWarning``. Installing pytest-mpl will
+solve this issue. Alternativly, the image comparison tests can be deselected
+by running pytest with ``-m "not mpl_image_compare"``.