The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.
<html><head><title>Dist::Zilla::Plugin::Test::Inline</title>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" >

<style type="text/css">
 <!--/*--><![CDATA[/*><!--*/
BODY {
  background: white;
  color: black;
  font-family: arial,sans-serif;
  margin: 0;
  padding: 1ex;
}

A:link, A:visited {
  background: transparent;
  color: #006699;
}

A[href="#POD_ERRORS"] {
  background: transparent;
  color: #FF0000;
}

DIV {
  border-width: 0;
}

DT {
  margin-top: 1em;
  margin-left: 1em;
}

.pod { margin-right: 20ex; }

.pod PRE     {
  background: #eeeeee;
  border: 1px solid #888888;
  color: black;
  padding: 1em;
  white-space: pre;
}

.pod H1      {
  background: transparent;
  color: #006699;
  font-size: large;
}

.pod H1 A { text-decoration: none; }
.pod H2 A { text-decoration: none; }
.pod H3 A { text-decoration: none; }
.pod H4 A { text-decoration: none; }

.pod H2      {
  background: transparent;
  color: #006699;
  font-size: medium;
}

.pod H3      {
  background: transparent;
  color: #006699;
  font-size: medium;
  font-style: italic;
}

.pod H4      {
  background: transparent;
  color: #006699;
  font-size: medium;
  font-weight: normal;
}

.pod IMG     {
  vertical-align: top;
}

.pod .toc A  {
  text-decoration: none;
}

.pod .toc LI {
  line-height: 1.2em;
  list-style-type: none;
}

  /*]]>*/-->
</style>


</head>
<body class='pod'>
<!--
  generated by Pod::Simple::HTML v3.16,
  using Pod::Simple::PullParser v3.16,
  under Perl v5.014003 at Tue Nov 26 14:20:30 2013 GMT.

 If you want to change this HTML document, you probably shouldn't do that
   by changing it directly.  Instead, see about changing the calling options
   to Pod::Simple::HTML, and/or subclassing Pod::Simple::HTML,
   then reconverting this document from the Pod source.
   When in doubt, email the author of Pod::Simple::HTML for advice.
   See 'perldoc Pod::Simple::HTML' for more info.

-->

<!-- start doc -->
<a name='___top' class='dummyTopAnchor' ></a>

<div class='indexgroup'>
<ul   class='indexList indexList1'>
  <li class='indexItem indexItem1'><a href='#NAME'>NAME</a>
  <li class='indexItem indexItem1'><a href='#VERSION'>VERSION</a>
  <li class='indexItem indexItem1'><a href='#SYNOPSIS'>SYNOPSIS</a>
  <li class='indexItem indexItem1'><a href='#DESCRIPTION'>DESCRIPTION</a>
  <li class='indexItem indexItem1'><a href='#EXTENDS'>EXTENDS</a>
  <li class='indexItem indexItem1'><a href='#METHODS'>METHODS</a>
  <ul   class='indexList indexList2'>
    <li class='indexItem indexItem2'><a href='#gather_files'>gather_files</a>
  </ul>
  <li class='indexItem indexItem1'><a href='#ACKNOWLEDGEMENTS'>ACKNOWLEDGEMENTS</a>
  <li class='indexItem indexItem1'><a href='#AUTHOR'>AUTHOR</a>
  <li class='indexItem indexItem1'><a href='#COPYRIGHT_AND_LICENSE'>COPYRIGHT AND LICENSE</a>
</ul>
</div>

<h1><a class='u' href='#___top' title='click to go to top of document'
name="NAME"
>NAME</a></h1>

<p>Dist::Zilla::Plugin::Test::Inline - Create test files for inline tests in POD sections</p>

<h1><a class='u' href='#___top' title='click to go to top of document'
name="VERSION"
>VERSION</a></h1>

<p>version 0.011000</p>

<h1><a class='u' href='#___top' title='click to go to top of document'
name="SYNOPSIS"
>SYNOPSIS</a></h1>

<p>In your <code>dist.ini</code>:</p>

<pre>        [Test::Inline]</pre>

<p>In your module:</p>

<pre>        # My/AddressRange.pm

        =begin testing

        use Test::Exception;
        dies_ok {
                My::AddressRange-&#62;list_from_range(&#39;10.2.3.A&#39;, &#39;10.2.3.5&#39;)
        } &#34;list_from_range() complains about invalid address&#34;;

        =end testing

        sub list_from_range {
                # ...
        }</pre>

<p>This will result in a file <code>t/inline-tests/my_addressrange.t</code> in your distribution.</p>

<h1><a class='u' href='#___top' title='click to go to top of document'
name="DESCRIPTION"
>DESCRIPTION</a></h1>

<p>This plugin integrates <a href="http://search.cpan.org/perldoc?Test%3A%3AInline" class="podlinkpod"
>Test::Inline</a> into <code>Dist::Zilla</code>.</p>

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

<pre>        =begin testing
        ...
        =end testing</pre>

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

<p>Please note that this plugin (in contrast to pure <a href="http://search.cpan.org/perldoc?Test%3A%3AInline" class="podlinkpod"
>Test::Inline</a>) can also handle <a href="http://search.cpan.org/perldoc?Moops" class="podlinkpod"
>Moops</a>-like class and role definitions.</p>

<h1><a class='u' href='#___top' title='click to go to top of document'
name="EXTENDS"
>EXTENDS</a></h1>

<ul>
<li><a href="http://search.cpan.org/perldoc?Moose%3A%3AObject" class="podlinkpod"
>Moose::Object</a></li>
</ul>

<h1><a class='u' href='#___top' title='click to go to top of document'
name="METHODS"
>METHODS</a></h1>

<h2><a class='u' href='#___top' title='click to go to top of document'
name="gather_files"
>gather_files</a></h2>

<p>Required by role <a href="http://search.cpan.org/perldoc?Dist%3A%3AZilla%3A%3ARole%3A%3AFileGatherer" class="podlinkpod"
>Dist::Zilla::Role::FileGatherer</a>.</p>

<p>Searches for inline test code in POD sections using <a href="http://search.cpan.org/perldoc?Test%3A%3AInline" class="podlinkpod"
>Test::Inline</a>, creates in-memory test files and passes them to <a href="http://search.cpan.org/perldoc?Dist%3A%3AZilla" class="podlinkpod"
>Dist::Zilla</a>.</p>

<h1><a class='u' href='#___top' title='click to go to top of document'
name="ACKNOWLEDGEMENTS"
>ACKNOWLEDGEMENTS</a></h1>

<p>The code of this Dist::Zilla file gatherer plugin is mainly taken from <a href="https://github.com/moose/moose/blob/master/inc/ExtractInlineTests.pm" class="podlinkurl"
>https://github.com/moose/moose/blob/master/inc/ExtractInlineTests.pm</a>.</p>

<ul>
<li>Dave Rolsky &#60;autarch@urth.org&#62;, who basically wrote all this but left the honor of making a plugin of it to me ;-)</li>
</ul>

<h1><a class='u' href='#___top' title='click to go to top of document'
name="AUTHOR"
>AUTHOR</a></h1>

<p>Jens Berthold &#60;jens.berthold@jebecs.de&#62;</p>

<h1><a class='u' href='#___top' title='click to go to top of document'
name="COPYRIGHT_AND_LICENSE"
>COPYRIGHT AND LICENSE</a></h1>

<p>This software is copyright (c) 2013 by Jens Berthold.</p>

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

<!-- end doc -->

</body></html>