CPANPLUS::Dist::Fedora(3pm)

1CPANPLUS::Dist::Fedora(U3s)er Contributed Perl DocumentatCiPoAnNPLUS::Dist::Fedora(3)
2
3
4

NAME

6       CPANPLUS::Dist::Fedora - a cpanplus backend to build Fedora/RedHat rpms
7

VERSION

9       version 0.2.0
10

SYNOPSIS

12           cpan2dist --format=CPANPLUS::Dist::Fedora Some::Random::Package
13

DESCRIPTION

15       CPANPLUS::Dist::Fedora is a distribution class to create Fedora
16       packages from CPAN modules, and all its dependencies. This allows you
17       to have the most recent copies of CPAN modules installed, using your
18       package manager of choice, but without having to wait for central
19       repositories to be updated.
20
21       You can either install them using the API provided in this package, or
22       manually via rpm.
23
24       Note that these packages are built automatically from CPAN and are
25       assumed to have the same license as perl and come without support.
26       Please always refer to the original CPAN package if you have questions.
27

VERSION

29       version 0.2.0
30

CLASS METHODS

32   $bool = CPANPLUS::Dist::Fedora->format_available;
33       Return a boolean indicating whether or not you can use this package to
34       create and install modules in your environment.
35
36       It will verify if you are on a mandriva system, and if you have all the
37       necessary components avialable to build your own mandriva packages. You
38       will need at least these dependencies installed: "rpm", "rpmbuild" and
39       "gcc".
40

PUBLIC METHODS

42   $bool = $fedora->init;
43       Sets up the "CPANPLUS::Dist::Fedora" object for use. Effectively
44       creates all the needed status accessors.
45
46       Called automatically whenever you create a new "CPANPLUS::Dist" object.
47
48   $bool = $fedora->prepare;
49       Prepares a distribution for creation. This means it will create the rpm
50       spec file needed to build the rpm and source rpm. This will also
51       satisfy any prerequisites the module may have.
52
53       Note that the spec file will be as accurate as possible. However, some
54       fields may wrong (especially the description, and maybe the summary)
55       since it relies on pod parsing to find those information.
56
57       Returns true on success and false on failure.
58
59       You may then call "$fedora->create" on the object to create the rpm
60       from the spec file, and then "$fedora->install" on the object to
61       actually install it.
62
63   $bool = $fedora->create;
64       Builds the rpm file from the spec file created during the "create()"
65       step.
66
67       Returns true on success and false on failure.
68
69       You may then call "$fedora->install" on the object to actually install
70       it.
71
72   $bool = $fedora->install;
73       Installs the rpm using "rpm -U".
74
75       /!\ Work in progress: not implemented.
76
77       Returns true on success and false on failure
78

TODO

80       There are no TODOs of a technical nature currently, merely of an
81       administrative one;
82
83       o Scan for proper license
84           Right now we assume that the license of every module is "the same
85           as perl itself". Although correct in almost all cases, it should
86           really be probed rather than assumed.
87
88       o Long description
89           Right now we provided the description as given by the module in
90           it's meta data. However, not all modules provide this meta data and
91           rather than scanning the files in the package for it, we simply
92           default to the name of the module.
93

BUGS

95       Please report any bugs or feature requests to "< cpanplus-dist-fedora
96       at rt.cpan.org>", or through the web interface at
97       <http://rt.cpan.org/NoAuth/ReportBug.html?Queue=CPANPLUS-Dist-Fedora>.
98       I will be notified, and then you'll automatically be notified of
99       progress on your bug as I make changes.
100

AUTHOR

124       Originally based on CPANPLUS-Dist-Mdv by:
125
126       Jerome Quelin, "<jquelin at cpan.org>"
127
128       Shlomi Fish ( <http://www.shlomifish.org/> ) changed it into CPANPLUS-
129       Dist-Fedora.
130

COPYRIGHT & LICENSE

132       Copyright (c) 2007 Jerome Quelin, all rights reserved.
133
134       This program is free software; you can redistribute it and/or modify it
135       under the same terms as Perl itself.
136
137       Modified by Shlomi Fish, 2008 - all ownership disclaimed.
138
139       Modified again by Chris Weyl <cweyl@alumni.drew.edu> 2008.
140

AUTHOR

142       Shlomi Fish <shlomif@cpan.org>
143

COPYRIGHT AND LICENSE

145       This software is copyright (c) 2018 by Shlomi Fish.
146
147       This is free software; you can redistribute it and/or modify it under
148       the same terms as the Perl 5 programming language system itself.
149

BUGS

151       Please report any bugs or feature requests on the bugtracker website
152       <https://github.com/shlomif/cpanplus-dist-fedora/issues>
153
154       When submitting a bug or request, please include a test-file or a patch
155       to an existing test-file that illustrates the bug or desired feature.
156

SUPPORT

158   Perldoc
159       You can find documentation for this module with the perldoc command.
160
161         perldoc CPANPLUS::Dist::Fedora
162
163   Websites
164       The following websites have more information about this module, and may
165       be of help to you. As always, in addition to those websites please use
166       your favorite search engine to discover more resources.
167
168       ·   MetaCPAN
169
170           A modern, open-source CPAN search engine, useful to view POD in
171           HTML format.
172
173           <https://metacpan.org/release/CPANPLUS-Dist-Fedora>
174
175       ·   Search CPAN
176
177           The default CPAN search engine, useful to view POD in HTML format.
178
179           <http://search.cpan.org/dist/CPANPLUS-Dist-Fedora>
180
181       ·   RT: CPAN's Bug Tracker
182
183           The RT ( Request Tracker ) website is the default bug/issue
184           tracking system for CPAN.
185
186           <https://rt.cpan.org/Public/Dist/Display.html?Name=CPANPLUS-Dist-Fedora>
187
188       ·   AnnoCPAN
189
190           The AnnoCPAN is a website that allows community annotations of Perl
191           module documentation.
192
193           <http://annocpan.org/dist/CPANPLUS-Dist-Fedora>
194
195       ·   CPAN Ratings
196
197           The CPAN Ratings is a website that allows community ratings and
198           reviews of Perl modules.
199
200           <http://cpanratings.perl.org/d/CPANPLUS-Dist-Fedora>
201
202       ·   CPANTS
203
204           The CPANTS is a website that analyzes the Kwalitee ( code metrics )
205           of a distribution.
206
207           <http://cpants.cpanauthors.org/dist/CPANPLUS-Dist-Fedora>
208
209       ·   CPAN Testers
210
211           The CPAN Testers is a network of smoke testers who run automated
212           tests on uploaded CPAN distributions.
213
214           <http://www.cpantesters.org/distro/C/CPANPLUS-Dist-Fedora>
215
216       ·   CPAN Testers Matrix
217
218           The CPAN Testers Matrix is a website that provides a visual
219           overview of the test results for a distribution on various
220           Perls/platforms.
221
222           <http://matrix.cpantesters.org/?dist=CPANPLUS-Dist-Fedora>
223
224       ·   CPAN Testers Dependencies
225
226           The CPAN Testers Dependencies is a website that shows a chart of
227           the test results of all dependencies for a distribution.
228
229           <http://deps.cpantesters.org/?module=CPANPLUS::Dist::Fedora>
230
231   Bugs / Feature Requests
232       Please report any bugs or feature requests by email to
233       "bug-cpanplus-dist-fedora at rt.cpan.org", or through the web interface
234       at
235       <https://rt.cpan.org/Public/Bug/Report.html?Queue=CPANPLUS-Dist-Fedora>.
236       You will be automatically notified of any progress on the request by
237       the system.
238
239   Source Code
240       The code is open to the world, and available for you to hack on. Please
241       feel free to browse it and play with it, or whatever. If you want to
242       contribute patches, please send me a diff or prod me to pull from your
243       repository :)
244
245       <https://github.com/shlomif/cpanplus-dist-fedora>
246
247         git clone https://bitbucket.org/shlomif/cpanplus-dist-backends
248
249
250
251perl v5.28.0                      2018-07-14         CPANPLUS::Dist::Fedora(3)