GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  BADGER::TEST::MANAGER (3)

.ds Aq ’

NAME

Badger::Test::Manager - test manager module

CONTENTS

SYNOPSIS



    use Badger::Test::Manager;

    # object methods
    my $manager = Badger::Test::Manager->new( plan => 7 );
    $manager->ok($bool, This is a test);
    $manager->pass(This is ok);
    $manager->fail(This is not ok);
    $manager->is($this, $this, This and that are equal);
    $manager->isnt($this, $this, This and that are not equal);
    $manager->like($this, qr/that/, This is matched by that);
    $manager->unlike($this, qr/that/, This is not matched by that);

    # class methods
    Badger::Test::Manager->plan(7);
    Badger::Test::Manager->ok($bool, This is a test);
    Badger::Test::Manager->pass(This is ok);
    Badger::Test::Manager->fail(This is not ok);
    # ... plus is(), isnt(), like() unlike() methods, as above



DESCRIPTION

This module implements a simple test manager for Badger::Test.

METHODS

All methods can be called as class methods or object methods. In the case of class methods, they are called against a prototype object returned by the prototype() method inherited from Badger::Prototype.

    plan($tests)

How many tests you plan to run. An error will be thrown if you try to call this method twice.

    result($flag,@args)

Low-level method to generate a test result.

ok($flag, CW$name)

Report on the success or failure of a test:



    $manager->ok(1, This is good);
    $manager->ok(0, This is bad);



is($this, CW$that, CW$name)

Test if the first two arguments are equal.



    $manager->is($this, $that, "This and that are equal");



isnt($this, CW$that, CW$name)

Test if the first two arguments are not equal.



    $manager->isnt($this, $that, "This and that are equal");



like($text, qr/regex/, CW$name)

Test if the first argument is matched by the regex passed as the second argument.



    $manager->like($this, qr/like that/i, "This and that are alike");



unlike($text, qr/regex/, CW$name)

Test if the first argument is not matched by the regex passed as the second argument.



    $manager->unlike($this, qr/like that/i, "This and that are unalike");



    pass($name)

Pass a test.



    $manager->pass(Module Loaded);



    fail($name)

Fail a test.



    $manager->fail(Stonehenge crushed by a dwarf);



    skip($reason)

Skip a single test.



    $manager->skip("We dont have that piece of scenery any more");



    skip_some($number,$reason)

Skip a number of tests.



    $manager->skip_some(11, "We dont have that piece of scenery any more");



    skip_rest(,$reason)

Skip any remaining tests.



    $manager->skip_rest("We dont have that piece of scenery any more");



    skip_all($reason)

Skip all tests. This should be called instead of plan()



    $manager->skip_all("We dont have that piece of scenery any more");



    colour($flag)

Method to enable or disable colour mode.

    color($flag)

An alias for colour().

INTERNAL METHODS

finish()

This method is called automatically when the Badger::Test::Manager object is destroyed. It flushes any pending tests, performs any final sanity checks and prints a summary if requested.

flush()

This methods flushes any cached test results. You don’t need to worry about it.

summary()

This method generates a final summary of the tests

test_msg()

Used to generate the test messages displayed via the Badger::Base messages() method. The message formats are defined in the $MESSAGES package variable.

test_name()

Use to generate a name for a test if one isn’t explicitly provided.

    different($expect,$result)

This method is call when a test find a result that doesn’t match the expected value. If Algorithm::Diff is installed on your machine, it will generate a message showing how the output and expected values differ.

Otherwise it will generate a regular message reporting the mismatch.

AUTHOR

Andy Wardley <http://wardley.org/>

COPYRIGHT

Copyright (C) 1996-2009 Andy Wardley. All Rights Reserved.

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

SEE ALSO

Badger::Test
Search for    or go to Top of page |  Section 3 |  Main Index


perl v5.20.3 BADGER::TEST::MANAGER (3) 2012-01-23

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.