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.2
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

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       ·   CPAN Ratings
165
166           The CPAN Ratings is a website that allows community ratings and
167           reviews of Perl modules.
168
169           <http://cpanratings.perl.org/d/CPANPLUS-Dist-Fedora>
170
171       ·   CPANTS
172
173           The CPANTS is a website that analyzes the Kwalitee ( code metrics )
174           of a distribution.
175
176           <http://cpants.cpanauthors.org/dist/CPANPLUS-Dist-Fedora>
177
178       ·   CPAN Testers
179
180           The CPAN Testers is a network of smoke testers who run automated
181           tests on uploaded CPAN distributions.
182
183           <http://www.cpantesters.org/distro/C/CPANPLUS-Dist-Fedora>
184
185       ·   CPAN Testers Matrix
186
187           The CPAN Testers Matrix is a website that provides a visual
188           overview of the test results for a distribution on various
189           Perls/platforms.
190
191           <http://matrix.cpantesters.org/?dist=CPANPLUS-Dist-Fedora>
192
193       ·   CPAN Testers Dependencies
194
195           The CPAN Testers Dependencies is a website that shows a chart of
196           the test results of all dependencies for a distribution.
197
198           <http://deps.cpantesters.org/?module=CPANPLUS::Dist::Fedora>
199
200   Bugs / Feature Requests
201       Please report any bugs or feature requests by email to
202       "bug-cpanplus-dist-fedora at rt.cpan.org", or through the web interface
203       at
204       <https://rt.cpan.org/Public/Bug/Report.html?Queue=CPANPLUS-Dist-Fedora>.
205       You will be automatically notified of any progress on the request by
206       the system.
207
208   Source Code
209       The code is open to the world, and available for you to hack on. Please
210       feel free to browse it and play with it, or whatever. If you want to
211       contribute patches, please send me a diff or prod me to pull from your
212       repository :)
213
214       <https://github.com/shlomif/cpanplus-dist-backends>
215
216         git clone git://github.com/shlomif/cpanplus-dist-backends.git
217

AUTHOR

219       Shlomi Fish <shlomif@cpan.org>
220

BUGS

222       Please report any bugs or feature requests on the bugtracker website
223       <https://github.com/shlomif/cpanplus-dist-backends/issues>
224
225       When submitting a bug or request, please include a test-file or a patch
226       to an existing test-file that illustrates the bug or desired feature.
227

COPYRIGHT AND LICENSE

229       This software is copyright (c) 2020 by Shlomi Fish.
230
231       This is free software; you can redistribute it and/or modify it under
232       the same terms as the Perl 5 programming language system itself.
233
234
235
236perl v5.30.1                      2020-01-29         CPANPLUS::Dist::Fedora(3)