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.