NAME

XAO::TestUtils - testing framework for XAO modules

SYNOPSIS

In your Makefile.PL:

test::
       \$(PERL) -MXAO::TestUtils=xao_all_tests \\
                -e'xao_all_tests("XAO::testcases::FS")'

DESCRIPTION

This module is intended for use only in testing of XAO modules and modules based on XAO.

For instance XAO::FS installs a set of tests in system perl directories. XAO::TestUtils and these tests can then be used for testing third party database drivers against this standard set of tests.

Method details:

xao_test_all ($;@)

Runs all tests for a given list of namespaces in random order. As a special case if first argument is an integer it turns debug output on using XAO::Utils set_debug() method.

Can be called from command line:

perl -MXAO::TestUtils=xao_test_all -e'xao_test_all(1,"testcases")'

Test execution is the same as for run_tests() method, see below.

xao_test (@)

Runs given tests in the given sequence. Tests are given as corresponding unit package names. Example:

xao_test('Basic','XAO::testcases::FS::Lists');

It will create 'ta' directory in the current directory and will store two files for each test case in there - one suitable for 'make test' with '.t' extension and one for manual checking with debug output enabled and in different human-readable output mode with '.pl' extension. At a later time these tests can be individually re-run manually using simply 'perl ta/testname.pl' command.

Common prefix will be automatically removed from files.

AUTHOR

Copyright (c) 2005 Ejelta LLC. Copyright (c) 2003 XAO Inc.

The author is Andrew Maltsev <am@ejelta.com>.