MsOffi...Engine(3pm)

📦 version 2.05, in debian trixie, ubuntu resolute, ubuntu stonking

💖 MsOffi...Engine(3pm) — the Perl manual page, but make it a group chat 💖

okay bestie, so this is the MsOffice::Word::Template::Engine page from the User Contributed Perl Documentation and honestly? it's giving backstage pass to the engine room. let's get into it 🫶

✨ NAME ✨

MsOffice::Word::Template::Engine — it's an abstract class for template engines. yeah. abstract. it's the blueprint, not the build. the vibe, not the venue. 🎀

🌸 DESCRIPTION 🌸

so, this abstract class wraps up all the functionalities that are common to every templating engine — the shared lore, if you will. the concrete classes, like MsOffice::Word::Template::Engine::TT2, inherit from this one. they're the ones who actually show up and do the thing. this class is the parent who set them up for success. 👑

now, important: templating engines encapsulate internal implementation algorithms. they are not meant to be called from external clients. so like — do not text them. they're not taking calls from outside the house. the methods documented below are purely there to explain the internal architecture, iykyk. it's a peek behind the curtain, not an invitation to the stage. 🙈

🦋 METHODS 🦋

💅 _compile_templates

$self->_compile_templates($word_template);

this one calls the subclass's concrete method compile_template on each document part. that's it. that's the whole job. it's the delegator. the hype friend who makes sure everybody gets their moment. ✨

🎀 _template_fragment_for_run

translates a given text run into a fragment that's suitable to be processed by the template compiler. glow-up pipeline, basically. 🌈

⭐ xml_regexes

compiles the regexes to be tried on each text run. get those patterns ready, bestie, we're matching. 🔥

Copyright 2020-2024 by Laurent Dami.

This program is free software, you can redistribute it and/or modify it under the terms of the Artistic License version 2.0. slay, and also legally binding. periodt. 💜

fr fr, this page is from perl v5.40.0, dated 2024-10-31, and yes the manual name really is squished to MsOffi...Engine(3pm) — no cap, that's just how the header rendered. iconic. 💖🦋🎀
📦 where this page comes from