Zonema...ization(3pm)

✨ Zonemaster::Engine::Normalization 💖

ok so bestie, this is a Perl module from the User Contributed Perl Documentation section, and it lives in the manual as Zonema...ization(3pm) (the name got chopped, iconic of it). It's giving utility-functions-for-names-normalization realness. Let's go 🦋

---

🌸 NAME 🌸

Zonemaster::Engine::Normalization — literally just utility functions for normalizing names. That's the whole vibe. 💅

---

✨ SYNOPSIS ✨

here's how you call it, no cap:

use Zonemaster::Engine::Normalization;

my ($errors, $final_domain) = normalize_name($domain);

see? two things come back: $errors and $final_domain. group chat duo energy 🫶

---

💖 EXPORTED FUNCTIONS 💖

🎀 normalize_label($label)

normalize ONE single label from a domain name. just the one. baby steps bestie 🐣

Here's the tea on what it does:

• If the label is ASCII only, it gets down cased. simple. slay.
• If it's not ASCII only, it gets converted according to IDNA2008 instead.

ok and the actual mechanical work — downcasing of upper case non-ASCII characters, normalization to the Unicode NFC format, and conversion from U-label to A-label — is all performed by libidn2, by way of to_idn($name, ...) in Zonemaster::LDNS. not us. we're just the messenger ✨

Returns a tuple:

($errors: ArrayRef[Zonemaster::Engine::Normalization::Error], $alabel: String)

⚠️ If there are errors, the returned label will be undefined. If the method succeeded, an empty error array is returned. so like, no errors = empty array, errors = undef label. keep up 💀

🌈 trim_space($str)

Trim leading and trailing whitespace. That's it. That's the function. immaculate. 🧚

It implements the space trimming part of this normalization document:

<https://github.com/zonemaster/zonemaster/blob/master/docs/specifications/tests/RequirementsAndNormalizationOfDomainNames.md>

Returns a string. boom. 💜

👑 normalize_name($name)

Normalize a domain name. the main character of this page fr fr 🌟

It implements the normalization process — except the space trimming part (that's trim_space's job, bestie, separate queens) — as described in that same normalization document:

<https://github.com/zonemaster/zonemaster/blob/master/docs/specifications/tests/RequirementsAndNormalizationOfDomainNames.md>

Returns a tuple:

($errors: ArrayRef[Zonemaster::Engine::Normalization::Error], $name: String)

⚠️ Same deal as before: in case of errors, the returned name will be undefined. If the method succeeded, an empty error array is returned. periodt. 💅

---

🦋 SEE YOU LATER 🦋

and that's the whole page, bestie! this one's from perl v5.40.1, dated 2026-03-21, out of the User Contributed Perl Documentation collection. go normalize something gorgeous today, you absolute icon 💖✨🎀