CMFPloneTestsReadme

by plone.org Administrator — last modified Dec 05, 2005 11:05 AM

CMFPlone tests depend on the ZopeTestCase package.

As of this writing ZopeTestCase is hosted in the Collective CVS. It comes with useful documentation worth reading.

The required version of ZopeTestCase is 0.8.0a1 or better which is un- released and only available from the Collective CVS.

Note that ZopeTestCase must be installed into lib/python/Testing and not lib/python/Products!

The ZopeTestCase homepage is here: http://www.zope.org/Members/shh/ZopeTestCase

How to run the tests:

Setup your enviroment variables and run the test modules:

  • Set SOFTWARE_HOME to point to your Zope installation, e.g: /usr/lib/zope/lib/python
  • If you use a zope instance setup set INSTANCE_HOME to your Zope instance, e.g: /var/lib/zope/instance/default
  • Run single test: python testInterfaceTool.py
  • Run test-suite: python runalltests.py

Alternatively you may use the testrunner utility:

  • Install the INSTANCE_HOME-aware testrunner.py from http://www.zope.org/Members/shh/TestRunner
  • Run single test: python /path/to/zope/utilites/testrunner.py -qif testMyCoolProduct.py
  • Run all tests: python /path/to/zope/utilites/testrunner.py -qia
  • If this fails, you probably link your products into your instance, so use: python /path/to/zope/utilites/testrunner.py -qa -I /path/to/your/instance

How to setup a new unittest for a CMFPlone component:

  • Install ZopeTestCase
  • Install testrunner.py
  • Copy one of the testSkeleton* files and give it a new name, starting with test, e.g: testMyCoolProduct.py
  • Open the new script and change all instances of SomeProduct to the name of your product.

How to use ZopeTestCase with a Plone/CMF based Products:

  • Install Plone
  • Install ZopeTestCase
  • Install testrunner.py
  • In your Products directory create a directory named tests
  • Copy the following files from CMFPlone/tests into 'tests': framework.py, runalltests.py
  • Copy one of the testSkeleton* files and give it a new name, starting with test, e.g: testMyCoolProduct.py
  • Open the new script and change all instances of SomeProduct to the name of your product.