SYNOPSIS
In your weaver.ini:
[-Eval]
include_modules = ^Foo::Bar$
;include_files = REGEX
code = sub { my ($self, %args)=@_; use Module::Load; load $args{module}; my $document = $args{document}; push @{$document->children}, ... }
DESCRIPTION
DEPRECATION NOTICE: This module is deprecated in favor of
Pod::Weaver::Plugin::Run.
This plugin evaluates Perl code specified in your weaver.ini (or
dist.ini). It can be used to do various stuffs that might be too
trivial/short to build a dedicated Pod::Weaver::Plugin for.
I first created this module to insert list of border styles and color
themes contained in %border_styles package variable in
Text::ANSITable::BorderStyle::* modules and %color_themes variable in
Text::ANSITable::ColorTheme::* modules.
Yes, it's a dirty (and ugly) hack. But it's quick :-)
CONFIGURATION
include_files => STR
Value should be a regex, e.g. /Foo/Bar/.
include_modules => REGEX
Value should be a regex, e.g. ^Foo::Bar$.
code => STR
Should be something like:
sub { my ($self, %args) = @_; ... }
sub { and } will be added if code does not have it. Code will be called
with %args containing these keys:
* filename => STR
* package => STR
* module => STR
Alias for package.
* args => ARRAY
The original @_ passed to weave_section(). Note that weave_section()
is passed:
($self, $document, $input)
* document => OBJ
Document object passed to weave_section(). This is the output POD we
are building and this is what we're mostly interested in, usually. It
can also be retrieved from args.
* input => OBJ
The input object passed to weave_section(). It contains information
about the input (original) document. Can also be retrieved from args.
SEE ALSO
Pod::Weaver
Pod::Weaver::Plugin::Run