NAME

T2 - Define the T2 namespace that can always be used to access functionality from a Test2 bundle such as Test2::V1.

DESCRIPTION

If you want a global T2 that can be called from anywhere, without needing to import Test2::V1 in every package, you can do that with the T2 module.

This defines the T2 namespace so you can always call methods on it like T2->ok(1, "pass") and T2->done_testing.

SYNOPSIS

Create a file/package somewhere to initialize it. Only initialize it once!

package My::Global::T2;

# Load Test2::V1 (or future bundle)
# Add any customizations like including extra tools, overriding tools, etc.
use Test2::V1 ...;

# Load T2, it will find the T2() handle in the current package and make it global
use T2;

#########################################
# Alternatively you can do this:
my $handle = Test2::V1::Handle->new(...);
require T2;
T2->import($handle);

Now use it somewhere in your code:

use My::Global::T2;

Now T2 is available from any package

T2->ok(1, "pass");
T2->ok(0, "fail");

T2->done_testing;

Note: In this case T2 is a package name, not a function, so T2() will not work. However you can import Test2::V1 into any package providing a T2() function that will be used preferentially to the T2 namespace.

Bonus: You can use the T2::tool(...) form to leverage the original prototype of the tool.

T2::is(@foo, 3, "Array has 3 elements");

Without the prototype (method form does not allow prototypes) you would have to prefix scalar on @foo:

T2->is(scalar(@foo), 3, "Array matches expections");

SOURCE

The source code repository for T2 can be found at https://github.com/Test-More/T2/.

MAINTAINERS

• Chad Granum exodist@cpan.org

AUTHORS

• Chad Granum exodist@cpan.org

COPYRIGHT

Copyright Chad Granum exodist@cpan.org.

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

See http://dev.perl.org/licenses/