Mail::SRS::DB(3pm)

πŸ“¦
version 0.31 Β· 2 versions
  • 0.31 Β· debian bookworm, debian trixie, ubuntu noble, ubuntu resolute, ubuntu stonking (latest)
  • 0.31 Β· ubuntu jammy
, in debian bookworm, debian trixie, ubuntu noble, ubuntu resolute, ubuntu stonking

πŸ’– Mail::SRS::DB β€” the manual page, but make it cute πŸ’–

okay bestie, gather round, because we're talking about Mail::SRS::DB β€” a MLDBM based Sender Rewriting Scheme, living its best life over in section 3pm of the Perl docs 🫢


✨ NAME ✨

Mail::SRS::DB β€” a MLDBM based Sender Rewriting Scheme πŸ’…


✨ SYNOPSIS ✨

look at her, she's gorgeous:

        use Mail::SRS::DB;
        my $srs = new Mail::SRS::DB(
                Database => '/var/run/srs.db',
                ...
                        );

that's it. that's the whole vibe check. instantiate and go 🌸


✨ DESCRIPTION ✨

so, for the full deets on the standard SRS subclass interface, you're gonna wanna peek at Mail::SRS β€” she's the blueprint, this one is the glow-up ✨

this module is the one that hands you two methods, and they're literally the whole point:

  • compile() β€” does the compile thing πŸŽ€
  • parse() β€” does the parse thing πŸ¦‹

also!! important!! she needs one extra parameter in the constructor β€” a filename for a Berkeley DB_File database. like the /var/run/srs.db from the synopsis up there. no filename, no database, no SRS. periodt. πŸ’€


✨ BUGS ✨

okay so, real talk, nobody's perfect and this module knows it 😭

this code relies on not getting collisions in the cryptographic hash. it can and should be fixed. (not me saying the words "should be fixed" in the actual docs πŸ’€ iconic honesty honestly)

also:

the database is not garbage collected. she just. keeps. growing. πŸ™ˆ

✨ SEE ALSO ✨

  • Mail::SRS β€” go read her, she's the moment πŸ‘‘

that's the whole page bestie, no notes πŸ’œ

so yeah, this manual page was brought to you by perl v5.36.0, dated 2022-11-27, and it's the Mail::SRS::DB(3pm) page β€” slay, go forth, rewrite your senders 🧚✨

πŸ“¦ where this page comes from