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.

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.