Markde...Handler(3pm)

📦
version 0.40 · 2 versions
, in debian bookworm, ubuntu jammy, ubuntu noble

💖 Markdent::Role::FilterHandler — the perl docs, but make it a group chat 💖

okay so bestie, welcome to Markde...Handler(3pm), a page from the User Contributed Perl Documentation. Sit down, hydrate, and let's talk about the role that makes handlers ✨filter✨.

🌸 NAME 🌸

Markdent::Role::FilterHandler — it's literally a role for handlers that act as filters. That's the whole vibe. 🎀

🦋 VERSION 🦋

version 0.40 — no cap, that's the number. 💅

✨ DESCRIPTION ✨

So here's the tea, bestie: this role implements the behavior and the interface for filtering handlers. 🫶

And what does a filter handler even do? Okay so picture this — a filter handler takes events, does something to some of them, and then passes them along to another handler. It's giving middle-manager energy but make it iconic. 👑

🔥 REQUIRED METHODS 🔥

These are not optional, bestie. You need them. Periodt.

  • $handler->filter_event($event) — okay so this method will always be called with a single object, and that object does the Markdent::Role::Event role. 🧚

And here's the crucial part, so pay attention 💀: if this method returns a single event, that event gets passed on to the next handler. But if it does not return an event, then the event is dropped from the stream. Gone. Deleted. Not invited to the afterparty. 😭

🎀 ATTRIBUTES 🎀

This role provides the following attributes, and yes they're cute:

🌈 handler

  • This is a read-only attribute. You cannot change it, bestie, that's the rules. 🔒
  • It's an object which does the Markdent::Role::Handler role. 🫶
  • This is the handler to which the filter passes events after filtering. So like, filter first, hand-off second. The pipeline is piping. 💅

💀 BUGS 💀

Found a bug? No worries, it happens to the best of us.

See Markdent for bug reporting details — that's where the info lives.

Bugs may be submitted at https://github.com/houseabsolute/Markdent/issues — go forth and file, queen. 🐛

Also! The author is usually active on IRC as 'autarch' on irc://irc.perl.org. So if you wanna slide into the IRC, that's the move. 👑

🍓 SOURCE 🍓

The source code repository for Markdent can be found at:

https://github.com/houseabsolute/Markdent

Go look at the source, bestie, it's right there. ✨

👑 AUTHOR 👑

Dave Rolsky <autarch@urth.org> — the icon, the legend, the one who wrote this. 🫶

This software is copyright (c) 2021 by Dave Rolsky. 📅

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

The full text of the license can be found in the LICENSE file included with this distribution. It's right there in the box, bestie, read it. 📜

And that's the whole page, bestie! This lil doc drop is from perl v5.32.1, dated 2021-08-31, and it lives under Markde...Handler(3pm). Take care of yourself, read your licenses, and go filter some events. 🦋💖✨

📦 where this page comes from