NAME

Test::AllModules - do some tests for modules in search path

SYNOPSIS

    use Test::AllModules;

    all_ok(
        search_path => 'MyApp',
        use => 1,
    );

Here is also same as above

    use Test::AllModules;

    all_ok(
        search_path => 'MyApp',
        check => sub {
            my $class = shift;
            eval "use $class;1;";
        },
    );

DESCRIPTION

Test::AllModules is do some tests for all modules in search path.

EXPORTED FUNCTIONS

all_ok(%args)

do check(s) code as Test::More::ok() for every module in search path.

  • search_path => 'Class'

    A namespace to look in. see: Module::Pluggable::Object

  • use => boolean

    If this option sets true value then do a load module(use) test.

    This parameter is optional.

  • require => boolean

    If this option sets true value then do a load module(require) test.

    This parameter is optional.

  • no_import => boolean

    If this option sets true value then do not import any function when a test module is loaded.

    This parameter is optional.

  • check => \&test_code_ref or hash( TEST_NAME => \&test_code_ref )

  • checks => \@array: include hash( TEST_NAME => \&test_code_ref )

    The code to execute each module. The code receives $class and $count. The result from the code will be passed to Test::More::ok(). So, test codes must return true value if test is OK.

  • except => \@array: include scalar or qr//

    Ignore modules.

    This parameter is optional.

  • lib => \@array

    Additional library paths.

    This parameter is optional.

  • fork => 1:fork, 2:fork and show PID

    If this option was set a value(1 or 2) then each check-code executes after forking.

    This parameter is optional.

    NOTE that this fork option is NOT supported in Windows system.

  • shuffle => boolean

    If this option was set the true value then modules will be sorted in random order.

    This parameter is optional.

  • show_version => boolean

    If this option was set the true value then the version of module will be shown if it's possible.

    This parameter is optional.

  • before_hook => code ref

    This code ref executes before test.

        before_hook => sub {
            my ($test_code, $class, $count) = @_;
    
            # ... do something ...
    
            return;
        },

    NOTE that if you return true value from before_hook, then the test will skip.

    This parameter is optional.

  • after_hook => code ref

    This code ref executes after test.

        after_hook  => sub {
            my ($ret, $test_code, $class, $count) = @_;
    
            # ... do something ...
        },

    This parameter is optional.

EXAMPLES

If you need the name of test, then you can use check parameter: check = { test_name => sub { 'test' } }>

    use Test::AllModules;

    all_ok(
        search_path => 'MyApp',
        check => +{
            'use_ok' => sub {
                my ($class, $test_count) = @_;
                eval "use $class;1;";
            },
        },
    );

more tests, all options

    use Test::AllModules;

    all_ok(
        search_path => 'MyApp',
        use     => 1,
        require => 1,
        checks  => [
            +{
                'use_ok' => sub {
                    my $class = shift;
                    eval "use $class; 1;";
                },
            },
        ],
        except => [
            'MyApp::Role',
            qr/MyApp::Exclude::.*/,
        ],
        lib => [
            'lib',
            't/lib',
        ],
        shuffle   => 1,
        fork      => 1,
        no_import => 1,
    );

REPOSITORY

Test::AllModules is hosted on github <http://github.com/bayashi/Test-AllModules>

AUTHOR

dann

Dai Okabayashi <bayashi@cpan.org>

SEE ALSO

Test::LoadAllModules

LICENSE

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