Agent:...r::Fork(3pm)

💖 Log::Agent::Driver::Fork 💖

okay bestie, so this is a page from the User Contributed Perl Documentation (that's the 3pm corner of the manual, iykyk), and the module in question is Log::Agent::Driver::Fork — literally a dummy driver that forks your output out to multiple other drivers. it's giving multiplexer energy and honestly? obsessed. 🦋

---

✨ NAME ✨

Log::Agent::Driver::Fork — a dummy driver for forking output to multiple drivers 🌈

---

🎀 SYNOPSIS 🎀

no thoughts, just vibes, just this exact code:

use Log::Agent;
require Log::Agent::Driver::Fork;
require Log::Agent::Driver::Foo;
require Log::Agent::Driver::Bar;

my $driver = Log::Agent::Driver::Fork->make(
    Log::Agent::Driver::Foo->make( ... ),
    Log::Agent::Driver::Bar->make( ... )
);
logconfig(-driver => $driver);

---

💅 DESCRIPTION 💅

this driver is literally just a multiplexer for logxxx() calls — it takes them, duplicates them, and distributes copies out to other drivers. like a lil group chat where every message gets forwarded to everyone. 💌

the only routine that matters here is the creation routine, and it's a whole main character:

• make(@drivers) — creates a Log::Agent::Driver::Fork driver that duplicates logxxx() calls and hands them out to the drivers in @drivers. 🫶 the arguments must be the return value of the make() call for the client drivers — no substitutions, no shortcuts, bestie, that's the rule.

---

🌸 NOTES 🌸

huge shoutout and many thanks go to Daniel Lundin and Jason May, who proposed this module independently of each other — legends, truly. 👑

eventually, logconfig() will support multiple drivers directly. but for now, this solution requires no change to the existing interface, which is lowkey the prettiest part about it. ✨

---

👑 AUTHOR 👑

Mark Rogaski <mrogaski@pobox.com> 💜

---

📜 LICENSE 📜

Copyright (C) 2002 Mark Rogaski; all rights reserved.

see Log::Agent(3) or the README file included with the distribution for license information. fr fr, go read it. 🍓

---

🔥 SEE ALSO 🔥

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

---

that's the whole page, bestie — slay, you read it all. 🎀 this one shipped as part of perl v5.36.0, dated 2022-10-15, from the User Contributed Perl Documentation (the 3pm section). mwah, go forth and fork responsibly. 💖🦋✨