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).