Template::Modules(3)

🌸 NAME 🌸

Template::Modules — Template Toolkit Modules 💖

hiii bestie, you're reading the Template::Modules(3) page from the User Contributed Perl Documentation — it's literally the map of the whole Template Toolkit module family 🫶

---

🦋 Template Toolkit Modules 🦋

okay so this page is the overview of all the different modules that make up the Template Toolkit. iykyk ✨

🌟 Template 🌟

The Template module is the front-end to the Template Toolkit for Perl programmers. main character energy fr 💅

use Template;
my $tt = Template->new();
$tt->process('hello.html', message => 'Hello World');

🌟 Template::Base 🌟

The Template::Base module implements a base class from which the other Template Toolkit modules are derived. It implements common functionality for creating objects, error reporting, debugging, and so on. iconic inheritance behavior 🎀

🌟 Template::Config 🌟

The Template::Config module defines the configuration of the Template Toolkit for your system. It is an example of a factory module which is responsible for instantiating the various other modules used in the Template Toolkit. factory girl vibes 🏭✨

For example, the Template::Config module defines the $STASH package variable which indicates which version of the Template::Stash you are using by default. If you elected to use the faster XS stash when you installed the Template Toolkit, then this will be set as:

$STASH = 'Template::Stash::XS';

Otherwise you'll get the regular Perl stash:

$STASH = 'Template::Stash';

This approach means that other parts of the Template Toolkit don't have to worry about which stash you're using. They just ask the Template::Config module to create a stash of the right kind. no cap, that's a slay 💅

🌟 Template::Constants 🌟

The Template::Constants module defines a number of constants that are used by the Template Toolkit. little constants doing big things 💖

For example, the :chomp tagset defines the CHOMP_??? constants that can be used with the PRE_CHOMP and POST_CHOMP configuration options.

use Template::Constants ':chomp';
my $tt = Template->new({
    PRE_CHOMP => CHOMP_COLLAPSE,
});

🌟 Template::Context 🌟

The Template::Context module defines a runtime context in which templates are processed. A context keeps track of all the templates, variables, plugins, and other resources that are available (either directly or through delegate objects) and provides methods to fetch, store, and perform various operations on them. it's giving runtime headquarters 🧚✨

🌟 Template::Document 🌟

The Template::Document module implements a compiled template document object. This is generated by the Template::Parser module. compiled and cute 🎀

🌟 Template::Exception 🌟

The Template::Exception module implements an exception object which is used for runtime error reporting. dramatic error moment, but make it structured 😭💅

🌟 Template::Filters 🌟

The Template::Filters module implements a filter provider. It includes the core collection of filters that can be used via the FILTER directive. filter provider ate, honestly 🔥

🌟 Template::Iterator 🌟

The Template::Iterator module implements a data iterator which steps through each item in a list in turn. It is used by the FOREACH directive. Within a FOREACH block, the loop variable always references the current iterator object. loop girlies rise 🌀💖

[%  FOREACH item IN list;
      IF loop.first;
         # first item in loop
      ELSIF loop.last;
         # last item in loop
      ELSE;
         # any other item in loop
      END;
    END
%]

🌟 Template::Namespace::Constants 🌟

The Template::Namespace::Constants module is used internally to represent constants. These can be resolved immediately at the point that a template is compiled. internal but iconic ✨

🌟 Template::Parser 🌟

The Template::Parser module is used to parse a source template and turn it into Perl code which can be executed. parse her, she's doing great 💅

🌟 Template::Plugin 🌟

The Template::Plugin module is a base class for Template Toolkit plugins that can be loaded on demand from within a template using the USE directive. plugin base class, the moment 🧚‍♀️

🌟 Template::Plugins 🌟

The Template::Plugins module is the plugins provider. It loads and prepares plugins as and when they are requested from within a template. plugins on demand, we love to see it 🫶

🌟 Template::Provider 🌟

The Template::Provider module is responsible for loading, compiling and caching templates. template supply chain queen 👑

🌟 Template::Service 🌟

The Template::Service module implements a service layer that sits just behind the Template module, and just in front of a Template::Context. It handles each request to process a template (forwarded from the Template module). It adds any headers and/or footers (specified via the PRE_PROCESS and POST_PROCESS options), applies any wrapper (the WRAPPER option) and catches any errors returned (the ERRORS option). service layer with main character energy, fr fr 🌈

🌟 Template::Stash 🌟

The Template::Stash module is used to fetch and store template variables. It implements all of the magic associated with the dot operator. dot operator magic, lowkey legendary 🪄✨

🌟 Template::Stash::XS 🌟

The Template::Stash::XS module is a high-speed implementation of Template::Stash written in C. speed demon stash, no cap 🔥

🌟 Template::Test 🌟

The Template::Test module is used to automate the Template Toolkit test scripts. test automation bestie, we stan 🎀

---

okay that’s the whole page, bestie 🫶 — it’s from perl v5.42.0, dated 2024-06-23, and it lives as Template::Modules(3) in the User Contributed Perl Documentation. mwah 💋✨