Zonemaster::Util(3pm)

💖 Zonemaster::Util 💖

okay bestie, welcome to Zonemaster::Util — the lil utility drawer for all the other Zonemaster modules 💅 it's a Perl module, documented in the user-contributed Perl docs, and it's basically the friend that hands everyone else their stuff. no cap.

✨ SYNOPSIS ✨

use Zonemaster::Util;
info(TAG => { some => 'argument'});
my $ns = ns($name, $address);
my $name = name('whatever.example.org');

look at that. three lines, three lil helpers, zero drama 🌸

🎀 EXPORTED FUNCTIONS 🎀

these are the ones that get handed to you when you use Zonemaster::Util; — the whole squad fr fr.

• info($tag, $href) — builds you a Zonemaster::Logger::Entry object and returns it 🫶 oh and it doesn't just make it and ghost — the object also gets added to the global logger object's list of entries. it's giving main character energy, it's giving "i'm in the group chat AND in the archive".
• ns($name, $address) — makes and returns a nameserver object with the name and address you gave it. name + address in, nameserver out. slay ✨
• policy() — returns a reference to the global policy hash 👑 that's it, that's the whole vibe.
• name($string_name_or_zone) — takes your argument and creates and returns a Zonemaster::DNSName object for it. one string in, one DNS name object out, iconic behavior.
• pod_extract_for($testname) — okay so this one will attempt to extract the POD documentation for the test methods in the test module whose name you passed in 🔍 if it can, it returns a reference to a hash where the keys are the test method names and the values are the documentation strings. super useful, super cute.

⚠️ but bestie, listen: this method blindly assumes that the structure of the POD is exactly like the one in the Example and Basic test modules. exactly. like. that. if it's not? the results are undefined 💀 no guardrails, no seatbelt, we're just vibing into the void.

• scramble_case — this routine provides a special effect: sCraMBliNg tHe CaSe 😭😭 it's literally just that. that's the feature. and honestly? ate.
• supports_ipv6 — checks if the ZOnemaster hosting server supports IPv6 🦋 yes or no, v6 or not v6.

that's the whole page, bestie — every function, every argument, every warning, nothing skipped 💜

this doc was brought to you by perl v5.32.0, dated 2021-01-06, from the Zonemaster::Util(3pm) manual page in the user-contributed Perl documentation 🌈 mwah, go write some Zonemaster modules, you got this 🫶💖