Template::Parser::RemoteInclude - call remote template-server inside your template
You can write your own html aggregator for block build pages. However, this module allows you to make remote calls directly from the template. This is very useful when your project have a template server.
This module allows you to make any http-requests from template.
Depends on Template::Parser and AnyEvent::Curl::Multi.
Curl::Multi faster than LWP. AnyEvent::Curl::Multi much faster than LWP ;)
Use and enjoy!
Directive RINCLUDE like PROCESS, but call remote uri.
RINCLUDE
PROCESS
Parser does not know anything about Template::Stash, but knows about the variables passed in Template::process.
Template::process
Content of the response can be as a simple html or a new template
Contents of the response is recursively scanned for directives RINCLUDE and makes additional request if necessary
The best option when your template-server is located on the localhost
create Template object with Template::Parser::RemoteInclude as parser.
Template
Template::Parser::RemoteInclude
use Template; use Template::Parser::RemoteInclude; my $tt = Template->new( INCLUDE_PATH => '....', ...., PARSER => Template::Parser::RemoteInclude->new( 'Template::Parser' => { ...., }, 'AnyEvent::Curl::Multi' => { max_concurrency => 10, ...., } ) );
simple example include content http://ya.ru/ (with GET as http method)
http://ya.ru/
# example 1 my $tmpl = "[% RINCLUDE GET 'http://ya.ru/' %]"; $tt->process(\$tmpl,{}); # example 2 - use variables passed in Template::process my $tmpl = "[% RINCLUDE GET ya_url %]"; $tt->process(\$tmpl,{ya_url => 'http://ya.ru/'}); # example 3 - set headers my $tmpl = "[% RINCLUDE GET ya_url ['header1' => 'value1','header2' => 'value2'] %]"; $tt->process(\$tmpl,{ya_url => 'http://ya.ru/'}); # example 4 - set headers my $tmpl = "[% RINCLUDE GET ya_url headers %]"; $tt->process(\$tmpl,{ya_url => 'http://ya.ru/', headers => ['header1' => 'value1','header2' => 'value2']}); # example 5 - use HTTP::Request (with POST as http method) passed in Template::process my $tmpl = "[% RINCLUDE http_req_1 %]"; $tt->process( \$tmpl, { http_req_1 => HTTP::Request->new( POST => 'http://ya.ru/', ['header1' => 'value1','header2' => 'value2'], $content ) } );
example include remote template
# http://example.com/get/template/hello_world => # '<b>Hello, [% name %]!</b><br>[% name = "Boris" %][% RINCLUDE "http://example.com/.../another" %]' # and # http://example.com/.../another => # '<b>And goodbye, [% name %]!</b>' # example my $tmpl = "[% RINCLUDE GET 'http://example.com/get/template/hello_world' %]"; $tt->process(\$tmpl,{name => 'User'}); # returned <b>Hello, User!</b><br><b>And goodbye, Boris!</b>
more power example
use Template; use Template::Parser::RemoteInclude; my $tt = Template->new( INCLUDE_PATH => '....', ...., PARSER => Template::Parser::RemoteInclude->new( 'Template::Parser' => { ...., }, 'AnyEvent::Curl::Multi' => { max_concurrency => 10, ...., } ), WRAPPER => 'dummy.tt2' ); # where 'dummy.tt2' # [% IF CSS %] # [% FOREACH c = CSS %] # css = [% c %] # [% END %] # [% END %] # ==== # [% content %] # ==== # http://example.com/get/template/hello_world => # "[% CSS.push('http://example.com/file.css') %]\nHello, [% name %]!\n" my $tmpl = "[% SET CSS = [] %][% RINCLUDE GET 'http://example.com/get/template/hello_world' %]"; $tt->process(\$tmpl,{name => 'User'}); # output: # css = http://example.com/file.css # # ==== # # Hello, User! # # ====
Simple constructor
AnyEvent::Curl::Multi, Template
mr.Rico <catamoose at yandex.ru>
To install Template::Parser::RemoteInclude, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Template::Parser::RemoteInclude
CPAN shell
perl -MCPAN -e shell install Template::Parser::RemoteInclude
For more information on module installation, please visit the detailed CPAN module installation guide.