NAME

Dist::Zilla::Plugin::Hook - Write Dist::Zilla plugin directly in dist.ini

VERSION

Version v0.8.3.1, released on 2018-02-28 23:57 UTC. This is a trial release.

WHAT?

Dist-Zilla-Plugin-Hook (or just Hook) is a set of Dist-Zilla plugins. Every plugin executes Perl code inlined into dist.ini at particular stage of build process.

This is Dist::Zilla::Plugin::Hook module documentation. Read this if you are going to hack or extend Dist-Zilla-Plugin-Hook.

If you want to write Dist::Zilla plugin directly in dist.ini, read the manual. General topics like getting source, building, installing, bug reporting and some others are covered in the README.

DESCRIPTION

This plugin consumes Hooker role like all other Hook plugins. However, this plugin never executes its Perl code. Instead, it just stores it for later use. As of today, only Hook plugin with prologue name is actually used:

[Hook/prologue]
    . = use autodie ':all';

Such code will be executed just before each hook. Note again: Hook itself does not execute its code; if there are no other hooks in dist.ini, this code will never execute.

BTW, Dist::Zilla and CPAN do not handle well distributions with no main module. This is also a "main" module of Dist-Zilla-Plugin-Hook distribution, to make Dist::Zilla and CPAN indexer happy.

SEE ALSO

Dist::Zilla
Dist::Zilla::Plugin::Hook::Manual
Dist::Zilla::Role::Hooker

AUTHOR

Van de Bugger <van.de.bugger@gmail.com>

COPYRIGHT AND LICENSE

Copyright (C) 2015, 2016, 2018 Van de Bugger

License GPLv3+: The GNU General Public License version 3 or later <http://www.gnu.org/licenses/gpl-3.0.txt>.

This is free software: you are free to change and redistribute it. There is NO WARRANTY, to the extent permitted by law.