uuidify

uuidify-go — Fast UUID & ULID generation for Go apps

Official Go SDK for the UUIDify API.

Minimal, idiomatic Go client for generating UUIDv1/v4/v7 and ULID identifiers through UUIDify’s globally distributed API.

Install

go get github.com/ilkereroglu/uuidify-go

Usage

package main

import (
    "context"
    "fmt"
    "log"

    uuidify "github.com/ilkereroglu/uuidify-go"
)

func main() {
    client, err := uuidify.NewDefaultClient()
    if err != nil {
        log.Fatal(err)
    }

    id, err := client.UUIDv4(context.Background())
    if err != nil {
        log.Fatal(err)
    }

    fmt.Println("UUID v4:", id)
}

Examples

Concrete demos live under examples/:

• go run ./examples/uuid_v4 – fetch a single UUIDv4.
• go run ./examples/uuid_v7_batch – batch-generate v7 identifiers.
• go run ./examples/ulid – obtain a ULID. Each example uses context.Context, the default client, and the same error handling patterns you can reuse in your services.

Features

• ✅ Drop-in NewDefaultClient() with overridable base URL, HTTP client, and User-Agent.
• ⚡️ Fetch UUIDv1/v4/v7, ULID, or batch payloads with one call.
• 🧵 Context-aware HTTP requests, perfect for microservices, CLIs, and serverless workloads.
• 🎯 Typed error system (RequestError, APIError, DecodeError) for clean retries and observability.
• 🧩 Generated directly from UUIDify’s OpenAPI spec, ensuring long-term compatibility.
• 🧪 Backed by Go tooling (go test, go vet, CI) and production-friendly release workflow.

Why UUIDify

UUIDify is a latency-optimized unique identifier service built for modern Go developers. With this SDK you get:

• A highly available UUID/ULID generator distributed across regions.
• Predictable performance without maintaining your own randomness infrastructure.
• Consistent REST semantics you can test locally and promote to production seamlessly.
• OpenAPI-driven definitions to keep typed clients in sync across releases.

Service & Documentation

• Main service repository: github.com/ilkereroglu/uuidify
• API documentation & schema: api/openapi.yaml

API Reference

• Go package reference on pkg.go.dev: pkg.go.dev/github.com/ilkereroglu/uuidify-go

License

MIT License © ilkereroglu