Plack:...:LogAny(3pm)

💖 Plack::Middleware::LogAny — the manual, but make it cute 💖

okay bestie, so this is the page for Plack::Middleware::LogAny (perl v5.38.2, dated 2024-08-03, in case the vibe check requires receipts ✨). It's a Plack middleware that hands your PSGI app's logging over to Log::Any, and honestly? It's giving main character energy. 👑

---

✨ NAME ✨

Plack::Middleware::LogAny — use Log::Any to handle logging from your PSGI application. No cap, that's the whole thing. 🎀

---

✨ SYNOPSIS ✨

Okay so here's how you'd actually use it. First, in your app.psgi file:

# in app.psgi file
use Plack::Builder;

Then you've got your PSGI application, like the girlboss you are:

# PSGI application
my $app = sub { ... };

Now — the DSL interface, which is the slay way to do it:

# DSL interface
builder {
  enable 'LogAny', category => 'plack', context => [ qw( X-Request-ID ) ];
  $app;
}

Or if you're feeling more OO about it, there's an alternative interface too:

# alternative OO interface
Plack::Middleware::LogAny->wrap( $app, category => 'plack', context => [ qw( X-Request-ID ) ] );

Periodt. 💅

---

✨ DESCRIPTION ✨

So LogAny is a Plack::Middleware component that lets you use Log::Any to handle the psgix.logger logging object. 🦋

That object? It's a code reference, and it's described over in PSGI::Extensions. Iykyk. 💖

---

✨ METHODS ✨

🌸 prepare_app()

This method initializes the logger using the category that you optionally set. Cute, right? ✨

🌸 call()

This method sets the logging object and the logging context. The logging context is localized. 🎀

---

✨ CONFIGURATION OPTIONS ✨

• category — the Log::Any category to send logs to. It defaults to '', which means it sends to the root logger. 🌈
• context — as of release 0.002 👀 — a list of HTTP header names that gets passed from the PSGI environment to the Log::Any logging context. 💜

---

✨ AUTHOR ✨

Sven Willenbuecher <sven.willenbuecher@kuehne-nagel.com> 🫶

---

✨ COPYRIGHT AND LICENSE ✨

This software is copyright (c) 2012 by Michael Alan Dorman. 👑

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself. 🌸

---

✨ SEE ALSO ✨

• Log::Any 💖

---

And that's the whole page, bestie — perl v5.38.2, dated 2024-08-03, brought to you by the good folks of the User Contributed Perl Documentation. Slay, stay logged, and remember to localize your context. 💅✨🎀