[Python-checkins] devguide: Add section on unexpected skips when running the tests
nick.coghlan
python-checkins at python.org
Sun Jun 17 11:14:49 CEST 2012
http://hg.python.org/devguide/rev/9fee8e6c2619
changeset: 522:9fee8e6c2619
user: Nick Coghlan <ncoghlan at gmail.com>
date: Sun Jun 17 19:14:39 2012 +1000
summary:
Add section on unexpected skips when running the tests
files:
runtests.rst | 18 ++++++++++++++++++
1 files changed, 18 insertions(+), 0 deletions(-)
diff --git a/runtests.rst b/runtests.rst
--- a/runtests.rst
+++ b/runtests.rst
@@ -71,6 +71,24 @@
above.
+Unexpected Skips
+----------------
+
+Sometimes when running the test suite, you will see "unexpected skips"
+reported. These represent cases where an entire test module has been
+skipped, but the test suite normally expects the tests in that module to
+be executed on that platform.
+
+Often, the cause is that an optional module hasn't been built due to missing
+build dependencies. In these cases, the missing module reported when the test
+is skipped should match one of the modules reported as failing to build when
+:ref:`compiling`.
+
+In other cases, the skip message should provide enough detail to help figure
+out and resolve the cause of the problem (for example, the default security
+settings on some platforms will disallow some tests)
+
+
Writing
-------
--
Repository URL: http://hg.python.org/devguide
More information about the Python-checkins
mailing list