1CPAN::Reporter::HistoryU(s3e)r Contributed Perl DocumentaCtPiAoNn::Reporter::History(3)
2
3
4

NAME

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

VERSION

9       version 1.2018
10

SYNOPSIS

12            use CPAN::Reporter::History 'have_tested';
13
14            @results = have_tested( dist => 'Dist-Name-1.23' );
15

DESCRIPTION

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

USAGE

23       The following function is available.  It is not exported by default.
24
25   "have_tested()"
26            # all reports for Foo-Bar-1.23
27            @results = have_tested( dist => 'Foo-Bar-1.23' );
28
29            # all NA reports
30            @results = have_tested( grade => 'NA' );
31
32            # all reports on the current Perl/platform
33            @results = have_tested();
34
35       Searches the CPAN::Reporter history file for records exactly matching
36       search criteria, given as pairs of field-names and desired values.
37
38       Ordinary search criteria include:
39
40       ·   "dist" -- the distribution tarball name without any filename
41           suffix; from a "CPAN::Distribution" object, this is provided by the
42           "base_id" method.
43
44       ·   "phase" -- phase the report was generated during: either 'PL',
45           'make' or 'test'
46
47       ·   "grade" -- CPAN Testers grade: 'PASS', 'FAIL', 'NA' or 'UNKNOWN';
48           Also may be 'DISCARD' for any failing reports not sent due to
49           missing prerequisites
50
51       Without additional criteria, a search will be limited to the current
52       version of Perl and the current architecture and OS version.
53       Additional criteria may be specified explicitly or, by specifying the
54       empty string, "q{}", will match that field for any record.
55
56            # all reports for Foo-Bar-1.23 on any version of perl
57            # on the current architecture and OS version
58            @results = have_tested( dist => 'Foo-Bar-1.23', perl => q{} );
59
60       These additional criteria include:
61
62       ·   "perl" -- perl version and possible patchlevel; this will be dotted
63           decimal (5.6.2) starting with version 5.6, or will be numeric style
64           as given by $] for older versions; if a patchlevel exists, it must
65           be specified similar to "5.11.0 patch 12345"
66
67       ·   "archname" -- platform architecture name as given by
68           $Config{archname}
69
70       ·   "osvers" -- operating system version as given by $Config{osvers}
71
72       The function returns an array of hashes representing each test result,
73       with all of the fields listed above.
74

SEE ALSO

76       ·   CPAN::Reporter
77
78       ·   CPAN::Reporter::FAQ
79

AUTHOR

81       David Golden <dagolden@cpan.org>
82
84       This software is Copyright (c) 2006 by David Golden.
85
86       This is free software, licensed under:
87
88         The Apache License, Version 2.0, January 2004
89
90
91
92perl v5.28.1                      2016-06-21        CPAN::Reporter::History(3)
Impressum