Importing CPAN modules into Baserock
This guide shows how to use the import tool to import a module hosted on CPAN into Baserock. This guide does not cover how to integrate the definitions generated by the import tool into an existing set of definitions, for more information concerning that see How to use the Baserock Import tool to import Ruby on Rails and Importing pypi packages into Baserock.
This guide assumes you have the import tool installed on your system, if not see the quickstart guide.
The CPAN importer uses carton to obtain a perl distribution's dependency set, it also injects modules into a local minicpan repository to make it possible to run imports based on locally modified sources as well as sources pulled straight from CPAN.
To import a module,
baserock-import cpan IO::Async
optionally you can supply a version,
baserock-import cpan IO::Async 0.68
if anything goes wrong the log will be useful, run with
to log to a file. Since carton fetches sources with cpanm you may also
find the cpanm log useful, by default this is located at
cpanm also stores any tarballs it fetches into this directory, if you're
importing very large distributions (with hundreds of dependencies)
then you may want to set the
PERL_CPANM_HOME environment variable when you
run the import, e.g.
PERL_CPANM_HOME=/src/cpanm_data baserock-import cpan IO::Async
to ensure cpanm doesn't run out of disk space during the import.
Generally any perl distribution that can be installed with cpanm can be imported with the import tool, if you have any difficulties or find any distributions that can't be imported please send a mail to firstname.lastname@example.org or ask in #baserock on irc.freenode.net
For an explanation of how to make use of the cpan importer's local module injection, see Importing Mail::SpamAssassin into Baserock.