NAME

ExtUtils::MakeMaker::Coverage - add a Makefile target to determine test coverage using Devel::Cover

VERSION

Version 0.03

SYNOPSIS

This module adds an additional target to the Makefile generated by ExtUtils::MakeMaker. The target, testcover, calls cover, the command-line script to generate test coverage statistics, to clean up any data from a previous run. It then runs the tests, as if make test was run, then calls cover again to generate the coverage statistics.

   # In Makefile.PL
   use ExtUtils::MakeMaker;
   use ExtUtils::MakeMaker::Coverage;
   ...
   # if you already have a MY::postamble...
   sub MY::postamble {
       testcover();
       ...
   }

In your shell

> perl Makefile.PL
> make
> make testcover

METHODS

testcover

This method is exported for use when there already is a MY::postamble in the Makefile.PL. In that case, adding a call to the testcover method will add the necessary Makefile steps.

NOTES

This is alpha quality code in terms of features. For this module to be usable for the as many modules as possible, the following additional features are needed.

BSD make

From my testing, if you run the testcover step using a BSD make, you will get coverage statistics for the test scripts. This is not at all useful. gmake is suggested until this issue is resolved.

nmake

I have not tested this enough with nmake. I have done some initial changes to make it work, but it requires more refactoring to get to where I'd like to see it. Expect full support in a release or two.

AUTHOR

Steve Peters, <steve@fisharerojo.org>

BUGS

Please report any bugs or feature requests to bug-extutils-makemaker-coverage@rt.cpan.org, or through the web interface at http://rt.cpan.org. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

ACKNOWLEDGEMENTS

Paul Johnson

For developing Devel::Cover and enduring my many questions on IRC.

Andy Lester

For helping to make me a test-infected Perl programmer.

SEE ALSO

Devel::Cover

http://qa.perl.org

COPYRIGHT & LICENSE

Copyright 2005 Steve Peters, All Rights Reserved.

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.