|Dist::Inkt(3pm)||User Contributed Perl Documentation||Dist::Inkt(3pm)|
NAME¶Dist::Inkt - yet another distribution builder
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:
Various extensions for Dist::Inkt:
AUTHOR¶Toby Inkster <email@example.com>.
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.