NAME

Dist::Zilla::Plugin::Test::Inline - Create test files from inline tests in POD sections

VERSION

version 0.011002

SYNOPSIS

In your dist.ini:

[Test::Inline]

In your module:

# My/AddressRange.pm

=begin testing

use Test::Exception;
dies_ok {
	My::AddressRange->list_from_range('10.2.3.A', '10.2.3.5')
} "list_from_range() complains about invalid address";

=end testing

=cut

sub list_from_range {
	# ...
}

This will result in a file t/inline-tests/my_addressrange.t in your distribution.

DESCRIPTION

This plugin integrates Test::Inline into Dist::Zilla.

It scans all modules for inline tests in POD sections that are embedded between the keywords

=begin testing
...
=end testing

and exports them into t/inline-tests/*.t files when Dist::Zilla builds your module. Multiple of these test sections may be specified within one file.

Please note that this plugin (in contrast to pure Test::Inline) can also handle Moops-like class and role definitions.

METHODS

gather_files

Required by role Dist::Zilla::Role::FileGatherer.

Searches for inline test code in POD sections using Test::Inline, creates in-memory test files and passes them to Dist::Zilla.

ACKNOWLEDGEMENTS

The code of this Dist::Zilla file gatherer plugin is mainly taken from https://github.com/moose/moose/blob/master/inc/ExtractInlineTests.pm.

• Dave Rolsky <autarch@urth.org>, who basically wrote all this but left the honor of making a plugin of it to me ;-)

AUTHOR

Jens Berthold <jens.berthold@jebecs.de>

COPYRIGHT AND LICENSE

This software is copyright (c) 2015 by Jens Berthold.

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