NAME
dzooky - convert a dist to Dist::Zilla
VERSION
version 0.06
SYNOPSIS
$ cd Some-Dist-Dir
$ dzooky
DESCRIPTION
dzooky is Dist::Zilla's nephew. He has the ability to summon his uncle.
dzooky will try its best to convert a distribution to use Dist::Zilla. It supports ExtUtils::MakeMaker, Module::Install and Module::Build based distributions, with certain limitations.
Simply execute dzooky
in the directory containing the distribution you wish to convert to Dist::Zilla. dzooky
will determine the type of distribution it is and execute the Makefile.PL
or Build.PL
and gather meta information to generate a dist.ini
file for you.
It will die
on any error conditions it encounters.
CAVEAT PROGRAMMER
This should be considered as experimental for the moment. It does work in the main but there are some gotchas
.
The ExtUtils::MakeMaker examination is done by parsing the Makefile
that is produced by executing Makefile.PL
. Module::Install will also fall back to this mechanism if a MYMETA.yml
file is not generated.
The Module::Build examination is purely from MYMETA.yml
.
This has some limitations.
TODO
As we pull a lot of data from MYMETA.yml
( where applicable ), we could fill in a lot more of the dist.ini
automatically.
The Module::Install code does not take into account dists using Module::AutoInstall, maybe it should. Any ideas for achieving this would be welcome.
AUTHOR
Chris Williams <chris@bingosnet.co.uk>
COPYRIGHT AND LICENSE
This software is copyright (c) 2010 by Chris Williams.
This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.