CPANPLUS::Dist::Fedora(3pm)

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

VERSION

6       version 0.2.1
7

SYNOPSIS

9           cpan2dist --format=CPANPLUS::Dist::Fedora Some::Random::Package
10

DESCRIPTION

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

NAME

26       CPANPLUS::Dist::Fedora - a cpanplus backend to build Fedora/RedHat rpms
27

CLASS METHODS

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

PUBLIC METHODS

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

TODO

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

BUGS

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

AUTHOR

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

COPYRIGHT & LICENSE

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

SUPPORT

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

AUTHOR

226       Shlomi Fish <shlomif@cpan.org>
227

BUGS

229       Please report any bugs or feature requests on the bugtracker website
230       <https://github.com/shlomif/cpanplus-dist-backends/issues>
231
232       When submitting a bug or request, please include a test-file or a patch
233       to an existing test-file that illustrates the bug or desired feature.
234

COPYRIGHT AND LICENSE

236       This software is copyright (c) 2019 by Shlomi Fish.
237
238       This is free software; you can redistribute it and/or modify it under
239       the same terms as the Perl 5 programming language system itself.
240
241
242
243perl v5.30.0                      2019-08-26         CPANPLUS::Dist::Fedora(3)