NAME¶

Dist::Inkt - yet another distribution builder

STATUS¶

Experimental.

DESCRIPTION¶

Dist::Zilla didn't have the prerequisite amount of crazy for me, so I wrote this instead.

Dist::Inkt itself does virtually nothing; it creates an empty directory, generates a MANIFEST file, and then wraps it all up into a gzipped tarball. But it provides various hooks along the way for subclasses to grab hold of. So the general idea is that you write a subclass of Dist::Inkt, which consumes various Moose::Roles to do the actual work of populating the distribution with files.

As such, Dist::Inkt is not so much a distribution builder, as it is a framework for writing your own distribution builder.

Several roles of varying utility are bundled with Dist::Inkt, as is Dist::Inkt::Profile::Simple, a subclass of Dist::Inkt which consumes most of these roles.

COMPANIONS¶

Dist::Inkt does just one thing - building the tarball from some checkout of the repo.

Although roles could theoretically be written for other tasks, out of the box, Dist::Inkt doesn't do any of the following:

Minting new distributions

I'm writing a separate tool, Dist::Inktly::Minty for that.

Test suite running

Use App::Prove or App::ForkProve.

CPAN Uploading

Use CPAN::Uploader.

Changing the version number across many files

Use Perl::Version.

Integration with version control tools

Just use "hg" or "svn" or "git" of whatever as you normally would. None of the files generated by Dist::Inkt should probably be checked into your repo.

BUGS¶

Please report any bugs to <http://rt.cpan.org/Dist/Display.html?Queue=Dist-Inkt>.

SEE ALSO¶

If you are not me, then you may well want one of these instead:

• Dist::Zilla
• Dist::Milla
• Minilla

Various extensions for Dist::Inkt:

• Dist::Inkt::DOAP
• Dist::Inkt::Profile::TOBYINK

AUTHOR¶

Toby Inkster <tobyink@cpan.org>.

COPYRIGHT AND LICENCE¶

This software is copyright (c) 2013-2014 by Toby Inkster.

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

DISCLAIMER OF WARRANTIES¶

THIS PACKAGE IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE.