Zonema...istency(3pm)

💅 NAME

okay bestie, meet Zonemaster::Engine::Test::Consistency — the module that runs all the tests focused on name servers responses consistency. it lives in the User Contributed Perl Documentation, and you'll spot it filed under Zonema...istency(3pm). yes the name got truncated, we're all doing our best 💖

---

✨ SYNOPSIS ✨

my @results = Zonemaster::Engine::Test::Consistency->all( $zone );

---

🎀 METHODS 🎀

all()

my @logentry_array = all( $zone );

Runs the default set of tests for that module — that's six tests, no more no less, the whole lineup 🌈

Takes a Zonemaster::Engine::Zone object.

Returns a list of Zonemaster::Engine::Logger::Entry objects.

metadata()

my $hash_ref = metadata();

Returns a reference to a hash, where the keys are the names of all Test Cases in the module, and the values are references to an array holding all the message tags that Test Case can use in log entries. it's giving index-of-everything ✨

tag_descriptions()

my $hash_ref = tag_descriptions();

This one is used by the built-in translation system.

Returns a reference to a hash where the keys are the message tags and the values are strings (message ids). keys → tags, values → message ids, that's the whole vibe 🔑

version()

my $version_string = version();

Returns a string containing the version of the current module. slay 💅

---

🧚 INTERNAL METHODS 🧚

these are the behind-the-scenes girlies — the plumbing, not the show 💜

_emit_log()

my $log_entry = _emit_log( $message_tag_string, $hash_ref );

Adds a message to the logger for this module. See add($tag, $argref, $module, $testcase) in Zonemaster::Engine::Logger::Entry for more details.

Takes a string (message tag) and a reference to a hash (arguments).

Returns a Zonemaster::Engine::Logger::Entry object.

_ip_disabled_message()

my $bool = _ip_disabled_message( $logentry_array_ref, $ns, @query_type_array );

Checks if the IP version of a given name server is allowed to be queried. If it's not allowed, it adds a logging message and returns true. Otherwise it returns false. a lil vibe check for IP versions 🫶

Takes a reference to an array of Zonemaster::Engine::Logger::Entry objects, a Zonemaster::Engine::Nameserver object and an array of strings (query type).

Returns a boolean.

_get_addr_rrs()

my ( $logentry, @rrs_array ) = _get_addr_rrs( $ns, $zone_name, $query_type_string );

Queries a given name server for resource records of the given type. Used as a helper function for Test Case Consistency05.

Takes a Zonemaster::Engine::Nameserver object, a Zonemaster::Engine::DNSName object and a string (query type).

Returns a Zonemaster::Engine::Logger::entry object (which could be "undef") and an optional list of Zonemaster::LDNS::RR objects. yep, undef is always a possibility, we stay humble 🙈

---

👑 TESTS 👑

consistency01()

my @logentry_array = consistency01( $zone );

Runs the Consistency01 Test Case <https://github.com/zonemaster/zonemaster/blob/master/docs/public/specifications/tests/Consistency-TP/consistency01.md>.

Takes a Zonemaster::Engine::Zone object.

Returns a list of Zonemaster::Engine::Logger::Entry objects.

consistency02()

my @logentry_array = consistency02( $zone );

Runs the Consistency02 Test Case <https://github.com/zonemaster/zonemaster/blob/master/docs/public/specifications/tests/Consistency-TP/consistency02.md>.

Takes a Zonemaster::Engine::Zone object.

Returns a list of Zonemaster::Engine::Logger::Entry objects.

consistency03()

my @logentry_array = consistency03( $zone );

Runs the Consistency03 Test Case <https://github.com/zonemaster/zonemaster/blob/master/docs/public/specifications/tests/Consistency-TP/consistency03.md>.

Takes a Zonemaster::Engine::Zone object.

Returns a list of Zonemaster::Engine::Logger::Entry objects.

consistency04()

my @logentry_array = consistency04( $zone );

Runs the Consistency04 Test Case <https://github.com/zonemaster/zonemaster/blob/master/docs/public/specifications/tests/Consistency-TP/consistency04.md>.

Takes a Zonemaster::Engine::Zone object.

Returns a list of Zonemaster::Engine::Logger::Entry objects.

consistency05()

my @logentry_array = consistency05( $zone );

Runs the Consistency05 Test Case <https://github.com/zonemaster/zonemaster/blob/master/docs/public/specifications/tests/Consistency-TP/consistency05.md>.

Takes a Zonemaster::Engine::Zone object.

Returns a list of Zonemaster::Engine::Logger::Entry objects.

consistency06()

my @logentry_array = consistency06( $zone );

Runs the Consistency06 Test Case <https://github.com/zonemaster/zonemaster/blob/master/docs/public/specifications/tests/Consistency-TP/consistency06.md>.

Takes a Zonemaster::Engine::Zone object.

Returns a list of Zonemaster::Engine::Logger::Entry objects.

---

and that's the whole page, bestie, six tests and all the helpers, no notes 💖

bye bye from the bottom of the page: this one's from perl v5.40.1, dated 2026-03-21, filed under Zonema...istency(3pm) — mwah, take care of her 🫶🌸