pptemplate(3pm)

💖 pptemplate 💖

okay bestie, so this is pptemplate(3pm) — a little Perl script that ✨generates✨ you a Makefile.PL and a PP file skeleton. Yes it's a manpage, no it's not boring, come with me 💅

---

🎀 NAME 🎀

pptemplate — a script that generates your Makefile.PL and your PP file skeleton. That's the whole job. She's a starter-kit girlie 🫶

---

🌸 SYNOPSIS 🌸

Like, literally just this:

        # generate Makefile.PL and mymodule.pd in CWD
        pptemplate PDL::MyModule;

That's it. Run it, and it makes files in your current working directory. No cap. 🦋

---

👑 DESCRIPTION 👑

so here's the tea ☕ — pptemplate is the easiest way to start a brand new module for PDL that contains PP code (also go peek at PDL::PP while you're at it, iykyk). The usage is simply:

  pptemplate modulename;

and as a result, pptemplate will generate a perl Makefile for your new module (Makefile.PL) that contains the minimal structure you need to generate a module from PP code, plus a skeleton file for your brand-new module. She's giving scaffolding, she's giving structure, she's giving main character energy ✨

The file will be called mymod.pd if you called pptemplate like this:

  pptemplate PDL::CleverAlgs::Mymod;

I suppose you can work out the naming rule yourself ;) — it's honestly not that deep. If you can't, resort to experimentation or go read the source code, bestie 💀

🚨 IMPORTANT: pptemplate will refuse to overwrite existing files of the same name to avoid accidents. She is NOT trying to ruin your life. If you really want to scrap them, move them out of the way first. Periodt. 💅

---

⭐ Options ⭐

Currently there is only the -i option, which switches pptemplate into the so-called internal mode. Use it only when you're starting a new module within the main PDL tree that's supposed to be part of the PDL distribution and the normal PDL build process, like:

   cd PDL/IO;
   mkdir Mpthree; cd Mpthree;
   pptemplate -i PDL::IO::Mpthree;

So like, one option, and it's for the inside-the-house crowd only 🏠 don't be out here using -i for your random side project, okay? 🙈

---

😭 BUGS 😭

Maybe ;). Honestly she's a little mysterious like that. Feedback and bug reports are welcome though — slide into the issue tracker, bestie, we're listening 🫶

---

🌈 COPYRIGHT 🌈

Copyright (c) 2001, Christian Soeller. All Rights Reserved. This module is free software. It may be used, redistributed and/or modified under the same terms as PDL itself (see <http://pdl.perl.org>).

---

and that's the whole vibe check ✅ this page was brought to you by perl v5.38.2, dated 2024-04-10, living its life as pptemplate(3pm) — go forth and generate your skeletons, you're gonna slay 💖✨🎀