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.