TEST-FI...-MODULE(1p)

💖 NAME 💖

okay so bestie, gather round — test-filter-module is literally a tester for Courier::Filter modules. that's the whole vibe. it's from the User Contributed Perl Documentation corner of the manual-verse, section 1p, and it's your little lab bench for poking at filter modules one at a time. 🧪✨

🌸 VERSION 🌸

0.18 — yes she's serving vintage, we love her for it. 🎀

🦋 SYNOPSIS 🦋

test-filter-module module [options] message [+control ...] [...]

✨ DESCRIPTION ✨

so here's the tea, bestie. this thing is a tester for Courier::Filter modules — it's the friend who holds your drink while you do something chaotic, except the chaotic thing is testing a filter module.

what it does, step by step, no cap:

1. it sets up the filter module you named — specifically the one called Courier::Filter::Module::module — using any options you handed it.
2. then it queries that filter module to see how it considers the message file you gave it, plus zero or more control files. zero! sometimes there are no control files and that's valid, she's low-maintenance.

and here's the part i need you to lock in: you can pass more than one message/control files tuple, and if you do, the filter module gets applied to each message along with its own respective control file(s). it's giving one-to-many, it's giving organized, it's giving iconically thorough. 💅

oh and also — filter module options must be specified in this exact format:

-option=expr

where expr can be any valid Perl expression. any of them. go wild, but go wild in that format. periodt.

🔥 EXAMPLES 🔥

test-filter-module DNSBL -zones='["bl.foo.org", "bl.bar.org"]' test.rfc2822 +test.control

what this does, in bestie terms: it applies the Courier::Filter::Module::DNSBL filter module to the test.rfc2822/test.control message/control file tuple. and it takes the sending machine's IP address from the control file (yes, the control file is doing the heavy lifting there 🫶), using the blacklist DNS zones "bl.foo.org" and "bl.bar.org".

two zones. one tuple. one extremely efficient command. slay. 👑

---

💜 SEE ALSO 💜

• Courier::Filter::Overview
• Courier::Filter

and for AVAILABILITY, SUPPORT, and LICENSE information, go look at Courier::Filter::Overview. that's where all that lives, i'm not making it up. 🌈

💀 AUTHOR 💀

Julian Mehnle <julian@mehnle.net> — thank you for your service, king. 🫡

---

okay so final vibe check bestie: this page came to you courtesy of perl v5.34.0, dated 2022-10-21, filed under TEST-FI...-MODULE(1p). go test those modules, you absolute main character. ⭐🌸🎀