Rename template render to 'template'

'render' is already used heavily with 'render_error' and
'render_response'. Template does not render in the same sense - it just
returns a string content of the parsed template. For this reason it must
be renamed.

Author: bbrtj

ex/controllers/lib/ControllerApp/Controller/Clock.pm

@@ -18,7 +18,7 @@ sub build ($self)
 
 sub show_clock ($self, $ctx)
 {
-	return $self->render(\*DATA);
+	return $self->template(\*DATA);
 }
 
 __DATA__

ex/full-app/lib/FullApp.pm

@@ -17,7 +17,7 @@ sub build ($self)
 
 sub welcome_page ($self, $ctx)
 {
-	return $self->render(
+	return $self->template(
 		'welcome', {
 			config => $self->config->config,
 			api_url => $self->url_for('location_list_api'),

ex/sse/app.pl

@@ -29,7 +29,7 @@ ($self)
 
 sub init_sse ($self, $ctx)
 {
-	return $self->render(\*DATA);
+	return $self->template(\*DATA);
 }
 
 async sub handle_sse ($self, $ctx)

ex/websocket/app.pl

@@ -29,7 +29,7 @@ ($self)
 
 sub init_ws ($self, $ctx)
 {
-	return $self->render(\*DATA);
+	return $self->template(\*DATA);
 }
 
 async sub handle_ws ($self, $ctx)

lib/Thunderhorse.pm

@@ -779,9 +779,9 @@ during request processing.
 
 =head3 Template
 
-The Template module (L<Thunderhorse::Module::Template>) adds template
-rendering capabilities using L<Template::Toolkit>. It adds a C<render> method to
-controllers.
+The Template module (L<Thunderhorse::Module::Template>) adds template rendering
+capabilities using L<Template::Toolkit>. It adds a
+L<Thunderhorse::Module::Template/template> method to controllers.
 
 Loading the module:
 
@@ -813,7 +813,7 @@ Once loaded, templates can be rendered from controller methods:
 
 	sub show_page ($self, $ctx)
 	{
-		return $self->render('page', {
+		return $self->template('page', {
 			title => 'My Page',
 			content => 'Hello, World!',
 		});
@@ -834,12 +834,12 @@ If the first argument is passed as the reference, the behavior changes:
 
 =back
 
-For simple apps, it is often useful to render from C<DATA>. GLOB refs will be
+For simple apps, it is often useful to parse C<DATA>. GLOB refs will be
 rolled back after reading them automatically.
 
 	sub render_data ($self, $ctx)
 	{
-		return $self->render(\*DATA);
+		return $self->template(\*DATA);
 	}
 
 =head3 Middleware

lib/Thunderhorse/Module/Template.pm

@@ -26,7 +26,7 @@ sub build ($self)
 	my $tpl = $self->template;
 
 	$self->add_method(
-		controller => render => sub ($controller, $template, $vars = {}) {
+		controller => template => sub ($controller, $template, $vars = {}) {
 			return $tpl->process($template, $vars);
 		}
 	);
@@ -51,22 +51,22 @@ Thunderhorse::Module::Template - Template module for Thunderhorse
 	# in controller method
 	sub show_page ($self, $ctx)
 	{
-		return $self->render('page', {
+		return $self->template('page', {
 			title => 'My Page',
 			content => 'Hello, World!',
 		});
 	}
 
-	# render from DATA handle
+	# parse DATA handle
 	sub render_data ($self, $ctx)
 	{
-		return $self->render(\*DATA);
+		return $self->template(\*DATA);
 	}
 
 =head1 DESCRIPTION
 
 The Template module adds template rendering capabilities using
-L<Template::Toolkit>. It adds a L</render> method to controllers.
+L<Template::Toolkit>. It adds a L</template> method to controllers.
 
 =head1 CONFIGURATION
 
@@ -91,17 +91,17 @@ case they will be ignored.
 
 =head2 Controller Methods
 
-=head3 render
+=head3 template
 
-	$self->render('page', { title => 'My Page' });
-	$self->render(\*DATA);
-	$self->render(\$template_string);
+	$self->template('page', { title => 'My Page' });
+	$self->template(\*DATA);
+	$self->template(\$template_string);
 
-Renders a template and returns the rendered content. The first argument is the
-template name (C<.tt> suffix will be added automatically), and the second is a
-hash reference of variables to pass to the template. The method returns the
-rendered content, which is then sent to the client as HTML (if the context is
-not already consumed).
+Parses a template and returns the content. The first argument is the template
+name (C<.tt> suffix will be added automatically), and the second is a hash
+reference of variables to pass to the template. The method returns the parsed
+content, which can then be returned from the handler to be sent to the client
+as HTML (if the context is not already consumed).
 
 If the first argument is passed as a reference, the behavior changes:
 

t/module/template.t

@@ -51,22 +51,22 @@ package TemplateApp {
 	sub test ($self, $ctx, $ex)
 	{
 		$ex = defined $ex ? ".$ex" : '';
-		return $self->render("test$ex", {name => 'World'});
+		return $self->template("test$ex", {name => 'World'});
 	}
 
 	sub test_inline ($self, $ctx)
 	{
-		return $self->render(\'Hello [% name %]!', {name => 'Inline'});
+		return $self->template(\'Hello [% name %]!', {name => 'Inline'});
 	}
 
 	sub test_data ($self, $ctx)
 	{
-		return $self->render(\*main::DATA);
+		return $self->template(\*main::DATA);
 	}
 
 	sub test_bad ($self, $ctx)
 	{
-		return $self->render('bad_template');
+		return $self->template('bad_template');
 	}
 }