CPAN::Reporter::History - Read or write a CPAN::Reporter history log
version 1.2010
use CPAN::Reporter::History 'have_tested'; @results = have_tested( dist => 'Dist-Name-1.23' );
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.
The following function is available. It is not exported by default.
have_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:
dist -- the distribution tarball name without any filename suffix; from a CPAN::Distribution object, this is provided by the base_id method.
dist
CPAN::Distribution
base_id
phase -- phase the report was generated during: either 'PL', 'make' or 'test'
phase
grade -- CPAN Testers grade: 'PASS', 'FAIL', 'NA' or 'UNKNOWN'; Also may be 'DISCARD' for any failing reports not sent due to missing prerequisites
grade
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.
q{}
# 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:
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"
perl
$]
archname -- platform architecture name as given by $Config{archname}
archname
osvers -- operating system version as given by $Config{osvers}
osvers
The function returns an array of hashes representing each test result, with all of the fields listed above.
CPAN::Reporter
CPAN::Reporter::FAQ
David Golden <dagolden@cpan.org>
Alexandr Ciornii <alexchorny@gmail.com>
Breno G. de Oliveira <garu@cpan.org>
Christian Walde <walde.christian@googlemail.com>
Kent Fredric <kentfredric@gmail.com>
Matthew Musgrove <mr.muskrat@gmail.com>
This software is Copyright (c) 2006 by David Golden.
This is free software, licensed under:
The Apache License, Version 2.0, January 2004
To install CPAN::Reporter, copy and paste the appropriate command in to your terminal.
cpanm
cpanm CPAN::Reporter
CPAN shell
perl -MCPAN -e shell install CPAN::Reporter
For more information on module installation, please visit the detailed CPAN module installation guide.