uuid(n)

📦
version 2.0 · 2 versions
, in fedora 43, fedora 44, nixos 26.05, nixpkgs unstable

💖 uuid(n) — the manual page, but make it cute 💖

okay bestie so you're reading the uuid(n) page, and honestly? it's giving "small package, huge main character energy." it lives in tcllib, it's version 1.0.9, and it's about to hand you unique IDs like it's nothing. let's get into it 🫶

✨ NAME ✨

uuid — UUID generation and comparison

like… that's the whole name. short. iconic. no notes. 💅

🌸 SYNOPSIS 🌸

package require Tcl 8.5 9

package require uuid ?1.0.9?

::uuid::uuid generate

::uuid::uuid equal id1 id2

so yeah, you need Tcl 8.5 through 9 (fr fr, that's the range), and the package itself is uuid, optionally versioned as ?1.0.9?. then there's literally only two commands. two. and they ate. 👑

💫 DESCRIPTION 💫

okay so this package is a generator of universally unique identifiers — that's UUID for short — and they're also known as globally unique identifiers, aka GUID. two names, one vibe. 🌈

and here's the tea: this implementation follows the draft specification from reference (1)… although that's actually an expired draft document. yes bestie, expired. still slaying anyway. 💀✨

🎀 COMMANDS 🎀

  • ::uuid::uuid generate — creates a type 4 uuid by MD5 hashing a number of bits of variant data, including the time and the hostname. returns the string representation of the brand-new uuid. new uuid just dropped 💅
  • ::uuid::uuid equal id1 id2 — compares two uuids and returns true if both arguments are the same uuid. basically a vibe check for IDs. 🔥

🦋 EXAMPLES 🦋

look at her go:

% uuid::uuid generate
b12dc22c-5c36-41d2-57da-e29d0ef5839c

one line in, one gorgeous hyphenated string out. no cap. 😭💖

📚 REFERENCES 📚

🙈 BUGS, IDEAS, FEEDBACK 🙈

ngl, this document — and the package it describes — will undoubtedly contain bugs and other problems. it's not a maybe, it's a fact. so if you find one, please report it in the category uuid of the Tcllib Trackers at http://core.tcl.tk/tcllib/reportlist. 🫶

also please send any ideas for enhancements you may have for either the package and/or the documentation. we want them. we're listening. 👂✨

when proposing code changes, please provide unified diffs — i.e. the output of diff -u.

and one more thing bestie, super important: attachments are strongly preferred over inlined patches. to attach something, go to the Edit form of the ticket immediately after its creation, and then use the left-most button in the secondary navigation bar. iykyk. 💅

🔑 KEYWORDS 🔑

GUID, UUID

🗂️ CATEGORY 🗂️

Hashes, checksums, and encryption

Copyright (c) 2004, Pat Thoyts <patthoyts@users.sourceforge.net>

and that's the whole page, bestie!! this was tcllib, version 1.0.9, and the manual page is uuid(n). thank you for coming to my ted talk, go generate some uuids, mwah 💜🧚🌸

📦 where this page comes from