Test::RRA

(Support functions for Perl tests)

SYNOPSIS

    use Test::RRA
      qw(skip_unless_author skip_unless_automated use_prereq);

    # Skip this test unless author tests are requested.
    skip_unless_author('Coding style tests');

    # Skip this test unless doing automated or release testing.
    skip_unless_automated('POD syntax tests');

    # Load modules, skipping the test if they're not available.
    use_prereq('Perl6::Slurp', 'slurp');
    use_prereq('Test::Script::Run', '0.04');

This module collects utility functions that are useful for Perl test scripts. It assumes Russ Allbery's Perl module layout and test conventions and will only be useful for other people if they use the same conventions.

This module must be loaded before Test::More or it will abort during import. It will skip the test (by printing a skip message to standard output and exiting with status 0, equivalent to plan skip_all) during import if Test::More is not available. This allows tests written in Perl using this module to be skipped if run on a system with Perl but not Test::More, such as Red Hat systems with the perl package but not the perl-core package installed.

FUNCTIONS

None of these functions are imported by default. The ones used by a script should be explicitly imported.

is_file_contents(GOT, EXPECTED, MESSAGE)

Check a string against the contents of a file, showing the differences if any using diff (if IPC::System::Simple and diff are available). GOT is the output the test received. EXPECTED is the path to a file containing the expected output (not the output itself). MESSAGE is a message to display alongside the test results.

skip_unless_author(DESC)

Checks whether AUTHOR_TESTING is set in the environment and skips the whole test (by calling plan skip_all from Test::More) if it is not. DESC is a description of the tests being skipped. A space and only run for author will be appended to it and used as the skip reason.

skip_unless_automated(DESC)

Checks whether AUTHOR_TESTING, AUTOMATED_TESTING, or RELEASE_TESTING are set in the environment and skips the whole test (by calling plan skip_all from Test::More) if they are not. This should be used by tests that should not run during end-user installs of the module, but which should run as part of CPAN smoke testing and release testing.

DESC is a description of the tests being skipped. A space and normally skipped will be appended to it and used as the skip reason.

use_prereq(MODULE[, VERSION][, IMPORT ...])

Attempts to load MODULE with the given VERSION and import arguments. If this fails for any reason, the test will be skipped (by calling plan skip_all from Test::More) with a skip reason saying that MODULE is required for the test.

VERSION will be passed to use as a version bareword if it looks like a version number. The remaining IMPORT arguments will be passed as the value of an array.

AUTHOR

Russ Allbery <eagle@eyrie.org>

COPYRIGHT AND LICENSE

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

Test::RRA

SYNOPSIS

DESCRIPTION

FUNCTIONS

AUTHOR

COPYRIGHT AND LICENSE

SEE ALSO