NAME

Test::Dist - Distribution kwalitee tests in one command

VERSION

Version 0.01

SYNOPSIS

        use Test::More;
        use Test::Dist as => 0.01;
        # using as => $version in use you may avoid breakage
        # due to future tests additions to this module
        use lib::abs '../lib';
        chdir lib::abs::path('..');

        Test::Dist::dist_ok(
        '+'   => 1, # Add one more test to plan due to NoWarnings
        run   => 1, # Start condition. By default uses $ENV{TEST_AUTHOR}
        skip  => [qw(prereq)], # Skip prereq from testing
        fixme => { # For options, see Test::Fixme
            match => qr/FIXIT|!!!/, # Your own fixme patterns
        },
        kwalitee => {
            req => [qw( has_separate_license_file has_example )], # Optional metrics, that you require to pass
        },
        );

        # Also, see examples and tests in this distribution

FUNCTIONS
dist_ok(%options)
TESTS

kwalitee

Use Module::CPANTS::Analyse for testing kwalitee

metayml

Check "META.yml" using Test::YAML::Meta

changes

Check the correctness of "Changelog" file

fixme

Test all modules and scripts using Test::Fixme

useok

Loading all modules by Test::More"::use:ok"

syntax

Checking all scripts by perl -c $file

podcover

Checking all modules for POD coverage using Test::Pod::Coverage

prereq

Checking prereq list using Test::Prereq

OPTIONS

'+' => 1|0

How many tests add to plan

run [ = $ENV{TEST_AUTHOR} ]

Run condition for test

skip => [ TESTS ]

Skip some of tests

kwalitee : { req => [ LIST ] }

Force checking for some of optional metrics

metayml : [ LIST ]

For options see Test::YAML::Meta

fixme

For options see Test::Fixme

useok : { ... }

        useok => {
            file_match => qr{^lib/.*\.pm$},
            mod_skip   => [ 'Module::Developed', qr{^Module::Developed::} ],
        }

syntax

        syntax => {
            file_match => qr{^(lib|bin|script)/.*\.p(?:m|l|od)$},
            file_skip  => [ 'script/dummy.pl', qr{^bin/t/} ],
            match      => qr{!!!},
        }

podcover

        podcover => {
            mod_match  => qr{^Only::Some::Scope},
            mod_skip   => [ 'Only::Some::Scope::Developed', qr{^Only::Some::Scope::Developed::} ],
        }

prereq

For options see Test::Prereq

AUTHOR

Mons Anderson, "<mons at cpan.org>"

BUGS

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

ACKNOWLEDGEMENTS

Thanks to

• Alexandr Ciornii for Module::CPANTS::Analyse
• brian d. foy for Test::Prereq
• Barbie for Test::YAML::Meta
• Edmund von der Burg for Test::Fixme
• Andy Lester for Test::Pod::Coverage
• G. Allen Morris III for Test::CheckChanges

COPYRIGHT & LICENSE

Copyright 2009 Mons Anderson, all rights reserved.

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