summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorAlec Warner <antarus@gentoo.org>2007-03-06 07:39:00 +0000
committerAlec Warner <antarus@gentoo.org>2007-03-06 07:39:00 +0000
commit5d257baeea19ba2ddb8c0c8560eaf652099a932a (patch)
tree916e5d9a5fe5718970eb959889676dd6392e8745
parentUpdate all the unittests to use the new framework, test skipping with isValid... (diff)
downloadportage-multirepo-5d257baeea19ba2ddb8c0c8560eaf652099a932a.tar.gz
portage-multirepo-5d257baeea19ba2ddb8c0c8560eaf652099a932a.tar.bz2
portage-multirepo-5d257baeea19ba2ddb8c0c8560eaf652099a932a.zip
Add part about new framework and skipping to test notes
svn path=/main/trunk/; revision=6183
-rw-r--r--TEST-NOTES13
1 files changed, 13 insertions, 0 deletions
diff --git a/TEST-NOTES b/TEST-NOTES
index 32db45a6..f9c6ab0c 100644
--- a/TEST-NOTES
+++ b/TEST-NOTES
@@ -26,6 +26,19 @@ pym/portage/tests/cache/flat_hash/test_foo.py
and you would put "cache/flat_hash" into the testDirs variable in __init__.py.
+
+Skipping
+--------
+
+Please use the portage.tests.* classes as they support throwing a SkipException for
+tests that are known to fail. Normally one uses testing to do Test Driven Development
+(TDD); however we do not do that here. Therefore there are times when legitimate tests
+exist but fail due to code in trunk. We would still like the suite to pass in some instances
+because the suite is built around two things, testing functionality in the current code as
+well as poking holes in the current code (isvalidatom is an example). So sometimes we desire
+a test to point out that "this needs fixing" but it doesn't affect portage's overall
+functionality. You should raise portage.tests.SkipException in that case.
+
emerge
------