uri_urn(3tcl)

📦
version 2.0 · 2 versions
, in debian trixie, ubuntu questing, ubuntu resolute, ubuntu stonking

💖 uri_urn — the URN glow-up page 💖

okay so bestie, you know how we've been messing with uri and it's giving so much? well this is the URN scheme edition, from the Tcl Uniform Resource Identifier Management manual (uri_urn(3tcl)), and honestly? she ate. ✨

🌸 NAME 🌸

uri_urn — URI utilities, URN scheme. that's the whole vibe. no notes. 🎀

🦋 SYNOPSIS 🦋

package require Tcl 8.5 9

package require uri::urn ?1.0.4?

uri::urn::quote url

uri::urn::unquote url

yes the ?1.0.4? is doing the most with those question marks, it's optional, we love her anyway 💅

💜 DESCRIPTION 💜

so this package is the moment. she gives you two commands to quote and unquote the disallowed characters for a url using the urn scheme, and then — icon behaviour — she registers the scheme with the package uri. 🫶

but wait, there's more (there always is). she also provides internal helpers that get used automatically by the commands uri::split and uri::join from the uri package, so they know how to handle urls using the urn scheme. you don't have to do anything, it just happens. lowkey magical. 🧚

👑 COMMANDS 👑

  • uri::urn::quote url — this one quotes the characters that the urn scheme says are disallowed in the url (per RFC 2141 sec2.2, iykyk), and hands you back the modified url as its result. disallowed characters, you are being asked to leave. 💅
  • uri::urn::unquote url — the reverse of ::uri::urn::quote, fr fr. you give her an urn url, she removes the quoting from all the disallowed characters, and returns the modified urls as her result. undoing the thing, slaying, periodt. ✨

😭 BUGS, IDEAS, FEEDBACK 😭

ngl bestie, this document — and the package it describes — will undoubtedly contain bugs and other problems. not a vibe, but we're honest here.

  • please report them in the category uri of the Tcllib Trackers: http://core.tcl.tk/tcllib/reportlist
  • also please report any ideas for enhancements you may have for either the package and/or the documentation. we want the ideas. give us the ideas. 🫶

when proposing code changes, please provide unified diffs, i.e. the output of diff -u. that's the format. that's the whole ask. 🎀

also note, and this is important: attachments are strongly preferred over inlined patches. you can make an attachment by going to the Edit form of the ticket immediately after its creation, and then using the left-most button in the secondary navigation bar. that's the one. left-most. 💖

⭐ KEYWORDS ⭐

rfc 2141, uri, url, urn

🌈 CATEGORY 🌈

Networking

and that's the whole page, bestie!! 💖 shoutout to tcllib, version 1.0.4, dated right there in the footer like a lil timestamp of destiny. go quote some disallowed characters, you absolute icon. 💅✨🎀

📦 where this page comes from