test::inline::extract(3pm) [debian man page]

Test::Inline::Extract(3pm)				User Contributed Perl Documentation				Test::Inline::Extract(3pm)

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 - 2010 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.

perl v5.12.4							    2010-11-22						Test::Inline::Extract(3pm)

Test::Inline::Content::Simple(3pm)			User Contributed Perl Documentation			Test::Inline::Content::Simple(3pm)

NAME

       Test::Inline::Content::Simple - Simple templating Content Handler

SYNOPSIS

	 In your inline2test.tpl
	 ----------------------
	 #!/usr/bin/perl -w

	 use strict;
	 use Test::More [% plan %];
	 $| = 1;

	 [% tests %]

	 1;

DESCRIPTION

       It is relatively common to want to customise the contents of the generated test files to set up custom environment things on an all-scripts
       basis, rather than file by file (using =begin SETUP blocks).

       "Test::Inline::Content::Simple" lets you use a very simple Template Toolkit style template to define this information.

       It contains only two tags, "plan" and "tests".

       The "plan" tag will be inserted as either "tests =" 123> or 'no_plan'.

       The "tests" tag will be replaced by the actual testing code.

METHODS

   new $filename
       Manually create a new "Test::Inline::Content::Simple" object. Takes as parameter a single filename which should contain the template code.

       Returns a new "Test::Inline::Content::Simple" object, or "undef" on error.

   template
       The "template" accessor returns the template content for the object

   process $Inline, $Script
       The "process" method is unchanged from "Test::Inline::Content".

SUPPORT

       See the main SUPPORT section.

AUTHOR

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

COPYRIGHT

       Copyright 2004 - 2010 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.

perl v5.12.4							    2010-11-22					Test::Inline::Content::Simple(3pm)