Fotango Ltd > Module-Build-Kwalitee-0.24 > Module::Build::Kwalitee

Download:
Module-Build-Kwalitee-0.24.tar.gz

Dependencies

Annotate this POD

CPAN RT

New  1
Open  0
View/Report Bugs
Module Version: 0.24   Source  

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.

syntax highlighting: