NAME

T - Encapsulate testing tools instead of cluttering your namespace.

DESCRIPTION

This module collection makes it possible to use popular testing tools such as Test::More or Test2::Bundle::Extended without cluttering up your namespace. Under the hood all the work is done by Import::Box which was created specifically to implement this.

SYNOPSIS

BOX FUNCTIONS

use T 'More'; # Loads Test::More, and provides the t() box function

use T2 'Basic'; # Loads Test2::Tools::Basic, and provides the t2() function

use T2::B 'Extended'; # Loads Test2::Bundle::Extended, also provides/appends to the t2() function

use T2::P 'SRand'; # Loads Test2::Plugin::SRand, and provides the t2p() function

t->is('a', 'a', "Can run Test::More::is()");
t2->is('a', 'a', "Can run Test2::Tools::Compare::is()"); # (Provided by the extended bundle)


# Alternate syntax:

t  is => ('a', 'a');
t2 is => ('a', 'a');

OO

use T;
use T2;
use T2::B;

my $t = T->new('More'); # Loads Test::More into $t

my $t2 = T2->new('Basic'); # Loads Test2::Tools::Basic into $t2

my $t2b = T2::B->new('Extended'); # Loads Test2::Bundle::Extended into $t2b

$t->is('a', 'a', "Can run Test::More::is()");

$t2->ok(1, "ok from Test2::Tools::Basic");

$t2b->is('a', 'a', "Can run Test2::Tools::Compare::is()");


# Indirect syntax (just say NO!)

is $t('a', 'a');
ok $t2(1, "pass");
is $t2b('a', 'a');

PACKAGES

• T

  This is used for boxing Test:: modules into the t() box.

• T2

  This is used for boxing Test2::Tools:: modules into the t2() box.

• T2::B

  This is used for boxing Test2::Bundle:: modules into the t2() box.

• T2::P

  This is used for boxing Test2::Plugin:: modules into the t2p() box. A plugin should never actually export anything, so this is actually just a shortcut for loading plugins.

METHODS

• t->import($MODULE)

• $t->import($MODULE)

• t->import($MODULE => \@IMPORT_ARGS)

• $t->import($MODULE => \@IMPORT_ARGS)

  This will load $MODULE and place the exports into the box instead of your namespace. A prefix is automatically prepended to $MODULE, which prefix depends on the class used for boxing. To avoid the prefix you can append '+' to the front of $MODULE:

    t->import('+My::Module');
  

  • T

    Prefixes with Test::

  • T2

    Prefixes with Test2::Tools::

  • T2::B

    Prefixes with Test2::Bundle::

  • T2::P

    Prefixes with Test2::Plugin::

SEE ALSO

Import::Box - Everything here is based off of this module.

SOURCE

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

MAINTAINERS

• Chad Granum exodist@cpan.org

AUTHORS

• Chad Granum exodist@cpan.org

COPYRIGHT

Copyright 2016 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/