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  -  TEST::AGGREGATE::NESTED (3)

.ds Aq ’

NAME

Test::Aggregate::Nested - Aggregate "*.t" tests to make them run faster.

CONTENTS

VERSION

Version 0.373

SYNOPSIS



    use Test::Aggregate::Nested;

    my $tests = Test::Aggregate::Nested->new( {
        dirs    => $aggregate_test_dir,
        verbose => 1,
    } );
    $tests->run;



DESCRIPTION

<B>ALPHA WARNINGB>: this is alpha code. Conceptually it is superior to Test::Aggregate, but in reality, it might not be. We’ll see.

This module is almost identical to Test::Aggregate and will in the future be the preferred way of aggregating tests (until someone comes up with something better :)

Test::Aggregate::Nested requires a 0.8901 or better of Test::More. This is because we use its subtest function. Currently we croak if this function is not available.

Because the TAP output is nested, you’ll find it much easier to see which tests result in which output. For example, consider the following snippet of TAP.



    1..2
        1..5
        ok 1 - aggtests/check_plan.t ***** 1
        ok 2 - aggtests/check_plan.t ***** 2
        ok 3 # skip checking plan (aggtests/check_plan.t ***** 3)
        ok 4 - env variables should not hang around
        ok 5 - aggtests/check_plan.t ***** 4
    ok 1 - Tests for aggtests/check_plan.t
        1..1
        ok 1 - subs work!
    ok 2 - Tests for aggtests/subs.t



At the end of each nested test is a summary test line explaining which program we ran tests for.

Test::Aggregate::Nested asserts a plan equal to the number of test files aggregated, something which Test::Aggregate could not do. Because of this, we no longer export Test::More functions. If you need additional tests before or after aggregation, you can run the aggregated tests in a subtest:



    use Test::More tests => 2;
    use Test::Aggregate::Nested;

    subtest Nested tests => sub {
        Test::Aggregate::Nested->new({ dirs => aggtests/ })->run;
    };
    ok $some_other_test;



or disable the generation of the plan with the parameter no_generate_plan:



    use Test::More;
    use Test::Aggregate::Nested;

    Test::Aggregate::Nested->new({ dirs => aggtests/, no_generate_plan => 1 })->run;
    ok $some_other_test;
    done_testing();



CAVEATS

Test::Aggregate::Nested is much cleaner than Test::Aggregate, so I don’t support the dump argument. If this is needed, let me know and I’ll see about fixing this.

The variable will not stay shared warnings from Test::Aggregate (see its CAVEATS section) are no longer applicable.

AUTHOR

Curtis Poe, <ovid at cpan.org>

BUGS

Please report any bugs or feature requests to bug-test-aggregate at rt.cpan.org, or through the web interface at <http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Test-Aggregate>. I will be notified, and then you’ll automatically be notified of progress on your bug as I make changes.

SUPPORT

You can find documentation for this module with the perldoc command.



    perldoc Test::Aggregate::Nested



You can also find information oneline:

<http://metacpan.org/release/Test-Aggregate>

ACKNOWLEDGEMENTS

Many thanks to mauzo (<http://use.perl.org/~mauzo/> for helping me find the ’skip_all’ bug.

Thanks to Johan Lindstroem for pointing me to Apache::Registry.

COPYRIGHT & LICENSE

Copyright 2007 Curtis Ovid Poe, all rights reserved.

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

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


perl v5.20.3 TEST::AGGREGATE::NESTED (3) 2015-09-28

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