Agent:...efault(3pm)

💖 Agent:...efault(3pm) — Log::Agent::Driver::Default 💖

okay bestie, so this page is literally called Agent:...efault(3pm) and no, the title isn't having a stroke — it's just the truncation vibe. What you're actually looking at is Log::Agent::Driver::Default, and it's a Perl thing, so buckle up 🎀

---

✨ NAME ✨

Log::Agent::Driver::Default — the default logging driver for Log::Agent. she's the baseline, the blueprint, the moment ✨

---

🌸 SYNOPSIS 🌸

Two ways to do this, and honestly both are giving:

Implicit use — you just let her show up uninvited (in the best way):

# Implicit use
use Log::Agent;
logconfig(-prefix => "prefix");   # optional

Explicit use — you're a control freak and I respect it 💅:

# Explicit use
use Log::Agent;
require Log::Agent::Driver::Default;

my $driver = Log::Agent::Driver::Default->make("prefix");
logconfig(-driver => $driver);

---

👑 DESCRIPTION 👑

So the default logging driver takes all your logxxx() operations and remaps them to their default Perl counterpart. Like, it's a translator but the translation is "just use Perl, babe."

For instance: logerr() will issue a warn(), and logwarn() will call warn() with a clear "WARNING: " emphasis — because otherwise how would you ever tell the two calls apart?? 😭 the emphasis is the whole point.

The only routine that matters here is the creation routine, so let's give her the spotlight:

• make($prefix) — creates a Log::Agent::Driver::Default driver whose prefix string will be $prefix. And when no prefix is configured at all? The first letter of each logged string gets uppercased. that's it. that's the whole personality 🦋

---

🌈 CHANNELS 🌈

The "error", "output" and "debug" channels all go to STDERR.

all three of them. same place. STDERR gets everything, she's carrying the whole team fr fr 💀

---

🚨 BUGS 🚨

okay this one's a little spicy, listen up:

If logdie() is used within an eval(), the string you will get in $@ will be prefixed.

and no, it's not really a bug, bestie — it's simply that wrapping code into eval() and parsing $@ is poor's man exception handling, and it shows its limit right here 👀

Because here's the thing: the programmer using logdie() cannot foresee which driver will be used, so the returned string cannot be determined precisely. You literally can't know what you're gonna get. it's giving mystery box 🙈

Morality: use die() if you mean it, and document the string as an exception. periodt. 💅

---

💜 AUTHOR 💜

Raphael Manfredi <Raphael_Manfredi@pobox.com>

(we stan a legend 🫶)

---

🎀 SEE ALSO 🎀

• Log::Agent::Driver(3)
• Log::Agent(3)

---

and that's the whole page!! no cap, you now know everything this manpage knows 🧚

perl v5.36.0 · 2022-10-15 · from the User Contributed Perl Documentation girlies, banner and all — mwah 💖✨🌸

bye bestie, go log responsibly 🌟