1CPAN::Reporter::FAQ(3)User Contributed Perl DocumentationCPAN::Reporter::FAQ(3)
2
3
4
6 CPAN::Reporter::FAQ - Answers and tips for using CPAN::Reporter
7
9 version 1.2018
10
12 Why did I receive a report?
13 Historically, CPAN Testers was designed to have each tester send a copy
14 of reports to authors. This philosophy changed in September 2008 and
15 CPAN Testers tools were updated to no longer copy authors, but some
16 testers may still be using an older version.
17
18 Why was a report sent if a prerequisite is missing?
19 As of CPAN::Reporter 0.46, FAIL and UNKNOWN reports with unsatisfied
20 prerequisites are discarded. Earlier versions may have sent these
21 reports out by mistake as either an NA or UNKNOWN report.
22
23 PASS reports are not discarded because it may be useful to know when
24 tests passed despite a missing prerequisite. NA reports are sent
25 because information about the lack of support for a platform is
26 relevant regardless of prerequisites.
27
29 Why did I get an error sending a test report?
30 Historically, test reports were sent via ordinary email. The most
31 common reason for errors sending a report back then was that many
32 Internet Service Providers (ISP's) would block outbound SMTP (email)
33 connections as part of their efforts to fight spam.
34
35 Since 2010, test reports are sent to the CPAN Testers Metabase over
36 HTTPS. The most common reason for failures are systems which upgraded
37 CPAN::Reporter but are still configured to use the deprecated and
38 unsupported email system instead of Metabase for transport.
39
40 If you are unsure which transport mechanism you're using, look for the
41 "transport" rule in the ".cpanreporter/config.ini" file, in the user's
42 home directory. See CPAN::Reporter::Config for details on how to set
43 the "transport" option for Metabase.
44
45 Other errors could be caused by the absence of the
46 ".cpanreporter/metabase_id.json" file in the user's home directory.
47 This file should be manually created prior to sending any reports, via
48 the "metabase-profile" program. Simply run it and fill in the
49 information accordingly, and it will create the "metabase_id.json" file
50 for you. Move that file to your ".cpanreporter" directory and you're
51 all set.
52
53 If you experience intermittent network issues, you can set the
54 'retry_submission' option to make a second attempt at sending the
55 report a few seconds later, in case the first one fails. This could be
56 useful for extremely slow connections.
57
58 Finally, lack of Internet connection or firewall filtering will prevent
59 the report from reaching the CPAN Testers servers. If you are
60 experiencing HTTPS issues or messages complaining about SSL modules,
61 try installing the LWP::Protocol::https module and trying again. If all
62 fails, you may still change the transport uri to use HTTP instead of
63 HTTPS, though this is not recommended.
64
65 Why didn't my test report show up on CPAN Testers?
66 There is a delay between the time reports are sent to the Metabase and
67 when they they appear on the CPAN Testers website. There is a further
68 delay before summary statistics appear on search.cpan.org. If your
69 reports do not appear after 24 hours, please contact the cpan-testers-
70 discuss email list
71 (<http://lists.perl.org/list/cpan-testers-discuss.html>) or join the
72 "#cpantesters-discuss" IRC channel on "irc.perl.org".
73
75 Where can I find out more about CPAN Testers?
76 A good place to start is the CPAN Testers Wiki:
77 <http://wiki.cpantesters.org/>
78
79 Where can I find statistics about reports sent to CPAN Testers?
80 CPAN Testers statistics are compiled at <http://stats.cpantesters.org/>
81
82 How do I make sure I get credit for my test reports?
83 To get credit in the statistics, use the same Metabase profile file and
84 the same email address wherever you run tests.
85
87 · CPAN::Testers
88
89 · CPAN::Reporter
90
91 · Test::Reporter
92
94 David Golden <dagolden@cpan.org>
95
97 This software is Copyright (c) 2006 by David Golden.
98
99 This is free software, licensed under:
100
101 The Apache License, Version 2.0, January 2004
102
103
104
105perl v5.30.0 2019-07-26 CPAN::Reporter::FAQ(3)