File Coverage

blib/lib/CPAN/Cover/Results.pm

Criterion	Covered	Total	%
statement	9	11	81.8
branch			n/a
condition			n/a
subroutine	3	4	75.0
pod			n/a
total	12	15	80.0

package CPAN::Cover::Results;
$CPAN::Cover::Results::VERSION = '0.03';
use CPAN::Cover::Results::ReleaseIterator;

use 5.006;
use Moo;
with 'MooX::Role::CachedURL'
    # => { -version => 0.03 }
    ;

has '+url' =>
    (
        default => sub { 'http://cpancover.com/latest/cpancover.json.gz' },
    );

sub release_iterator
{
    my $self = shift;

    return CPAN::Cover::Results::ReleaseIterator->new( results => $self );
}

1;

=head1 NAME

CPAN::Cover::Results - get CPAN coverage test results from CPAN Cover service

=head1 SYNOPSIS

 use CPAN::Cover::Results;

 my $iterator = CPAN::Cover::Results->new()->release_iterator();

 while (my $release = $iterator->next) {
     printf "%s (%s) : %.2f\n",
            $release->distname,
            $release->version,
            $release->total;
 }

=head1 DESCRIPTION

This module will get the coverage test results from the
L
service and let you iterate over them, distribution by distribution.
CPAN Cover is a service that runs L
on as much of CPAN as possible,
and makes the results available.

The release iterator returns instances of L,
which has the following attributes:

=over 4

=item * distname - the name of the distribution, as determined
by L.

=item * version - the version number of the release.

=item * branch - the branch coverage of the release's testsuite,
or C.

=item * condition - the condition coverage figure, or C.

=item * pod - the pod coverage, if available, or C.

=item * statement - the statement coverage, or C.

=item * subroutine - the subroutine coverage, or C.

=item * total - the total coverage.

=back

See the L documentation for more information on the
different coverage figures.

=head1 SEE ALSO

L - the module used to generate test coverage statistics.

L - the coverage testing service that
generates the results accessed via this module.

L - slides from a talk by Paul Johnson, the author
of Devel::Cover and cpancover.

L - the release iterator returns instances
of this class.

=head1 REPOSITORY

L

=head1 AUTHOR

Neil Bowers [e-mail]

=head1 COPYRIGHT AND LICENSE

This software is copyright (c) 2014 by Neil Bowers .

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

=cut