# [Python-checkins] python/dist/src/Doc/lib libtest.tex,1.5,1.6

bcannon at users.sourceforge.net bcannon at users.sourceforge.net
Mon Dec 6 07:09:03 CET 2004

Update of /cvsroot/python/python/dist/src/Doc/lib
In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv23400/Doc/lib

Modified Files:
libtest.tex
Log Message:
Have test_mkalias_relative check that sys.prefix already exists; otherwise test
is pointless.

Also add a note to the docs for the 'test' package that test cases should check
first that any conditions needed in the operating system are met before having
a test run.

Closes bug #1077302.  THanks, Ian Holsman.

Index: libtest.tex
===================================================================
RCS file: /cvsroot/python/python/dist/src/Doc/lib/libtest.tex,v
retrieving revision 1.5
retrieving revision 1.6
diff -u -d -r1.5 -r1.6
--- libtest.tex	18 Mar 2004 07:37:15 -0000	1.5
+++ libtest.tex	6 Dec 2004 06:08:59 -0000	1.6
@@ -31,8 +31,10 @@

It is preferred that tests for the \module{test} package use the
\refmodule{unittest} module and follow a few guidelines.
-One is to have the name of all the test methods start with \samp{test_} as
-well as the module's name.
+One is to name the test module by starting it with \samp{test_} and end it with
+the name of the module being tested.
+The test methods in the test module should start with \samp{test_} and end with
+a description of what the method is testing.
This is needed so that the methods are recognized by the test driver as
test methods.
Also, no documentation string for the method should be included.
@@ -109,6 +111,8 @@
changed in the future.
\item Make sure to clean up after your tests (such as close and remove all
temporary files).
+\item If a test is dependent on a specific condition of the operating system
+      then verify the condition already exists before attempting the test.
\item Import as few modules as possible and do it as soon as possible.
This minimizes external dependencies of tests and also minimizes possible
anomalous behavior from side-effects of importing a module.