[Zope-CVS] CVS: Packages/TestScripts - README.TXT:1.1

[Chris Withers]

Update of /cvs-repository/Packages/TestScripts
In directory cvs.zope.org:/tmp/cvs-serv15897/TestScripts

Added Files:
	README.TXT 
Log Message:
README.TXT as requested by Fred.

=== Added File Packages/TestScripts/README.TXT ===
How to Install & Use autotester.py

 These are possible recipes for getting automated Zope testing running.
 There are plenty of other possibilities. If you find one you
 consider better or have any other corrections and suggestions, please
 email them chrisw@nipltd.com.
 In particular, it would be useful if people could email recipies like 
 the following for getting the tests run on other operating systems.

 Windows

   1. Download the TestScripts compressed archive:

      http://cvs.zope.org/Packages/TestScripts/TestScripts.tar.gz?tarball=1

   2. Extract it to a location of your choice, I'll use D:/TestScripts

   3. Copy D:\TestScripts\windows_config.xml to
           D:\TestScripts\my_config.xml

   4. Edit my_config.xml as appropriate. The format of the XML should be
      apparent from the examples included. Ensure that the configuration of
      python version locations and cvs commands are appropriate for your 
      system.

   3. Create a workspace folder in the location of your choice, 
      I'll use D:\ZopeTests.

   4. Create a batch file, I called mine D:\ZopeTests\testrunner.bat,
      in the workspace that looks something like the following:
      
      c:\winnt\system32\cmd /c C:\python21\python D:\TestScripts\autotester.py D:\TestScripts\my_config.xml

      You will need to set up any environment variables required for CVS and your C compiler prior to this statement.

   5. Add a directory in the workspace called 'sandbox'.
      Mine was at D:\ZopeTests\sandbox.

   6. At this stage, you can test your configuration by running the batch file.

   7. Go to Start > Settings > Control Panel > Scheduled Tasks.
      Add a scheduled task that runs the batch file as often as you want.

 Linux

   1. Download the TestScripts compressed archive:

      http://cvs.zope.org/Packages/TestScripts/TestScripts.tar.gz?tarball=1

   2. Extract it to a location of your choice, I'll use /stuff/TestScripts

   3. Copy /stuff/TestScripts/linux_config.xml to
           /stuff/TestScripts/my_config.xml

   4. Edit my_config.xml as appropriate. The format of the XML should be
      apparent from the examples included. Ensure that the configuration of
      python version locations and cvs commands are appropriate for your 
      system.

   3. Create a workspace folder in the location of your choice, 
      I'll use /stuff/ZopeTests.

   4. Create a shell script, I called mine /stuff/ZopeTests/testrunner,
      in the workspace that looks something like the following:
      
      /usr/local/bin/python /stuff/TestScripts/autotester.py /stuff/TestScripts/my_config.xml

   5. Add a directory in the workspace called 'sandbox'.
      Mine was at /stuff/ZopeTests/sandbox.

   6. At this stage, you can test your configuration by running the shell script.

   7. Add an appropriate  crontab entry for the shell script.