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.4.4
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 its
87           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

AUTHOR

96       Originally based on CPANPLUS-Dist-Mdv by:
97
98       Jerome Quelin, "<jquelin at cpan.org>"
99
100       Shlomi Fish ( <http://www.shlomifish.org/> ) changed it into CPANPLUS-
101       Dist-Fedora.
102

COPYRIGHT & LICENSE

104       Copyright (c) 2007 Jerome Quelin, all rights reserved.
105
106       This program is free software; you can redistribute it and/or modify it
107       under the same terms as Perl itself.
108
109       Modified by Shlomi Fish, 2008 - all ownership disclaimed.
110
111       Modified again by Chris Weyl <cweyl@alumni.drew.edu> 2008.
112

SUPPORT

114   Websites
115       The following websites have more information about this module, and may
116       be of help to you. As always, in addition to those websites please use
117       your favorite search engine to discover more resources.
118
119       •   MetaCPAN
120
121           A modern, open-source CPAN search engine, useful to view POD in
122           HTML format.
123
124           <https://metacpan.org/release/CPANPLUS-Dist-Fedora>
125
126       •   RT: CPAN's Bug Tracker
127
128           The RT ( Request Tracker ) website is the default bug/issue
129           tracking system for CPAN.
130
131           <https://rt.cpan.org/Public/Dist/Display.html?Name=CPANPLUS-Dist-Fedora>
132
133       •   CPANTS
134
135           The CPANTS is a website that analyzes the Kwalitee ( code metrics )
136           of a distribution.
137
138           <http://cpants.cpanauthors.org/dist/CPANPLUS-Dist-Fedora>
139
140       •   CPAN Testers
141
142           The CPAN Testers is a network of smoke testers who run automated
143           tests on uploaded CPAN distributions.
144
145           <http://www.cpantesters.org/distro/C/CPANPLUS-Dist-Fedora>
146
147       •   CPAN Testers Matrix
148
149           The CPAN Testers Matrix is a website that provides a visual
150           overview of the test results for a distribution on various
151           Perls/platforms.
152
153           <http://matrix.cpantesters.org/?dist=CPANPLUS-Dist-Fedora>
154
155       •   CPAN Testers Dependencies
156
157           The CPAN Testers Dependencies is a website that shows a chart of
158           the test results of all dependencies for a distribution.
159
160           <http://deps.cpantesters.org/?module=CPANPLUS::Dist::Fedora>
161
162   Bugs / Feature Requests
163       Please report any bugs or feature requests by email to
164       "bug-cpanplus-dist-fedora at rt.cpan.org", or through the web interface
165       at
166       <https://rt.cpan.org/Public/Bug/Report.html?Queue=CPANPLUS-Dist-Fedora>.
167       You will be automatically notified of any progress on the request by
168       the system.
169
170   Source Code
171       The code is open to the world, and available for you to hack on. Please
172       feel free to browse it and play with it, or whatever. If you want to
173       contribute patches, please send me a diff or prod me to pull from your
174       repository :)
175
176       <https://github.com/shlomif/cpanplus-dist-backends>
177
178         git clone git://github.com/shlomif/cpanplus-dist-backends.git
179

AUTHOR

181       Shlomi Fish <shlomif@cpan.org>
182

BUGS

184       Please report any bugs or feature requests on the bugtracker website
185       <https://github.com/shlomif/cpanplus-dist-backends/issues>
186
187       When submitting a bug or request, please include a test-file or a patch
188       to an existing test-file that illustrates the bug or desired feature.
189

COPYRIGHT AND LICENSE

191       This software is copyright (c) 2007 by Jerome Quelin.
192
193       This is free software; you can redistribute it and/or modify it under
194       the same terms as the Perl 5 programming language system itself.
195
196
197
198perl v5.36.0                      2023-01-20         CPANPLUS::Dist::Fedora(3)