NAME

Dist::Zilla::Plugin::Regenerate - Write contents to your source tree explicitly

VERSION

version 0.001001

SYNOPSIS

in dist.ini

[Regenerate]
; For example
filenames = Makefile.PL
filenames = META.json
filenames = README.mkdn

on your command line

dzil regenerate
# Makefile.PL updated
# META.json updated
# ...

DESCRIPTION

This plugin, in conjunction with the dzil regenerate command, allows turn-key copying of content from your build tree to your source tree.

This is a compatriot of [CopyFilesFromBuild] and [CopyFilesFromRelease], albeit targeted to happen outside your standard work phase, allowing you to copy generated files back into the source tree on demand, and also freeing you from them being updated when you don't require it.

ATTRIBUTES

filenames

An Array of Strings describing files to copy.

[Regenerate]
filename = Makefile.PL
filename = META.json

aliases: filename

SEE ALSO

  • [CopyFilesFromBuild]

    This plugin operates only on the AfterBuild phase, and thus will modify files on every dzil build, creating undesired work-flow churn.

  • [CopyFilesFromRelease]

    This plugin operates only on the AfterRelease phase, impeding work-flow slightly for people who WANT to update their source tree without actually doing a release.

    This plugin can be used instead of [Regenerate] though, by using it in conjunction with [Regenerate::AfterReleasers]

AUTHOR

Kent Fredric <kentnl@cpan.org>

COPYRIGHT AND LICENSE

This software is copyright (c) 2017 by Kent Fredric <kentfredric@gmail.com>.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.