NAME

Test::Unit::TestSuite - unit testing framework base class

SYNOPSIS

    use Test::Unit::TestSuite;

    # more code here ...

    sub suite {
        my $class = shift;

        # create an empty suite
        my $suite = Test::Unit::TestSuite->empty_new("A Test Suite");
        
        # get and add an existing suite
        $suite->add_test(Test::Unit::TestSuite->new("MyModule::Suite_1"));

        # extract suite by way of suite method and add
        $suite->add_test(MyModule::Suite_2->suite());
        
        # get and add another existing suite
        $suite->add_test(Test::Unit::TestSuite->new("MyModule::TestCase_2"));

        # return the suite built
        return $suite;
    }

DESCRIPTION

This class is normally not used directly, but it can be used for creating your own custom built aggregate suites.

Normally, this class just provides the functionality of auto-building a test suite by extracting methods with a name prefix of test from a given package to the test runners.

AUTHOR

Framework JUnit authored by Kent Beck and Erich Gamma.

Ported from Java to Perl by Christian Lemburg.

Copyright (c) 2000 Christian Lemburg, <lemburg@acm.org>.

All rights reserved. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

Thanks go to the other PerlUnit framework people: Brian Ewins, Cayte Lindner, J.E. Fritz, Zhon Johansen.

SEE ALSO

• Test::Unit::TestRunner

• Test::Unit::TkTestRunner

• For further examples, take a look at the framework self test collection (Test::Unit::tests::AllTests).