NAME
Dist::Zilla::Plugin::InsertCodeResult - Insert the result of Perl code
into your POD
VERSION
This document describes version 0.055 of
Dist::Zilla::Plugin::InsertCodeResult (from Perl distribution
Dist-Zilla-Plugin-InsertCodeResult), released on 2021-08-06.
SYNOPSIS
In dist.ini:
[InsertCodeResult]
;make_verbatim=1
In your POD:
# CODE: require MyLib; MyLib::gen_stuff("some", "param");
or for multiline code:
# BEGIN_CODE
require MyLib;
MyLib::gen_stuff("some", "param");
...
# END_CODE
DESCRIPTION
This module finds "# CODE: ..." or "# BEGIN_CODE" and "# END CODE"
directives in your POD, evals the specified Perl code, and insert the
result into your POD as a verbatim paragraph (unless you set
"make_verbatim" to 0, in which case output will be inserted as-is). If
result is a simple scalar, it is printed as is. If it is undef or a
reference, it will be dumped using Data::Dump. If eval fails, build will
be aborted.
The directives must be at the first column of the line.
HOMEPAGE
Please visit the project's homepage at
<https://metacpan.org/release/Dist-Zilla-Plugin-InsertCodeResult>.
SOURCE
Source repository is at
<https://github.com/perlancar/perl-Dist-Zilla-Plugin-InsertCodeResult>.
BUGS
Please report any bugs or feature requests on the bugtracker website
<https://rt.cpan.org/Public/Dist/Display.html?Name=Dist-Zilla-Plugin-Ins
ertCodeResult>
When submitting a bug or request, please include a test-file or a patch
to an existing test-file that illustrates the bug or desired feature.
SEE ALSO
Dist::Zilla::Plugin::InsertCodeOutput
Dist::Zilla::Plugin::InsertExample
AUTHOR
perlancar <perlancar@cpan.org>
COPYRIGHT AND LICENSE
This software is copyright (c) 2021, 2020, 2019, 2018, 2015, 2014 by
perlancar@cpan.org.
This is free software; you can redistribute it and/or modify it under
the same terms as the Perl 5 programming language system itself.