Module...emplate(3pm)

💖 Module::Starter::Plugin::Template 💖

okay bestie, so this is a page from the User Contributed Perl Documentation for Module::Starter::Plugin::Template — yes, the header literally says Module...emplate(3pm) because manpage headers truncate like that, it's giving budget cuts 😭 — and we're gonna walk through it together, no gatekeeping.

---

✨ NAME ✨

Module::Starter::Plugin::Template — it's module starter, but make it templates 💅

---

🌸 VERSION 🌸

version 1.80 ✨

---

🦋 SYNOPSIS 🦋

okay so here's the vibe, copy-paste girlies:

use Module::Starter qw(
  Module::Starter::Simple
  Module::Starter::Plugin::Template
);

Module::Starter->create_distro(%args);

that's it. that's the whole ritual 🕯️

---

🎀 DESCRIPTION 🎀

so this plugin is designed to be added onto a Module::Starter::Simple-compatible Module::Starter class. like, it's the accessory that completes the fit 👜

what it does: it adds stub methods for template retrieval and template rendering. and then — and this is the main character move — it replaces all of Simple's _guts methods with methods that will retrieve and render the appropriate templates. glow up, honestly. no cap. 🔥

---

👑 CLASS METHODS 👑

🌈 new(%args)

this plugin calls the new supermethod and then initializes the template store and the renderer. (see "templates" and "renderer" below, they're right there, bestie, keep reading 📖)

---

💜 OBJECT METHODS 💜

🍓 templates()

this method is used to initialize the template store on the Module::Starter object. it returns a hash of templates — each key is a filename, and each value is the body of that template. and the filename Module.pm is used for the module template. so cute, so organized. 🗂️

🧚 renderer()

this method is used to initialize the template renderer. its result gets stored in the object's renderer entry. and then... the implementation will determine its use. mysterious. cryptic. iconic. 🔮

⭐ render($template, \%options)

the render method will render the template that's passed to it, using the data in the Module::Starter object and in the hash of passed parameters. two data sources, one render, we love a collab 🤝

💀 _guts methods

okay so all of the FILE_guts methods from Module::Starter::Simple are subclassed to look something like this:

sub file_guts {
    my $self = shift;
    my %options;
    @options{qw(first second third)} = @_;

    my $template = $self->{templates}{filename};
    $self->render($template, \%options);
}

⚠️ real talk: these methods will need to be rewritten when (as is likely) Module::Starter::Simple's _guts methods are refactored into a registry. so don't get too attached, babe. it's a situationship with the API 😭

and here's the full roster of _guts methods, roll call 📣:

• module_guts
• Makefile_PL_guts
• MI_Makefile_PL_guts
• Build_PL_guts
• Changes_guts
• README_guts
• t_guts
• MANIFEST_guts
• ignores_guts

---

💖 AUTHOR 💖

Ricardo SIGNES, "<rjbs at cpan.org>" 🫶

---

🔥 Bugs 🔥

please report any bugs or feature requests to the bugtracker for this project on GitHub at: https://github.com/xsawyerx/module-starter/issues. i will be notified, and then you'll automatically be notified of progress on your bug as i make changes. mutuals keeping each other updated, that's the whole system fr fr 📬

---

🌟 COPYRIGHT 🌟

Copyright 2005-2007 Ricardo SIGNES, All Rights Reserved.

this program is free software; you can redistribute it and/or modify it under the same terms as Perl itself. slay, legally speaking ⚖️✨

---

and that's the whole page, bestie!! this was documented with perl v5.40.1, dated 2026-01-23, and the manpage itself is Module...emplate(3pm) 💅 mwah, go build something cute 🎀🦋💖