Perlba...nclude(3pm)

💖 NAME 💖

Perlbal::Plugin::Include — it lets you have multiple, nesting configuration files, bestie 🦋✨

---

🌸 DESCRIPTION 🌸

Okay so listen. This module adds an INCLUDE command to the Perlbal management console, and it lets you glob your way into including configuration files 💅

That's it. That's the whole vibe. Nesting configs, globbed includes, main character energy only ✨

---

🎀 SYNOPSIS 🎀

This module hands you a Perlbal plugin that you load and use like this, no cap:

LOAD include
INCLUDE = /etc/perlbal/my.conf

And you can also drop multiple configuration files in there, à la File::Glob — yes queen, go off 🫶:

INCLUDE = /foo/bar.conf /foo/quux/*.conf

---

💀 BUGS AND LIMITATIONS 💀

Lowkey important, so read this part fr fr 🙈

This module relies entirely on Perlbal::load_config for loading. So if you're having trouble with INCLUDE, bestie, be sure you can load that same configuration without error using perlbal -c first. Like, verify before you come for this module's wig 💅

Also, heads up: Perlbal::load_config versions 1.60 and below do not use a local filehandle while reading the configuration file 😭 which is exactly why this module overrides that routine on load — so nested calls can actually happen. Not me fixing the vibes so nesting works 🧚

---

👑 COPYRIGHT AND LICENSE 👑

Copyright 2008 Eamon Daly <eamon@eamondaly.com> 💖

This module is part of the Perlbal distribution, and as such it can be distributed under the same licence terms as the rest of Perlbal. Slay ✨

---

And that's the whole page, bestie — documented by perl v5.34.0 on 2022-06-28, filed under Perlba...nclude(3pm). Go nest some configs, you absolute icon 🎀🦋💜