/ 
CPANPLUS-Dist-Fedora-0.2.3
River stage zero No dependents
/ CPANPLUS::Dist::Fedora

NAME

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

VERSION

version 0.2.3

SYNOPSIS

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

DESCRIPTION

CPANPLUS::Dist::Fedora is a distribution class to create Fedora packages from CPAN modules, and all its dependencies. This allows you to have the most recent copies of CPAN modules installed, using your package manager of choice, but without having to wait for central repositories to be updated.

You can either install them using the API provided in this package, or manually via rpm.

Note that these packages are built automatically from CPAN and are assumed to have the same license as perl and come without support. Please always refer to the original CPAN package if you have questions.

CLASS METHODS

$bool = CPANPLUS::Dist::Fedora->format_available;

Return a boolean indicating whether or not you can use this package to create and install modules in your environment.

It will verify if you are on a mandriva system, and if you have all the necessary components avialable to build your own mandriva packages. You will need at least these dependencies installed: rpm, rpmbuild and gcc.

PUBLIC METHODS

$bool = $fedora->init;

Sets up the CPANPLUS::Dist::Fedora object for use. Effectively creates all the needed status accessors.

Called automatically whenever you create a new CPANPLUS::Dist object.

$bool = $fedora->prepare;

Prepares a distribution for creation. This means it will create the rpm spec file needed to build the rpm and source rpm. This will also satisfy any prerequisites the module may have.

Note that the spec file will be as accurate as possible. However, some fields may wrong (especially the description, and maybe the summary) since it relies on pod parsing to find those information.

Returns true on success and false on failure.

You may then call $fedora->create on the object to create the rpm from the spec file, and then $fedora->install on the object to actually install it.

$bool = $fedora->create;

Builds the rpm file from the spec file created during the create() step.

Returns true on success and false on failure.

You may then call $fedora->install on the object to actually install it.

$bool = $fedora->install;

Installs the rpm using rpm -U.

/!\ Work in progress: not implemented.

Returns true on success and false on failure

TODO

There are no TODOs of a technical nature currently, merely of an administrative one;

o Scan for proper license

Right now we assume that the license of every module is the same as perl itself. Although correct in almost all cases, it should really be probed rather than assumed.

o Long description

Right now we provided the description as given by the module in its meta data. However, not all modules provide this meta data and rather than scanning the files in the package for it, we simply default to the name of the module.

SEE ALSO

CPANPLUS::Backend, CPANPLUS::Module, CPANPLUS::Dist, cpan2dist, rpm, yum, CPANPLUS::Dist::Mageia.

AUTHOR

Originally based on CPANPLUS-Dist-Mdv by:

Jerome Quelin, <jquelin at cpan.org>

Shlomi Fish ( http://www.shlomifish.org/ ) changed it into CPANPLUS-Dist-Fedora.

COPYRIGHT & LICENSE

Copyright (c) 2007 Jerome Quelin, all rights reserved.

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

Modified by Shlomi Fish, 2008 - all ownership disclaimed.

Modified again by Chris Weyl <cweyl@alumni.drew.edu> 2008.

SUPPORT

Websites

The following websites have more information about this module, and may be of help to you. As always, in addition to those websites please use your favorite search engine to discover more resources.

Bugs / Feature Requests

Please report any bugs or feature requests by email to bug-cpanplus-dist-fedora at rt.cpan.org, or through the web interface at https://rt.cpan.org/Public/Bug/Report.html?Queue=CPANPLUS-Dist-Fedora. You will be automatically notified of any progress on the request by the system.

Source Code

The code is open to the world, and available for you to hack on. Please feel free to browse it and play with it, or whatever. If you want to contribute patches, please send me a diff or prod me to pull from your repository :)

https://github.com/shlomif/cpanplus-dist-backends

git clone git://github.com/shlomif/cpanplus-dist-backends.git

AUTHOR

Shlomi Fish <shlomif@cpan.org>

BUGS

Please report any bugs or feature requests on the bugtracker website https://github.com/shlomif/cpanplus-dist-backends/issues

When submitting a bug or request, please include a test-file or a patch to an existing test-file that illustrates the bug or desired feature.

COPYRIGHT AND LICENSE

This software is copyright (c) 2007 by Jerome Quelin.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.