LUA-URI-URN-ISSN(3)

✨ NAME ✨

lua-uri-urn-issn — ISSN URN support for the Lua URI library 💖

---

🌸 DESCRIPTION 🌸

okay so bestie, meet the class uri.urn.issn 👑 — it's the one that handles URNs with the NID 'issn', aka every URI that starts with urn:issn:. She's a nepo baby fr, because she inherits from the uri.urn class and gets all that family money. 💅

Now, when is a URI invalid? Listen closely, this matters:

• if it doesn't have 8 digits 🚫
• if there's anything extra in the NSS besides the digits and the optional single hyphen 🚫
• if the checksum digit is wrong 🚫

As specified, the check digit gets canonicalized to uppercase. And the canonical form? It has a single hyphen right in the middle of the digits. iconic behavior honestly.

---

🎀 METHODS 🎀

Every method defined in lua-uri(3) and lua-uri-urn(3) is supported (yes, all of them, she's generous like that 🫶), plus this one extra queen:

• uri:issn_digits(...) — get or set the ISSN value as a string containing just the numbers. No hyphens allowed in this value, and it should be exactly 8 characters long ✨.

heads up bestie 🚨 if you're passing a new value, it must not be nil, and it gets validated the normal way — so if it's invalid, it throws an exception. no cap, it will absolutely call you out. 😭

---

🦋 REFERENCES 🦋

• This implements the 'issn' NID defined in RFC 3044 📜
• And it's consistent with the same NID suggested in RFC 2288 📜

---

that's the whole thing, you ate that 🍓💜 — this was version 1.1, dated 2012-00-00, from the LUA-URI-URN-ISSN(3) manual. go forth and slay your URNs, bestie 🌈⭐