NAME Dist::Zilla::Plugin::InsertCodeOutput - Insert the output of Perl code into your POD VERSION This document describes version 0.045 of Dist::Zilla::Plugin::InsertCodeOutput (from Perl distribution Dist-Zilla-Plugin-InsertCodeOutput), released on 2021-06-07. SYNOPSIS In dist.ini: [InsertCodeOutput] ;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 while capturing the output using Capture::Tiny's "capture_merged" (which means STDOUT and STDERR output are both captured), and insert the output to your POD as verbatim paragraph (indented with a whitespace), unless when "make_verbatim" is set to 0 then it is inserted as-is. If eval fails ($@ is true), build will be aborted. The directives must be at the first column of the line. HOMEPAGE Please visit the project's homepage at . SOURCE Source repository is at . BUGS Please report any bugs or feature requests on the bugtracker website 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::InsertCodeResult which is similar and uses the same "# CODE" directive, but instead of inserting output, will insert the result of the code (which can be a reference, in which case will be dumped using Data::Dump). Dist::Zilla::Plugin::InsertCommandOutput Dist::Zilla::Plugin::InsertExample AUTHOR perlancar CONTRIBUTORS * perlancar (@netbook-zenbook) * Steven Haryanto (on Asus Zenbook) 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.