[doc/book] note about bootstrap_cubes file stable
authorAurelien Campeas <aurelien.campeas@logilab.fr>
Wed, 04 Aug 2010 11:23:19 +0200
branchstable
changeset 6065 eae118a84cc6
parent 6064 2a164fabcbfc
child 6070 0ca78eb1a3c2
[doc/book] note about bootstrap_cubes file
doc/book/en/devrepo/testing.rst
--- a/doc/book/en/devrepo/testing.rst	Wed Aug 04 10:55:32 2010 +0200
+++ b/doc/book/en/devrepo/testing.rst	Wed Aug 04 11:23:19 2010 +0200
@@ -145,7 +145,7 @@
    connection from another !
 
 Email notifications tests
--------------------------
+`````````````````````````
 
 When running tests potentially generated e-mails are not really sent
 but is found in the list `MAILBOX` of module
@@ -212,6 +212,21 @@
   auto_populate cannot guess by itself; these must yield resultsets
   against which views may be selected.
 
+Testing with other cubes
+------------------------
+
+Sometimes a small component cannot be tested all by itself, so one
+needs to specify other cubes to be used as part of the the unit test
+suite. This is handled by the ``bootstrap_cubes`` file located under
+``mycube\test\data``. One example from the `preview` cube::
+
+ card, file, preview
+
+The format is:
+
+* possibly several empy lines or lines starting with ``#`` (comment lines)
+* one line containing a coma separated list of cube names.
+
 
 Test APIS
 ---------