On Tue, 13 Jul 2004, Hill, Ronald wrote:
> Has anyone seen this:
> http://pjcj.sytes.net/cpancover/
>
> What is it? and more importantly, what do the columns mean? Is this
> something the we (the developers) need to worry about?
These are coverage reports for CPAN modules' test suites. The columns
tell you what percent of certain things in a distro are being covered by
the tets. Pod coverage refers to documentation of public
methods/functions.
And yes, it's worth worrying about. Low coverage means your code is more
likely to have bugs.
If you use the latest Module::Build, you can generate coverage reports
very easily by running './Build testcover'.
Keep in mind that 100% coverage is often impossible. For example,
DateTime.pm includes this bit of code:
if ( $] >= 5.006 )
{
require XSLoader;
XSLoader::load( 'DateTime', $DateTime::VERSION );
}
else
{
require DynaLoader;
@DateTime::ISA = 'DynaLoader';
DateTime->bootstrap( $DateTime::VERSION );
}
To get this covered in a single testing run would be really difficult.
OTOH, looking through the coverage results, there are plenty of things
being missed by the DateTime.pm tests that could be covered.
-dave
/*=======================
House Absolute Consulting
www.houseabsolute.com
=======================*/