Geek Answers Handbook

Where can I find a quick guide to converting an existing CPAN module to use Dist :: Zilla?

At various times, I read both the documentation and a number of blog posts on Dist :: Zilla . I have never felt confident in my understanding of this.

In response to another question, @Ether raised the possibility of Crypt-SSLeay conversion to use Dist::Zilla .

So where can I find a quick guide showing how to convert an existing CPAN module to use Dist::Zilla ? Does the question even make sense?

Update:

Makefile.PL for Crypt-SSLeay does a lot of work (many of them seem unnecessary, and I'm trying to trim them) to find the specific include and lib directories for a particular platform in order to print the version of OpenSSL on the machine on which it is installed. How to enable this functionality if I use Dist::Zilla ?

+7
perl cpan dist-zilla
source share
2 answers

These are the sites that I have found most useful so far, since I am in the middle of converting the CPAN distribution, which I use to use as a training exercise. I'm not there yet, but so far I haven’t hit any dodgy bits!

In addition, the #toolchain and #distzilla channels on irc.perl.org are full of helpful people, including authors for Dist :: Zilla and other related tools.

+8
source share

Dist :: Zilla Select your own tutorial has the Convert Dist to Zill :: Distill page. In one case, my VersionFromModule plugin is not mentioned, which is useful if you want to reproduce how many people use MakeMaker, with a distribution taking the version number from the main module. (Many use dzil in a different way, with a version in dist.ini and a plugin to insert it into the module, but it works anyway.)

If I need a more sophisticated Makefile.PL than the one that dzil generates, I switch to Module :: Build and use the ModuleBuild :: Custom plugin that allows me to write my own Build.PL and have Dzil metadata, such as preconditions.

The MakeMaker :: Awesome plugin allows you to do something similar with Makefile.PL, but that was not quite what I wanted. Instead, I wrote a MakeMaker :: Custom plugin that works just like my ModuleBuild :: Custom . The big advantage of MakeMaker :: Custom over MakeMaker :: Awesome is that it allows you to build your dist for testing purposes without having to do dzil build . For the XS module, which needs to be rebuilt after every minor change, this is a big win.

+10
source share

More articles:


All Articles