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
hgorsvnorgitof 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 <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.