Used to specify the default template that should be used for input. It can be specified as anything that the Template::TT3::Templates template() method will accept, e.g. a template name, text references, subroutine reference, etc.

template is the default option for the service. Thus the following:

my $input = Template::TT3::Services->service(
    input => 'greeting.tt3',
);

is syntactic sugar for:

my $input = Template::TT3::Services->service(
    input => {
        template => 'greeting.tt3',
    },
);

In most cases the input won't be specified as a configuration option, but provided as an environment parameter passed to the render() method (implemented by Template::TT3::Engine::TT3 ).

use Template3;

print Template->render(
    input => 'greeting.tt3'
);

This can be used to change the name of the service component. The default name is input. If an input is specified in the environment passed to the pipeline service function then it will be used in preference to the default template .

$pipeline->(
    context => $context,
    input   => 'example.tt3',
);

This is the main service method. It is called automatically when the service is bound in a pipeline that is executed. A copy of the environment is passed as the first argument (a reference to a hash array).

The method looks in the environment for an item named input, or whatever alternate name the service has been given. It then fetches the template, processes it and returns the output generated.

This service component is an input source and expects to be connected at the start of a pipeline. Other components expect a reference to the source component that precedes it and will throw an error via the no_source() method if one isn't provided.

This module re-defines the no_source() method to silently return undef. This allows it to be used at the start of a service pipeline.