NAME
Module::Build::Kwalitee - Module::Build subclass with prepackaged tests
SYNOPSIS
This module requires this bit of magic in your Build.PL:
use lib 'mbk';
use Module::Build::Kwalitee;
Module::Build::Kwalitee->new(
module_name => 'Foo::Bar',
...,
},
)->create_build_script();
DESCRIPTION
Module::Build::Kwalitee subclasses Module::Build to provide boilerplate
tests for your project. It does this by overriding "new()" and copying
tests to your t directory when you run 'perl Build.PL'.
Module::Build::Kwalitee gets over the bootstrapping problem by
overriding Module::Build's "distdir" target, adding a "mbk" directory to
your distribution containing a small stub Module::Build::Kwalitee which
just overrides Module::Build's build_requires() method to add the
dependencies of its tests.
Module::Build::Kwalitee tests are not automatically added to MANIFEST so
if you want them shipped with your distribution you will have to do this
manually.
Tests
Several boilerplate tests are added to t/:
compile test
"use strict" test
"use warnings" tests
POD syntax & coverage tests
'use lib' test
ADDITIONAL FEATURES
You can get the "t/003pod.t" to report which functions are not
documented by using the "SHOW_NAKED" enviromental variable
bash$ SHOW_NAKED=1 perl -Ilib t/003compile.t
SEE ALSO
Module::Build
AUTHOR
Stig Brautaset <
[email protected]>, Mark Fowler
<
[email protected]>, Norman Nunley <
[email protected]>,
Chia-liang Kao <
[email protected]>, et al.