Re: [OT] CPAN coverage report What is it?

2004-07-13 Thread Rick Measham
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?

On 14 Jul 2004, at 1:24 AM, Dave Rolsky wrote:
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.
Congrats to:
 - DateTime::Format::Bork and
 - DateTime::Format::HTTP
Both have 100% coverage!
Now I'm going through my modules and expanding on the tests - at least 
for the important modules like DT::F::Strptime and DT::F::Duration (and 
DT::E::Easter). I don't think I'll do too much extra testing on 
DT::F::Baby unless I have some absolutely-nothing-to-do time!

Cheers!
Rick
Senior Developer
PrintSupply - Print Procurement & Supply Management
18 Greenaway Street VIC 3105
Tel: (03) 9850 3255
Fx: (03) 9850 3277
http://www.printsupply.com.au/



Re: [OT] CPAN coverage report What is it?

2004-07-13 Thread Dave Rolsky
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
===*/


Re: [OT] CPAN coverage report What is it?

2004-07-13 Thread Andy Lester
On Tue, Jul 13, 2004 at 07:48:17AM -0700, Hill, Ronald ([EMAIL PROTECTED]) wrote:
> Hi All,
> 
> Has anyone seen this:
> http://pjcj.sytes.net/cpancover/

That report is created by Devel::Cover.  It measures how much of your
code is executed by the test suite.  If a line of code (or subroutine)
doesn't get executed when the test suite runs, then it can't have been
tested, right?

> What is it? and more importantly, what do the
> columns mean? Is this something the we (the developers)
> need to worry about?

Depends on what you mean by "worry".  There is a project called Phalanx
that exists to improve the test suites of key Perl modules.  See
http://qa.perl.org/phalanx/ for details.  Some of the Date::* modules
are in our sights to be improved.

xoa

-- 
Andy Lester => [EMAIL PROTECTED] => www.petdance.com => AIM:petdance


[OT] CPAN coverage report What is it?

2004-07-13 Thread Hill, Ronald
Hi All,

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?

Thanks

Ron Hill