Mail::S...::Record(3)

πŸ’– Mail::S...::Record β€” like, the Mail::SPF::v2::Record page, bestie πŸ’–

okay so this is Mail::S...::Record(3) from the User Contributed Perl Documentation, and it's literally all about the Sender ID record class. pull up a chair, we're doing this ✨

🌸 NAME 🌸

Mail::SPF::v2::Record β€” the Sender ID ("spf2.0") record class. that's the whole vibe. πŸ‘‘

πŸŽ€ VERSION πŸŽ€

version 3.20260331

πŸ¦‹ SYNOPSIS πŸ¦‹

bestie, it just says:

See Mail::SPF::Record.

so yeah, go read that one, this one's the Sender-ID-flavored sibling. πŸ’…


🌈 DESCRIPTION 🌈

an object of class Mail::SPF::v2::Record represents a Sender ID ("spf2.0") record. that's it, that's the girl. it's giving "spf2.0 record, but make it an object." πŸ’–

✨ Constructors ✨

here are the constructors they hand you:

  • new(%options) : returns Mail::SPF::v2::Record β€” makes you a brand new Sender ID ("spf2.0") record object. slay.

%options is a list of key/value pairs, and it can be any of these:

  • text
  • terms
  • global_mods

these three? see "new" in Mail::SPF::Record. they're doing their thing over there. πŸ‘€

  • scopes β€” Required. like, you have to give it. see "new" in Mail::SPF::Record. the 'mfrom' and 'pra' scopes are the supported ones. there is no default, so don't come in here hoping for a fallback, because there isn't one. 😭
  • new_from_string($text, %options) : returns Mail::SPF::v2::Record; throws Mail::SPF::ENothingToParse, Mail::SPF::EInvalidRecordVersion, Mail::SPF::ESyntaxError β€” makes a new Sender ID ("spf2.0") record object by parsing the string, plus whatever options you passed. if it can't? it throws one of those three exceptions, no cap. πŸ’€

🌟 Class methods 🌟

the class methods on offer:

  • version_tag_pattern : returns Regexp β€” returns a regular expression that matches a version tag of 'spf2.0/' plus a comma-separated list of any of the 'mfrom' and 'pra' scopes. these are the valid version tags, periodt:
spf2.0/mfrom
spf2.0/pra
spf2.0/mfrom,pra
spf2.0/pra,mfrom
  • default_qualifier
  • results_by_qualifier

these two? see "Class methods" in Mail::SPF::Record. πŸ’«

πŸ’œ Instance methods πŸ’œ

and the instance methods, bestie:

  • text
  • scopes
  • terms
  • global_mods
  • global_mod
  • stringify
  • eval

all of the above? see "Instance methods" in Mail::SPF::Record. they're living their best life over there. 🫢

  • version_tag : returns string β€” returns 'spf2.0/' plus a comma-separated list of the scopes of the record. wanna know what it could possibly hand back? see "version_tag_pattern" for the list of possible return values. iconic. ⭐

πŸ”₯ SEE ALSO πŸ”₯

and for availability, support, and license info, go look at the README file included with Mail::SPF. πŸ“–

πŸ‘‘ AUTHORS πŸ‘‘

Julian Mehnle <julian@mehnle.net>, Shevek <cpan@anarres.org>


and that's the whole page, babe πŸ’– this was generated by perl v5.42.1 on 2026-04-23, and it's the Mail::S...::Record(3) manual page β€” go forth and parse some Sender ID records, you absolute main character πŸŒˆβœ¨πŸ“

πŸ“¦ where this page comes from