GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  CPAN::REPORTER::HISTORY (3)

.ds Aq ’

NAME

CPAN::Reporter::History - Read or write a CPAN::Reporter history log

CONTENTS

VERSION

version 1.2014

SYNOPSIS



     use CPAN::Reporter::History have_tested;

     @results = have_tested( dist => Dist-Name-1.23 );



DESCRIPTION

Interface for interacting with the CPAN::Reporter history file. Most methods are private for use only within CPAN::Reporter itself. However, a public function is provided to query the history file for results.

USAGE

The following function is available. It is not exported by default.

CWhave_tested()



     # all reports for Foo-Bar-1.23
     @results = have_tested( dist => Foo-Bar-1.23 );

     # all NA reports
     @results = have_tested( grade => NA );

     # all reports on the current Perl/platform
     @results = have_tested();



Searches the CPAN::Reporter history file for records exactly matching search criteria, given as pairs of field-names and desired values.

Ordinary search criteria include:
o dist — the distribution tarball name without any filename suffix; from a CPAN::Distribution object, this is provided by the base_id method.
o phase — phase the report was generated during: either ’PL’, ’make’ or ’test’
o gradeCPAN Testers grade: ’PASS’, ’FAIL’, ’NA’ or ’UNKNOWN’; Also may be ’DISCARD’ for any failing reports not sent due to missing prerequisites
Without additional criteria, a search will be limited to the current version of Perl and the current architecture and OS version. Additional criteria may be specified explicitly or, by specifying the empty string, q{}, will match that field for any record.



     # all reports for Foo-Bar-1.23 on any version of perl
     # on the current architecture and OS version
     @results = have_tested( dist => Foo-Bar-1.23, perl => q{} );



These additional criteria include:
o perl — perl version and possible patchlevel; this will be dotted decimal (5.6.2) starting with version 5.6, or will be numeric style as given by $] for older versions; if a patchlevel exists, it must be specified similar to 5.11.0 patch 12345
o archname — platform architecture name as given by $Config{archname}
o osvers — operating system version as given by $Config{osvers}
The function returns an array of hashes representing each test result, with all of the fields listed above.

SEE ALSO

o CPAN::Reporter
o CPAN::Reporter::FAQ

AUTHOR

David Golden <dagolden@cpan.org>

COPYRIGHT AND LICENSE

This software is Copyright (c) 2006 by David Golden.

This is free software, licensed under:



  The Apache License, Version 2.0, January 2004



Search for    or go to Top of page |  Section 3 |  Main Index


perl v5.20.3 CPAN::REPORTER::HISTORY (3) 2015-04-06

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.