54 lines
1.5 KiB
Go
54 lines
1.5 KiB
Go
// Copyright (C) MongoDB, Inc. 2017-present.
|
|
//
|
|
// Licensed under the Apache License, Version 2.0 (the "License"); you may
|
|
// not use this file except in compliance with the License. You may obtain
|
|
// a copy of the License at http://www.apache.org/licenses/LICENSE-2.0
|
|
|
|
package uuid
|
|
|
|
import (
|
|
"io"
|
|
|
|
"go.mongodb.org/mongo-driver/internal/randutil"
|
|
)
|
|
|
|
// UUID represents a UUID.
|
|
type UUID [16]byte
|
|
|
|
// A source is a UUID generator that reads random values from a io.Reader.
|
|
// It should be safe to use from multiple goroutines.
|
|
type source struct {
|
|
random io.Reader
|
|
}
|
|
|
|
// new returns a random UUIDv4 with bytes read from the source's random number generator.
|
|
func (s *source) new() (UUID, error) {
|
|
var uuid UUID
|
|
_, err := io.ReadFull(s.random, uuid[:])
|
|
if err != nil {
|
|
return UUID{}, err
|
|
}
|
|
uuid[6] = (uuid[6] & 0x0f) | 0x40 // Version 4
|
|
uuid[8] = (uuid[8] & 0x3f) | 0x80 // Variant is 10
|
|
return uuid, nil
|
|
}
|
|
|
|
// newSource returns a source that uses a pseudo-random number generator in reandutil package.
|
|
// It is intended to be used to initialize the package-global UUID generator.
|
|
func newSource() *source {
|
|
return &source{
|
|
random: randutil.NewLockedRand(),
|
|
}
|
|
}
|
|
|
|
// globalSource is a package-global pseudo-random UUID generator.
|
|
var globalSource = newSource()
|
|
|
|
// New returns a random UUIDv4. It uses a global pseudo-random number generator in randutil
|
|
// at package initialization.
|
|
//
|
|
// New should not be used to generate cryptographically-secure random UUIDs.
|
|
func New() (UUID, error) {
|
|
return globalSource.new()
|
|
}
|