blib/lib/CPAN/Porters.pm

filter: Statementstmt 100% 8 / 8 Branchbran n/a Conditioncond n/a MC/DCmcdc n/a Subroutinesub 100% 2 / 2 Podpod n/a totaltotal 100% 10 / 10 CC 1 SCAR 0.0
CC
1
Cov
100%
BEGIN
1.0
BEGIN
1.0
CRAP 1.0
↑ Summary
1 package CPAN::Porters;
2 2 ▶use strict;
Subroutine BEGIN: called CC=1 SCAR=0.0
3 2 ▶use warnings;
Subroutine BEGIN: called CC=1 SCAR=0.0
4  
5 2 our $VERSION = '0.04';
6  
7 2 1;
8  
9  
10 =head1 NAME
11  
12 CPAN::Porters - resource for people maintaining packages of CPAN modules in various distributions
13  
14 =head1 SYNOPSIS
15  
16 CPAN modules can be either installed from source (downloaded directly from CPAN)
17 or they can be installed with the package mangement system of your distribution.
18  
19 CPAN::Porters is a resource for people who are maintaining those packages in the
20 various distributions.
21  
22 =head1 Reasoning
23  
24 When developing an application we usually don't want to build our own machine. Neither
25 compile our own kernel. In most of the cases we won't want to compile and install
26 our own version of a database engine nor Apache or any other 3rd party tool.
27 So my assumption is that we won't want to install our CPAN dependencies either.
28 Again - in the standard case.
29  
30 For people just using an application written in Perl it is even more important that they
31 should not deal with all these packages. Most of us know how much people suffer when they
32 need to install 10s of modules and their dependencies from CPAN. Especially for modules
33 with dependencies outside of CPAN.
34  
35 While CPAN.pm, CPANPLUS.pm have improved a lot they still cannot deal with cases when one
36 of the dependencies fails to install cleanly.
37  
38 In addition while we usually want to work with recent versions of modules from CPAN,
39 we usually don't want to get the bleeding edge. Espcially not in applications.
40  
41 =head1 General resources
42  
43 L<https://szabgab.com/distributions/> Statistics about CPAN modules in the various distributions
44  
45 =head2 Related mailing lists
46  
47 Module Authors: L<http://lists.cpan.org/showlist.cgi?name=module-authors>
48  
49 Perl QA L<https://qa.perl.org> and the mailing list L<https://lists.cpan.org/showlist.cgi?name=perl-qa>
50  
51 CPAN Testers L<https://testers.cpan.org/>
52  
53 CPAN Discuss L<https://lists.cpan.org/showlist.cgi?name=cpan-discuss>
54  
55  
56 =head1 Guidelines for inclusion
57  
58 In addition to the guidelines of each distribution on which module to include,
59 when to upgrade etc. we would like to setup our own guidelines to help people
60 decide what to include, what would be the priorites, when to upgrade a module
61 etc.
62  
63 A few guidelines on how to select and prioritize modules:
64  
65 =over 4
66  
67 =item * Modules that are dependencies of another module by a different module author.
68  
69 =item * Modules that require compilation
70  
71 =item * Modules that require files not on CPAN
72  
73 Such modules are especially difficult to install with CPAN.pm or CPANPLUS as they require
74 files outside the scope of CPAN. Making sure such modules and their dependencies can be
75 installed with the standard packaging system gets extra points.
76  
77 =item * Web development frameworks
78  
79 =item * Modules required by some of the big open source Perl applications.
80  
81 For a good listing see the journal entry of brian d foy
82 L<http://use.perl.org/~brian_d_foy/journal/9974>
83  
84 =back
85  
86 Requirements for inclusion or upgrade
87  
88 =over 4
89  
90 =item * The module already has all its prereq in the system
91  
92 =item * The module passes all its tests with its prereqs currently in the system on the system
93  
94 =item * The tests of all the currently available dependent modules in the system pass with this new version
95  
96 =item * A broader requirement would be that the version has no failing test reports on any other system,
97 though this requirement might be too harsh and unnecessary
98  
99  
100 =back
101  
102 =head1 TODO
103  
104 =over 4
105  
106 =item * Collect the basic information for the main distributions
107  
108 =back
109  
110 =head1 SEE ALSO
111  
112 L<https://www.mail-archive.com/module-authors@perl.org/msg05248.html>
113  
114 PIG has moved here: L<http://svn.ali.as/cpan/trunk/PIG/>
115  
116 cpan2dist is a script from L<CPANPLUS>
117  
118 =head1 AUTHOR
119  
120 This document is maintained by Gabor Szabo <gabor@szabgab.com>
121  
122 =cut
123  
↑ Summary