The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

Test::More::Tools - Generic form of tools from Test::More.

DESCRIPTION

People used to call Test::More tools within other testing tools. This mostly works, but it generates events for each call. This package gives you access to the implementations directly, without generating events for you. This allows you to create a composite tool without generating extra events.

SYNOPSYS

    use Test::More::Tools qw/tmt/;
    use Test::Stream::Toolset qw/context/;

    # This is how Test::More::is is implemented
    sub my_is {
        my ($got, $want, $name) = @_;

        my $ctx = context;

        my ($ok, @diag) = tmt->is_eq($got, $want);

        $ctx->ok($ok, $name, \@diag);
    }

EXPORTS

$pkg = tmt()

Simply returns the string 'Test::More::Tools';

CLASS METHODS

Not all methods are listed. The ones that have been omitted are not intuitive, and probably should not be used at all.

($bool, @diag) = tmt->cmp_check($got, $op, $want)

Check 2 values using the operator specified example: $got == $want

($bool, @diag) = tmt->is_eq($got, $want)

String compare.

($bool, @diag) = tmt->is_num($got, $want)

Numeric compare.

($bool, @diag) = tmt->isnt_eq($got, $dont_want)

String inequality compare.

($bool, @diag) = tmt->isnt_num($got, $dont_want)

Numeric inequality compare.

($bool, @diag) = tmt->regex_check($got, $regex, $op)

Regex compare. $op may be =~ or !~.

SOURCE

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

MAINTAINER

Chad Granum <exodist@cpan.org>

AUTHORS

The following people have all contributed to the Test-More dist (sorted using VIM's sort function).

Chad Granum <exodist@cpan.org>
Fergal Daly <fergal@esatclear.ie>>
Mark Fowler <mark@twoshortplanks.com>
Michael G Schwern <schwern@pobox.com>
唐鳳

COPYRIGHT

There has been a lot of code migration between modules, here are all the original copyrights together:

Test::Stream
Test::Stream::Tester

Copyright 2014 Chad Granum <exodist7@gmail.com>.

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

See http://www.perl.com/perl/misc/Artistic.html

Test::Simple
Test::More
Test::Builder

Originally authored by Michael G Schwern <schwern@pobox.com> with much inspiration from Joshua Pritikin's Test module and lots of help from Barrie Slaymaker, Tony Bowden, blackstar.co.uk, chromatic, Fergal Daly and the perl-qa gang.

Idea by Tony Bowden and Paul Johnson, code by Michael G Schwern <schwern@pobox.com>, wardrobe by Calvin Klein.

Copyright 2001-2008 by Michael G Schwern <schwern@pobox.com>.

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

See http://www.perl.com/perl/misc/Artistic.html

Test::use::ok

To the extent possible under law, 唐鳳 has waived all copyright and related or neighboring rights to Test-use-ok.

This work is published from Taiwan.

http://creativecommons.org/publicdomain/zero/1.0

Test::Tester

This module is copyright 2005 Fergal Daly <fergal@esatclear.ie>, some parts are based on other people's work.

Under the same license as Perl itself

See http://www.perl.com/perl/misc/Artistic.html

Test::Builder::Tester

Copyright Mark Fowler <mark@twoshortplanks.com> 2002, 2004.

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