Ravenbrook / Projects / Perforce Defect Tracking Integration / Master Product Sources

Perforce Defect Tracking Integration Project


Product Tests

Richard Brooksby, Ravenbrook Limited, 2000-12-13

1. Introduction

This document lists the test scripts and supporting files which have been written to measure the quality of the Perforce Defect Tracking Integration product.

This document will be updated as new tests are created.

The readership of this document is anyone developing or extending the product sources.

This document is not confidential.

The test design document [GDR 2001-07-02] describes how the tests are implemented and how to run them.

2. Test files

bugzilla.mysqldump Output of mysqldump on a Bugzilla installation. This sample database is used by the Bugzilla test cases in test_p4dti.py.
check_xhtml.py Python module for checking that a document uses XHTML correctly.
config_sandpiper.py Test configuration for running the P4DTI with TeamTrack on sandpiper.ravenbrook.com.
config_swan.py Test configuration for running the P4DTI with TeamTrack on swan.ravenbrook.com.
fake_p4.py Python script that pretends to be a Perforce client that isn't supported by the P4DTI. This allows us to check that this is detected and the correct error message produced.
fake_p4d.py Python script that pretends to be a Perforce client (that is supported by the P4DTI) connected to a Perforce server that isn't supported by the P4DTI.
p4dti_unittest.py Extension to the PyUnit test framework [PyUnit] that supports data-driven tests [GDR 2001-04-24].
perforce_sample_data.py Script that generates a sample Perforce repository and which generates bug-fixing activity in that repository.
run_tests.py Python script: run all tests in this directory.
teamtrack-4.5.mdb TeamTrack database, created in TeamTrack 4.5 (build 4509) following the instructions in [GDR 2001-07-02, 3].
teamtrack-4.5c5.0.mdb TeamTrack database, created in TeamTrack 4.5 (build 4509) following the instructions in [GDR 2001-07-02, 3] and then converted to TeamTrack 5.0 using build 5034.
teamtrack-5.0.mdb TeamTrack database, created in TeamTrack 5.0 (build 5034) following the instructions in [GDR 2001-07-02, 3].
test_catalog.py Unit test for the catalog module.
test_check_config.py Unit test for the check_config module.
test_check_xhtml.py Unit test for the check_xhtml module.
test_message.py Unit test for the message module.
test_p4dti.py Tests of the P4DTI (starting, configuration, operation, errors, ...).
test_teamtrack.py Unit test for the Python interface to TeamTrack..
test_translator.py Unit test for the translator module.
test_check_xhtml.py Unit test checking that project documents use XHTML correctly.
tt_performance.pmc Configuration for the Windows NT Performance Monitor; we used this to measure the memory usage of the TeamTrack server and the Python interface to TeamTrack during investigation of job000277.

A. References

[GDR 2001-04-24] "Data-driven tests" (e-mail message); Gareth Rees; Ravenbrook Limited; 2001-04-24.
[GDR 2001-07-02] "Test design"; Gareth Rees; Ravenbrook Limited; 2001-07-02.
[PyUnit] "PyUnit - a unit testing framework for Python"; Steve Purcell.

B. Document History

2000-12-13 RB Created as placeholder.
2001-02-27 GDR Added TeamTrack test procedure, sample TeamTrack database, and two test scripts.
2001-03-02 RB Transferred copyright to Perforce under their license.
2001-03-13 GDR Added test framework (section 2) and unit tests (section 3); old test material is now under the heading "system tests" (section 4).
2001-03-14 GDR Added test_catalog.py and test_check_config.py.
2001-04-19 GDR Added test_teamtrack.py.
2001-07-02 GDR Brought list of files up to date. Moved design to [GDR 2001-07-02].
2001-07-03 GDR Added teamtrack-4.5c5.0.mdb.
2001-07-25 GDR Added check_xhtml.py, test_check_xhtml.py and test_xhtml.py.

This document is copyright © 2001 Perforce Software, Inc. All rights reserved.

Redistribution and use of this document in any form, with or without modification, is permitted provided that redistributions of this document retain the above copyright notice, this condition and the following disclaimer.

This document is provided by the copyright holders and contributors "as is" and any express or implied warranties, including, but not limited to, the implied warranties of merchantability and fitness for a particular purpose are disclaimed. In no event shall the copyright holders and contributors be liable for any direct, indirect, incidental, special, exemplary, or consequential damages (including, but not limited to, procurement of substitute goods or services; loss of use, data, or profits; or business interruption) however caused and on any theory of liability, whether in contract, strict liability, or tort (including negligence or otherwise) arising in any way out of the use of this document, even if advised of the possibility of such damage.

$Id: //info.ravenbrook.com/project/p4dti/branch/2001-08-07/migrate-bugzilla/test/index.html#2 $

Ravenbrook / Projects / Perforce Defect Tracking Integration / Master Product Sources