File perl-Devel-Cover.spec of Package perl-Devel-Cover

Overview Repositories Revisions Requests Users Attributes Meta

File perl-Devel-Cover.spec of Package perl-Devel-Cover

#
# spec file for package perl-Devel-Cover
#
# Copyright (c) 2012 SUSE LINUX Products GmbH, Nuernberg, Germany.
#
# All modifications and additions to the file contributed by third parties
# remain the property of their copyright owners, unless otherwise agreed
# upon. The license for this file, and modifications and additions to the
# file, is the same license as for the pristine package itself (unless the
# license for the pristine package is not an Open Source License, in which
# case the license is the MIT License). An "Open Source License" is a
# license that conforms to the Open Source Definition (Version 1.9)
# published by the Open Source Initiative.

# Please submit bugfixes or comments via http://bugs.opensuse.org/
#

Name:           perl-Devel-Cover
Version:        0.87
Release:        0
%define cpan_name Devel-Cover
Summary:        Code coverage metrics for Perl
License:        Artistic-1.0 or GPL-1.0+
Group:          Development/Libraries/Perl
Url:            http://search.cpan.org/dist/Devel-Cover/
Source:         http://www.cpan.org/authors/id/P/PJ/PJCJ/%{cpan_name}-%{version}.tar.gz
BuildRoot:      %{_tmppath}/%{name}-%{version}-build
BuildRequires:  perl
BuildRequires:  perl-macros
BuildRequires:  perl(Test::Warn)
#BuildRequires: perl(DC::Test::Dist)
#BuildRequires: perl(DC::Test::Dist::M1)
#BuildRequires: perl(Devel::Cover)
#BuildRequires: perl(Devel::Cover::Branch)
#BuildRequires: perl(Devel::Cover::Condition)
#BuildRequires: perl(Devel::Cover::Condition_and_2)
#BuildRequires: perl(Devel::Cover::Condition_and_3)
#BuildRequires: perl(Devel::Cover::Condition_or_2)
#BuildRequires: perl(Devel::Cover::Condition_or_3)
#BuildRequires: perl(Devel::Cover::Condition_xor_4)
#BuildRequires: perl(Devel::Cover::Criterion)
#BuildRequires: perl(Devel::Cover::DB)
#BuildRequires: perl(Devel::Cover::DB::Digests)
#BuildRequires: perl(Devel::Cover::DB::File)
#BuildRequires: perl(Devel::Cover::DB::IO)
#BuildRequires: perl(Devel::Cover::DB::Structure)
#BuildRequires: perl(Devel::Cover::Dumper)
#BuildRequires: perl(Devel::Cover::Inc)
#BuildRequires: perl(Devel::Cover::Pod)
#BuildRequires: perl(Devel::Cover::Report::Html_minimal)
#BuildRequires: perl(Devel::Cover::Statement)
#BuildRequires: perl(Devel::Cover::Subroutine)
#BuildRequires: perl(Devel::Cover::Test)
#BuildRequires: perl(Devel::Cover::Time)
#BuildRequires: perl(Devel::Cover::Truth_Table)
#BuildRequires: perl(Devel::Cover::Web)
#BuildRequires: perl(Module1)
#BuildRequires: perl(Template) >= 2.00
#BuildRequires: perl(Template::Provider)
Requires:       perl(Test::Warn)
Recommends:     perl(JSON::PP)
Recommends:     perl(Parallel::Iterator)
Recommends:     perl(Perl::Tidy) >= 20060719
Recommends:     perl(Pod::Coverage) >= 0.06
Recommends:     perl(Pod::Coverage::CountParents)
Recommends:     perl(PPI::HTML) >= 1.07
Recommends:     perl(Template) >= 2.00
Recommends:     perl(Test::Differences)
%{perl_requires}

%description
This module provides code coverage metrics for Perl. Code coverage metrics
describe how thoroughly tests exercise code. By using Devel::Cover you can
discover areas of code not exercised by your tests and determine which
tests to create to increase coverage. Code coverage can be considered as an
indirect measure of quality.

Although it is still being developed, Devel::Cover is now quite stable and
provides many of the features to be expected in a useful coverage tool.

Statement, branch, condition, subroutine, and pod coverage information is
reported. Statement coverage data should be reasonable. Branch and
condition coverage data should be mostly accurate too, although not always
what one might initially expect. Subroutine coverage should be as accurate
as statement coverage. Pod coverage comes from the Pod::Coverage manpage.
If the Pod::Coverage::CountParents manpage is available it will be used
instead. Coverage data for other criteria are not yet collected.

The _cover_ program can be used to generate coverage reports. Devel::Cover
ships with a number of different reports including various types of HTML
output, textual reports, a report to display missing coverage in the same
format as compilation errors and a report to display coverage information
within the Vim editor.

It is possible to add annotations to reports, for example you could add a
column to an HTML report showing who last changed a line, as determined by
git blame. Some annotation modules are shipped with Devel::Cover and you
can easily create your own.

The _gcov2perl_ program can be used to convert gcov files to 'Devel::Cover'
databases. This allows you to display your C or XS code coverage together
with your Perl coverage, or to use any of the Devel::Cvoer reports to
display your C coverage data.

You may find that the coverage results don't match your expectations. This
could be due to a bug in Devel::Cover, but code coverage can be unintuitive
to newcomers, and especially so with Perl, so you may want to reconsider
your expectations as well.

Code coverage data are collected by replacing perl ops with functions which
count how many times the ops are executed. These data are then mapped back
to reality using the B compiler modules. There is also a statement
profiling facility which should not be relied on. For proper profiling use
Devel::NYTProf. Previous versions of Devel::Cover collected coverage data
by replacing perl's runops function. It is still possible to switch to that
mode of operation, but this now gets little testing and will probably be
removed soon. You probably don't care about any of this.

The most appropriate mailing list on which to discuss this module would be
perl-qa. Discussion has migrated there from perl-qa-metrics which is now
defunct. See the http://lists.perl.org/list/perl-qa.html manpage.

The Devel::Cover repository can be found at the
http://github.com/pjcj/Devel--Cover manpage.

%prep
%setup -q -n %{cpan_name}-%{version}
find . -type f -print0 | xargs -0 chmod 644

%build
%{__perl} Makefile.PL INSTALLDIRS=vendor OPTIMIZE="%{optflags}"
%{__make} %{?_smp_mflags}

%check
%{__make} test

%install
%perl_make_install
%perl_process_packlist
%perl_gen_filelist

%files -f %{name}.files
%defattr(-,root,root,755)
%doc Changes docs README tests utils

%changelog

Places

File perl-Devel-Cover.spec of Package perl-Devel-Cover

Places