v1.6.0

1.6.0 (2024-01-16)

Features

• add Max UUID constant (#149) (c58770e)

Bug Fixes

• fix typo in version 7 uuid documentation (#153) (016b199)
• Monotonicity in UUIDv7 (#150) (a2b2b32)

v1.5.0

1.5.0 (2023-12-12)

Features

• Validate UUID without creating new UUID (#141) (9ee7366)

v1.4.0

1.4.0 (2023-10-26)

Features

• UUIDs slice type with Strings() convenience method (#133) (cd5fbbd)

Fixes

• Clarify that Parse's job is to parse but not necessarily validate strings. (Documents current behavior)

v1.3.1

1.3.1 (2023-08-18)

Bug Fixes

• Use .EqualFold() to parse urn prefixed UUIDs (#118) (574e687)

Add randomness pool mode for V4 UUID and NullUUID for SQL Scanners.

From Andrey Pechkurov:

Adds an optional randomness pool mode for Random (Version 4) UUID generation. The pool contains random bytes read from the random number generator on demand in batches. Enabling the pool may improve the UUID generation throughput significantly.

Since the pool is stored on the Go heap, this feature may be a bad fit for security sensitive applications. That's why it's implemented as an opt-in feature.

From Samuel Roth:

Added support for NullUUID

A NullUUID can be marked not valid (i.e., null) for use with JSON and the database/sql/driver.Scanner interfaces.

Add NewString()

This release introduces the NewString() function which is the equivalent of uuid.New().String().

Syntactic cleanup

There are no code changes. A missing period was add to a godoc comment and the linter was told to not complain that the results of hash.Write() are ignored (the function cannot fail)

Further error optimizations

Do not allocate memory for errors (it is only one word)

Optimize error reporting

Optimize length of time it takes to discover an input is bad by no longer using fmt.Errorf, which is quite slow. It now uses a custom error type that formats the string when the Error method is called rather than when generating the error.

Minor fixes

This release contains

• Allow concurrent, re-creatable usage #44 by trabetti was merged on Apr 16, 2019
• Fix race in NewUUID() #64 by AstolfoKawaii was merged on Jul 2, 2020
• Minor formatting and typo fixes