Anotate addops usage in pytest config

1 files changed, 31 insertions, 1 deletions

diff --git a/pytest.ini b/pytest.ini
index dfdf2407..909f146c 100644
--- a/pytest.ini
+++ b/pytest.ini
@@ -1,5 +1,35 @@
 [pytest]
-addopts = --durations=10 -v -rxXs -l --junitxml=.test-results/pytest/results.xml --cov=cherrypy --cov-report term-missing:skip-covered --cov-report xml --doctest-modules
+addopts =
+    # `pytest-xdist`:
+    #--numprocesses=auto
+
+    # `pytest-mon`:
+    # useful for live testing with `pytest-watch` during development:
+    #--testmon
+
+    # show 10 slowest invocations:
+    --durations=10
+
+    # a bit of verbosity doesn't hurt:
+    -v
+
+    # report all the things == -rxXs:
+    -ra
+
+    # show values of the local vars in errors:
+    --showlocals
+
+    # autocollect and invoke the doctests from all modules:
+    --doctest-modules
+
+    # dump the test results in junit format:
+    --junitxml=.test-results/pytest/results.xml
+
+    # `pytest-cov`:
+    --cov=cherrypy
+    --cov-report term-missing:skip-covered
+    --cov-report xml
+    # --cov-report xml:.test-results/pytest/cov.xml  # alternatively move it here
 doctest_optionflags = ALLOW_UNICODE ELLIPSIS
 filterwarnings =
     error