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