File Coverage

blib/lib/Test/Inline/Content/Legacy.pm

Criterion	Covered	Total	%
statement	18	18	100.0
branch	5	8	62.5
condition			n/a
subroutine	6	6	100.0
pod	3	3	100.0
total	32	35	91.4

package Test::Inline::Content::Legacy;
# ABSTRACT: Test::Inline 2 Content Handler for legacy functions

#pod =pod
#pod
#pod =head1 SYNOPSIS
#pod
#pod Custom script content generation using Test::Inline 2.000+ with a
#pod custom generator functions
#pod
#pod   my $header = "....";
#pod   my $function = sub {
#pod   	my $Object = shift;
#pod 	my $Script = shift;
#pod 	return $header . $Script->merged_content;
#pod   };
#pod
#pod   my $Inline = Test::Inline->new(
#pod   	...
#pod   	file_content => $function,
#pod   	);
#pod
#pod Migrating this same code to Test::Inline 2.100+ ContentHandler objects
#pod
#pod   my $header = "....";
#pod   my $function = sub {
#pod   	my $Object = shift;
#pod 	my $Script = shift;
#pod 	return $header . $Script->merged_content;
#pod   };
#pod
#pod   my $ContentHandler = Test::Inline::Content::Legacy->new( $function );
#pod
#pod   my $Inline = Test::Inline->new(
#pod   	...
#pod   	ContentHandler => $ContentHandler,
#pod   	);
#pod
#pod =head1 DESCRIPTION
#pod
#pod This class exists to provide a migration path for anyone using the custom
#pod script generators in Test::Inline via the C param.
#pod
#pod The synopsis above pretty much says all you need to know.
#pod
#pod =head1 METHODS
#pod
#pod =cut

use strict;
use Params::Util          qw{_CODE _INSTANCE};
use Test::Inline::Content ();

our $VERSION = '2.214';
our @ISA     = 'Test::Inline::Content';

#pod =pod
#pod
#pod =head2 new $CODE_ref
#pod
#pod The C constructor for C takes a single
#pod parameter of a C reference, as you would have previously provided
#pod directly to C.
#pod
#pod Returns a new C object, or C if not
#pod passed a C reference.
#pod
#pod =cut

sub new {
	my $class = ref $_[0] ? ref shift : shift;
	my $self  = $class->SUPER::new(@_);
	$self->{coderef} = _CODE(shift) or return undef;
	$self;
}

#pod =pod
#pod
#pod =head2 coderef
#pod
#pod The C accessor returns the C reference for the object
#pod
#pod =cut

sub coderef { $_[0]->{coderef} }

#pod =pod
#pod
#pod =head2 process $Inline $Script
#pod
#pod The C method works with the legacy function by passing the
#pod L and L arguments straight through
#pod to the legacy function, and returning it's result as the return value.
#pod
#pod =cut

sub process {
	my $self   = shift;
	my $Inline = _INSTANCE(shift, 'Test::Inline')         or return undef;
	my $Script = _INSTANCE(shift, 'Test::Inline::Script') or return undef;

	# Pass through the params, pass back the result
	$self->coderef->( $Inline, $Script );
}

1;

__END__