uuid-generator

name: uuid-generator description: "Generate UUIDs/GUIDs in various formats and versions. Use when: generating database keys, API IDs, session tokens, bulk UUIDs, namespace-based deterministic UUIDs (UUID5), format conversion (hyphenated/compact/URN/uppercase), or validating UUID strings."

UUID Generator

Generate universally unique identifiers (UUIDs) in various formats for distributed systems, databases, and APIs.

CLI Usage

# Generate single UUID4 (random, default)
node scripts/uuid_generator.mjs

# Generate specific version
node scripts/uuid_generator.mjs --version 1  # time-based
node scripts/uuid_generator.mjs --version 4  # random (default)
node scripts/uuid_generator.mjs --version 5  # namespace-based

# Bulk generation
node scripts/uuid_generator.mjs --count 100
node scripts/uuid_generator.mjs --count 1000 --output uuids.txt

# Format options
node scripts/uuid_generator.mjs --format compact      # no hyphens
node scripts/uuid_generator.mjs --format urn        # urn:uuid:...
node scripts/uuid_generator.mjs --format uppercase   # uppercase hex

# Namespace UUID (UUID5 - deterministic)
node scripts/uuid_generator.mjs --namespace dns --name example.com
node scripts/uuid_generator.mjs --namespace url --name "https://foo.com/bar"

# Validate a UUID
node scripts/uuid_generator.mjs --validate "a1b2c3d4-e5f6-4789-abcd-ef0123456789"

# Export formats
node scripts/uuid_generator.mjs --count 10 --format json   # JSON array
node scripts/uuid_generator.mjs --count 10 --format csv    # CSV with header

Programmatic Usage

from uuid_generator import UUIDGenerator

gen = UUIDGenerator()

# Single UUID
uuid = gen.generate()                    # UUID4 (random)
uuid = gen.generate(version=1)            # UUID1 (time-based)
uuid = gen.generate(version=5, namespace='dns', name='example.com')  # UUID5

# Bulk generation
uuids = gen.generate_bulk(count=100)
uuids = gen.generate_bulk(count=100, version=4)

# Format output
uuid = gen.generate(format='compact')     # no hyphens
uuid = gen.generate(format='urn')          # urn:uuid:...
uuid = gen.generate(format='uppercase')   # uppercase

# Validate
gen.validate("a1b2c3d4-e5f6-4789-abcd-ef0123456789")  # True/False

Quick Reference