Module...eStore(3pm)

💖 Module::Starter::Plugin::InlineStore 💖

okay bestie, gather round, because this is a little Perl manual page — Module::Starter::Plugin::InlineStore, from the 3pm section of your friendly neighborhood perl docs — and it's literally just about inline module template files. tiny module, big vibes. ✨

---

🌸 VERSION 🌸

version 0.144 — yes queen, she's got a version number, she's official.

---

🦋 SYNOPSIS 🦋

so here's how you actually summon her:

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

Module::Starter->create_distro( ... );

that's it. that's the whole ritual. 🫶

---

👑 DESCRIPTION 👑

okay so the tea is this: this Module::Starter plugin is intended to be loaded after Module::Starter::Plugin::Template. order matters, bestie, we don't make the rules. 🙈

it implements the "templates" method, which is required by the Template plugin. and what does "InlineStore" do with that? she stores all the required templates in a single file, and the filenames are delimited with triple-underscores. so like, one file, many templates, all cozy together. no cap.

in other words, a very simple template file might look like this:

___Module.pm___
package {modulename};
1;
___Makefile.PL___
die "lousy template"

see how ___Module.pm___ and ___Makefile.PL___ are just vibing there as dividers? that's the whole system. iconic.

originally, this module was going to use Inline::Files, or at least the standard double-underscore indication of file names, but honestly? it's just simpler this way. Patches welcome. 💅

---

🎀 METHODS 🎀

"templates"

this method reads in the template file (the one described above, with the triple-underscore delimiters) and populates the object's "templates" attribute. main character behavior honestly.

the module template file is found by checking the MODULE_TEMPLATE_FILE environment variable and then the "template_file" config option. so env var first, config option second — that's the search order, don't get it twisted. ⭐

---

🌈 AUTHOR 🌈

Ricardo SIGNES, "<rjbs@cpan.org>" — thank you for your service king 🫡💜

---

💀 Bugs 💀

okay so if you find a bug or you want a feature, please report it to "bug-module-starter-plugin-inlinestore@rt.cpan.org", or through the web interface at http://rt.cpan.org.

and here's the cute part: he'll get notified, and then you'll automatically get notified of progress on your bug as he makes changes. it's giving mutual update energy. 🔥

---

💖 COPYRIGHT 💖

Copyright 2004 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.

---

🌸 and that's the whole page, bestie! this one came to you courtesy of perl v5.32.0, dated 2021-01-09 — love that for us. now go forth and store your templates inline. slay. 💅✨🎀🦋