Book HomeJava and XSLTSearch this book

8.200. Test::Builder

A backend for building test libraries under Perl. Note that Test::Builder is in the early stages of development and that things may become more (or less) stable, or may change completely. Test::Builder is more flexible than other testing modules such as Test::Simple and Test::More.

Test::Builder implements the following methods.

new

new()

Returns a Test::Builder object representing the current state of the test. There's no need to create more than one Test::Builder object, since you run only one test per program.

BAILOUT

BAILOUT(reason)

Terminates all tests and exits immediately.

expected_tests

expected_tests()

Gets and sets the tests that will run and prints out the correct headers.

exported_to

exported_to(package)

Specifies the package you exported your functions to.

is_eq

is_eq(got_from_test, expected_from_test, name_of_test)

Checks if got_from_testeq expected_from_test.

isnt_eq

isnt_eq(got_from_test, did_not_expect, name_of_test)

Checks if got_from_testne did_not_expect.

isnt_num

isnt_num(got_from_test, did_not_expect, name_of_test)

Checks if got_from_test!= did_not_expect.

is_num

is_num(got_from_test, expected_from_test, name_of_test)

Checks if got_from_test== expected_from_test.

like

like(string, '/regex/', name_of_test)

Checks if string matches the specified regular expression.

no_plan

no_plan()

Declares that there may be an infinite number of tests.

ok

ok(test, name)

Reports if test by name is true.

plan

plan()

Sets up the tests for you, prints appropriate headers, and takes appropriate actions. plan can be used in lieu of any of the subsequent methods.

skip

skip([reason])

Skips the current test, citing reason.

skip_all

skip_all(reason)

Shamelessly skips all the tests, citing the given reason . Exits with 0.

my $reason = "I didn't feel like it today.";
$Test->skip_all($reason);
unlike

unlike(string, '/regex/', name_of_test)

Checks if string does not match the specified regular expression.



Library Navigation Links

Copyright © 2002 O'Reilly & Associates. All rights reserved.