Scroll to navigation

Dist::Inkt(3pm) User Contributed Perl Documentation Dist::Inkt(3pm)

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.
2019-03-02 perl v5.28.1