summaryrefslogtreecommitdiff
path: root/docutils/docs/dev
diff options
context:
space:
mode:
authormilde <milde@929543f6-e4f2-0310-98a6-ba3bd3dd1d04>2022-12-13 21:45:23 +0000
committermilde <milde@929543f6-e4f2-0310-98a6-ba3bd3dd1d04>2022-12-13 21:45:23 +0000
commitfbd4532eb6828c3e3903d714361b9290755e7c17 (patch)
tree536254df53f61da7bd66eeeacadc89e87b9d3c24 /docutils/docs/dev
parent91906b5dd325c3bc33f71177cd81c1407cadb2de (diff)
downloaddocutils-fbd4532eb6828c3e3903d714361b9290755e7c17.tar.gz
Update test documentation. Set executable bit on test scripts.
Don't mention the "nose" test framework. (It is unmaintained, deprecated, and fails to find all test cases.) Hint to a possible future dependency on "pytest". Two recently added test scripts missed the executable bit. git-svn-id: https://svn.code.sf.net/p/docutils/code/trunk@9308 929543f6-e4f2-0310-98a6-ba3bd3dd1d04
Diffstat (limited to 'docutils/docs/dev')
-rw-r--r--docutils/docs/dev/testing.txt16
1 files changed, 8 insertions, 8 deletions
diff --git a/docutils/docs/dev/testing.txt b/docutils/docs/dev/testing.txt
index 55e886238..817f20733 100644
--- a/docutils/docs/dev/testing.txt
+++ b/docutils/docs/dev/testing.txt
@@ -40,15 +40,15 @@ In a pinch, the edge cases should cover most of it.
.. note::
The ``alltests.py`` test runner is based on the standard library's unittest_
framework.
- Since Docutils 0.19, running ``python -m unittest``, the pytest_, and the
- nose_ frameworks no longer result in spurious failures (cf. `bug #270`_).
- However, there are differences in the reported number of tests and in
- test coverage.
+ Since Docutils 0.19, running ``python -m unittest`` and the pytest_
+ framework no longer result in spurious failures (cf. `bug #270`_).
+ However, there are differences in the reported number of tests
+ (``alltests.py`` also counts sub-tests).
+ In future, running the test suite may require pytest_.
__ policies.html#check-ins
.. _unittest: https://docs.python.org/3/library/unittest.html
.. _pytest: https://pypi.org/project/pytest
-.. _nose: https://pypi.org/project/nose
.. _`bug #270`: https://sourceforge.net/p/docutils/bugs/270/
@@ -93,9 +93,8 @@ Then run::
python3.11 -u alltests.py
.. note::
- When using the `Python launcher for Windows`__, make sure to
- specify a Python version, e.g., ``py -3.9 -u alltests.py`` for
- Python 3.9.
+ When using the `Python launcher for Windows`__, specify the Python version
+ as option, e.g., ``py -3.9 -u alltests.py`` for Python 3.9.
.. cf. https://sourceforge.net/p/docutils/bugs/434/
__ https://docs.python.org/3/using/windows.html#python-launcher-for-windows
@@ -107,6 +106,7 @@ Then run::
__ https://docs.python.org/3/whatsnew/3.11.html
+
.. _supported versions:
.. _supported Python versions: ../../README.html#requirements
.. _pyenv: https://github.com/yyuu/pyenv