NAME

       Test::Inline::Extract - Extract relevant Pod sections from source code.

DESCRIPTION

       The Test::Inline::Extract package extracts content interesting to Test::Inline from source
       files.

METHODS

   new $file | \$source
       The "new" constructor creates a new Extract object. It is passed either a file name from
       which the source code would be loaded, or a reference to a string that directly contains
       source code.

       Returns a new "Test::Inline::Extract" object or "undef" on error.

   elements
         my $elements = $Extract->elements;

       The "elements" method extracts from the Pod any parts of the file that are relevant to the
       extraction and generation process of "Test::Inline".

       The elements will be either a package statements, or a section of inline unit tests. They
       will only be returned if there is at least one section of inline unit tests.

       Returns a reference to an array of package strings and sections of inline unit tests.
       Returns false if there are no sections containing inline unit tests.

TO DO

       - For certain very complex cases, add a more intensive alternative parser based on PPI

SUPPORT

       See the main SUPPORT section.

AUTHOR

       Adam Kennedy <adamk@cpan.org>, <http://ali.as/>

COPYRIGHT

       Copyright 2004 - 2013 Adam Kennedy.

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

       The full text of the license can be found in the LICENSE file included with this module.