|Dist::Inkt(3pm)||User Contributed Perl Documentation||Dist::Inkt(3pm)|
Dist::Inkt - yet another distribution builder
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.
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.
Please report any bugs to <http://rt.cpan.org/Dist/Display.html?Queue=Dist-Inkt>.
If you are not me, then you may well want one of these instead:
Various extensions for Dist::Inkt:
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.