commit | edef28d0c8acc7d3bdfaddde8ab27de602cc131b | [log] [tgz] |
---|---|---|
author | Joe Wreschnig <joe.wreschnig@gmail.com> | Wed Dec 30 20:35:21 2020 +0100 |
committer | GitHub <noreply@github.com> | Wed Dec 30 13:35:21 2020 -0600 |
tree | 31b3c19e592b1f2a127d955cdbb09c5073e4eaa7 | |
parent | 0e4e31197428a347842d152773b4cace4645ca25 [diff] |
Use a custom error type for invalid lengths, replacing `fmt.Errorf` (#69) * Add benchmarks for different kinds of invalid UUIDs Also add a test case for too-short UUIDs to ensure behavior doesn’t change. * Use a custom error type for invalid lengths, replacing `fmt.Errorf` This significantly improves the speed of failed parses due to wrong lengths. Previously the `fmt.Errorf` call dominated, making this the most expensive error and more expensive than successfully parsing: BenchmarkParse-4 29226529 36.1 ns/op BenchmarkParseBadLength-4 6923106 174 ns/op BenchmarkParseLen32Truncated-4 26641954 38.1 ns/op BenchmarkParseLen36Corrupted-4 19405598 59.5 ns/op When the formatting is not required and done on-demand, the failure per se is much faster: BenchmarkParse-4 29641700 36.3 ns/op BenchmarkParseBadLength-4 58602537 20.0 ns/op BenchmarkParseLen32Truncated-4 30664791 43.6 ns/op BenchmarkParseLen36Corrupted-4 18882410 61.9 ns/op
The uuid package generates and inspects UUIDs based on RFC 4122 and DCE 1.1: Authentication and Security Services.
This package is based on the github.com/pborman/uuid package (previously named code.google.com/p/go-uuid). It differs from these earlier packages in that a UUID is a 16 byte array rather than a byte slice. One loss due to this change is the ability to represent an invalid UUID (vs a NIL UUID).
go get github.com/google/uuid
Full go doc
style documentation for the package can be viewed online without installing this package by using the GoDoc site here: http://pkg.go.dev/github.com/google/uuid