uuidgen 🧬 – UUID Generation & Parsing for Nim

uuidgen is a comprehensive and standards-compliant UUID library for the Nim programming language. It supports generating, parsing, formatting, and inspecting UUIDs of all major versions, including newer drafts like UUIDv6, v7, and v8.

---

✨ Features

• 🆔 Full support for UUID versions 1 through 8
• 🔍 Robust parsing from multiple input formats (standard, braced, URN)
• 🧾 Conversion between UUIDs and (high, low) uint64 pairs
• 🧰 Utility functions: isZero, isMax, getVersionNum, etc.
• 🔐 Name-based UUID generation (v3 and v5) with predefined namespaces
• 🔄 String formatting and round-trip validation
• 🧪 Thoroughly tested and ready for production use

uuigen API Reference

# UUID type & exceptions
type
  Uuid* = array[0..15, byte]
  InvalidUuid* = object of ValueError

# Construction & conversion
proc initUuid*(high, low: uint64): Uuid
proc getHighLow*(id: Uuid): (high: uint64, low: uint64)

# Parsing & formatting
proc parseStr*(input: string): Uuid              # Supports 32, 36, 38 (braced), 45 (URN) length inputs
proc `$`*(id: Uuid): string                      # Formats UUID to hyphenated lowercase string

# Inspection
proc getVersionNum*(id: Uuid): int
proc getVersion*(id: Uuid): Option[UuidVersion]
proc isZero*(id: Uuid): bool
proc isMax*(id: Uuid): bool

# Generation
proc newUuidv1*(timestamp: Time, node: array[6, byte]): Uuid
proc nowUuidv1*(): Uuid
proc newUuidv3*(namespace: Uuid, name: seq[byte]): Uuid
proc newUuidv4*(): Uuid
proc newUuidv5*(namespace: Uuid, name: seq[byte]): Uuid
proc newUuidv6*(timestamp: Time, node: array[6, byte]): Uuid
proc newUuidv7*(timestamp: Time): Uuid
proc nowUuidv7*(): Uuid
proc newUuidv8*(data: array[16, byte]): Uuid

# Constants
const
  NAMESPACE_DNS*: Uuid
  NAMESPACE_URL*: Uuid
  NAMESPACE_OID*: Uuid
  NAMESPACE_X500*: Uuid

# Exceptions
type
  InvalidUuid* = object of ValueError

# Usage Example
import uuigen

let uuid = newUuidv4()
echo $uuid

---