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