[py-svn] r7085 - py/dist/doc

[hpk at codespeak.net]

Author: hpk
Date: Thu Oct 21 23:29:46 2004
New Revision: 7085

Modified:
   py/dist/doc/test.txt
Log:
some cleanup of the description of basic features



Modified: py/dist/doc/test.txt
==============================================================================
--- py/dist/doc/test.txt	(original)
+++ py/dist/doc/test.txt	Thu Oct 21 23:29:46 2004
@@ -31,8 +31,8 @@
 on your system. 
 
 
-Features of ``py.test`` 
-=======================
+Basic Features of ``py.test`` 
+=============================
 
 assert with the ``assert`` statement
 ------------------------------------
@@ -73,11 +73,20 @@
 automatic collection of tests on all levels
 -------------------------------------------
 
-The automated test (see `collection process`_ for 
-implemenetation details) takes care that all
-files with a leading ``test_`` and then every function 
-with a leading ``test_`` or ``Test`` in the case of classes 
-are collected.  
+The automated test collection process collects files 
+from all subdirectories with a leading ``test_`` in their
+filename and then every function with a leading ``test_`` 
+or ``Test`` in the case of classes.  The collecting process 
+can be customized at each level.  (see `collection process`_ 
+for some implemenetation details). 
+
+testing starts immediately 
+--------------------------
+
+Testing starts as soon as the first ``test item``, 
+usually a test function or method is collected.  
+There is no need to first collect all tests 
+before a test starts. 
 
 no interference with cmdline utilities 
 --------------------------------------
@@ -97,10 +106,11 @@
 order of execution is guaranteed
 --------------------------------
 
-Great care is taken that by default all tests run in the order 
-in which they appear in the files. If you run tests multiple times
-you will find that they execute in exactly the same order
-within each file. 
+Great care is taken that all tests run in the order in which
+they appear in the files. If you run tests multiple times you
+will find that they execute in exactly the same order within
+each file. This allows multi-stage tests where you can 
+rely on your test to iteratively build up a test structure. 
 
 useful tracebacks, recursion detection 
 --------------------------------------