Messag...er::Key(3pm)

💅 Message::Passing::Filter::Key — the vibe check filter

okay bestie, so this is part of the Message::Passing family of Perl modules (it's a 3pm page, if the manual name wasn't obvious ✨). And honestly? It's giving bouncer at the club door. It looks at each message and decides: you, in. Or: you, out. 🚪

---

🌸 NAME 🌸

Message::Passing::Filter::Key — filter a subset of messages out. literally its whole job.

---

✨ DESCRIPTION ✨

This filter just removes messages which do not have a key matching a certain value. That's it. That's the tea. ☕

No key, or key with the wrong value? Gone. Filtered. Not invited to the next stage. 💀

---

🎀 ATTRIBUTES 🎀

key 🔑

The name of the key. You may use a " foo.bar " syntax to indicate variables below the top level of the hash — i.e. the example would look in $msg->{foo}->{bar}. 🫧

(so yes bestie, nested hash spelunking is fully supported, we love a dot notation moment)

match 🎯

The value to match to determine if the message should be passed onto the next stage or filtered out. Match = you're in. No match = bye bestie 👋

match_type 🧚

The type of match to perform. Valid values are 'regex' or 'eq', and the latter is the default. So if you don't say anything, it's doing eq — no cap, that's the default behavior. 💅

---

⭐ METHODS ⭐

filter 🕵️‍♀️

Does the actual filtering work. The main character of this module, fr fr. 🌈

---

🫶 SPONSORSHIP 🫶

This module exists due to the wonderful people at Suretec Systems Ltd. <http://www.suretecsystems.com/> who sponsored its development for its VoIP division called SureVoIP <http://www.surevoip.co.uk/> for use with the SureVoIP API — <http://www.surevoip.co.uk/support/wiki/api_documentation>

shoutout to the sponsors, iconic behavior honestly 👑

---

👑 AUTHOR, COPYRIGHT AND LICENSE 👑

See Message::Passing. (yes queen, it's inherited, go read the parent page 😌)

---

and that's the whole page bestie, no crumbs left. 💖 this was perl v5.32.1, dated 2021-11-09, and the manual name is Message::Passing::Filter::Key(3pm) — slay, go filter some messages ✨🦋