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 is developer tool. It subclasses Module::Build and overrides its new() method, so when you run 'perl Build.PL', boilerplate test files are added to t/. If you want these tests added to your distribution, you will have to add them to MANIFEST manually.

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.

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 <stig@brautaset.org>
Mark Fowler <mark@twoshortplanks.com>
Norman Nunley <nnunley@fotango.com>
Chia-link Kao <clkao@clkao.org>
et al.