Use google/uuid to instead satori/go.uuid (#11943)
Co-authored-by: Lauris BH <lauris@nix.lv>tokarchuk/v1.17
Lunny Xiao
5 years ago
committed by
GitHub
parent
03ba974481
commit
1dd3f19ee3
@ -0,0 +1,9 @@ |
||||
language: go |
||||
|
||||
go: |
||||
- 1.4.3 |
||||
- 1.5.3 |
||||
- tip |
||||
|
||||
script: |
||||
- go test -v ./... |
||||
@ -0,0 +1,10 @@ |
||||
# How to contribute |
||||
|
||||
We definitely welcome patches and contribution to this project! |
||||
|
||||
### Legal requirements |
||||
|
||||
In order to protect both you and ourselves, you will need to sign the |
||||
[Contributor License Agreement](https://cla.developers.google.com/clas). |
||||
|
||||
You may have already signed it for other Google projects. |
||||
@ -0,0 +1,9 @@ |
||||
Paul Borman <borman@google.com> |
||||
bmatsuo |
||||
shawnps |
||||
theory |
||||
jboverfelt |
||||
dsymonds |
||||
cd1 |
||||
wallclockbuilder |
||||
dansouza |
||||
@ -0,0 +1,27 @@ |
||||
Copyright (c) 2009,2014 Google Inc. All rights reserved. |
||||
|
||||
Redistribution and use in source and binary forms, with or without |
||||
modification, are permitted provided that the following conditions are |
||||
met: |
||||
|
||||
* Redistributions of source code must retain the above copyright |
||||
notice, this list of conditions and the following disclaimer. |
||||
* Redistributions in binary form must reproduce the above |
||||
copyright notice, this list of conditions and the following disclaimer |
||||
in the documentation and/or other materials provided with the |
||||
distribution. |
||||
* Neither the name of Google Inc. nor the names of its |
||||
contributors may be used to endorse or promote products derived from |
||||
this software without specific prior written permission. |
||||
|
||||
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS |
||||
"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT |
||||
LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR |
||||
A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT |
||||
OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, |
||||
SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT |
||||
LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, |
||||
DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY |
||||
THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT |
||||
(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE |
||||
OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. |
||||
@ -0,0 +1,19 @@ |
||||
# uuid  |
||||
The uuid package generates and inspects UUIDs based on |
||||
[RFC 4122](http://tools.ietf.org/html/rfc4122) |
||||
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). |
||||
|
||||
###### Install |
||||
`go get github.com/google/uuid` |
||||
|
||||
###### Documentation |
||||
[](http://godoc.org/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://godoc.org/github.com/google/uuid |
||||
@ -0,0 +1,80 @@ |
||||
// Copyright 2016 Google Inc. All rights reserved.
|
||||
// Use of this source code is governed by a BSD-style
|
||||
// license that can be found in the LICENSE file.
|
||||
|
||||
package uuid |
||||
|
||||
import ( |
||||
"encoding/binary" |
||||
"fmt" |
||||
"os" |
||||
) |
||||
|
||||
// A Domain represents a Version 2 domain
|
||||
type Domain byte |
||||
|
||||
// Domain constants for DCE Security (Version 2) UUIDs.
|
||||
const ( |
||||
Person = Domain(0) |
||||
Group = Domain(1) |
||||
Org = Domain(2) |
||||
) |
||||
|
||||
// NewDCESecurity returns a DCE Security (Version 2) UUID.
|
||||
//
|
||||
// The domain should be one of Person, Group or Org.
|
||||
// On a POSIX system the id should be the users UID for the Person
|
||||
// domain and the users GID for the Group. The meaning of id for
|
||||
// the domain Org or on non-POSIX systems is site defined.
|
||||
//
|
||||
// For a given domain/id pair the same token may be returned for up to
|
||||
// 7 minutes and 10 seconds.
|
||||
func NewDCESecurity(domain Domain, id uint32) (UUID, error) { |
||||
uuid, err := NewUUID() |
||||
if err == nil { |
||||
uuid[6] = (uuid[6] & 0x0f) | 0x20 // Version 2
|
||||
uuid[9] = byte(domain) |
||||
binary.BigEndian.PutUint32(uuid[0:], id) |
||||
} |
||||
return uuid, err |
||||
} |
||||
|
||||
// NewDCEPerson returns a DCE Security (Version 2) UUID in the person
|
||||
// domain with the id returned by os.Getuid.
|
||||
//
|
||||
// NewDCESecurity(Person, uint32(os.Getuid()))
|
||||
func NewDCEPerson() (UUID, error) { |
||||
return NewDCESecurity(Person, uint32(os.Getuid())) |
||||
} |
||||
|
||||
// NewDCEGroup returns a DCE Security (Version 2) UUID in the group
|
||||
// domain with the id returned by os.Getgid.
|
||||
//
|
||||
// NewDCESecurity(Group, uint32(os.Getgid()))
|
||||
func NewDCEGroup() (UUID, error) { |
||||
return NewDCESecurity(Group, uint32(os.Getgid())) |
||||
} |
||||
|
||||
// Domain returns the domain for a Version 2 UUID. Domains are only defined
|
||||
// for Version 2 UUIDs.
|
||||
func (uuid UUID) Domain() Domain { |
||||
return Domain(uuid[9]) |
||||
} |
||||
|
||||
// ID returns the id for a Version 2 UUID. IDs are only defined for Version 2
|
||||
// UUIDs.
|
||||
func (uuid UUID) ID() uint32 { |
||||
return binary.BigEndian.Uint32(uuid[0:4]) |
||||
} |
||||
|
||||
func (d Domain) String() string { |
||||
switch d { |
||||
case Person: |
||||
return "Person" |
||||
case Group: |
||||
return "Group" |
||||
case Org: |
||||
return "Org" |
||||
} |
||||
return fmt.Sprintf("Domain%d", int(d)) |
||||
} |
||||
@ -0,0 +1,12 @@ |
||||
// Copyright 2016 Google Inc. All rights reserved.
|
||||
// Use of this source code is governed by a BSD-style
|
||||
// license that can be found in the LICENSE file.
|
||||
|
||||
// Package uuid generates and inspects UUIDs.
|
||||
//
|
||||
// UUIDs are based on RFC 4122 and DCE 1.1: Authentication and Security
|
||||
// Services.
|
||||
//
|
||||
// A UUID is a 16 byte (128 bit) array. UUIDs may be used as keys to
|
||||
// maps or compared directly.
|
||||
package uuid |
||||
@ -0,0 +1 @@ |
||||
module github.com/google/uuid |
||||
@ -0,0 +1,53 @@ |
||||
// Copyright 2016 Google Inc. All rights reserved.
|
||||
// Use of this source code is governed by a BSD-style
|
||||
// license that can be found in the LICENSE file.
|
||||
|
||||
package uuid |
||||
|
||||
import ( |
||||
"crypto/md5" |
||||
"crypto/sha1" |
||||
"hash" |
||||
) |
||||
|
||||
// Well known namespace IDs and UUIDs
|
||||
var ( |
||||
NameSpaceDNS = Must(Parse("6ba7b810-9dad-11d1-80b4-00c04fd430c8")) |
||||
NameSpaceURL = Must(Parse("6ba7b811-9dad-11d1-80b4-00c04fd430c8")) |
||||
NameSpaceOID = Must(Parse("6ba7b812-9dad-11d1-80b4-00c04fd430c8")) |
||||
NameSpaceX500 = Must(Parse("6ba7b814-9dad-11d1-80b4-00c04fd430c8")) |
||||
Nil UUID // empty UUID, all zeros
|
||||
) |
||||
|
||||
// NewHash returns a new UUID derived from the hash of space concatenated with
|
||||
// data generated by h. The hash should be at least 16 byte in length. The
|
||||
// first 16 bytes of the hash are used to form the UUID. The version of the
|
||||
// UUID will be the lower 4 bits of version. NewHash is used to implement
|
||||
// NewMD5 and NewSHA1.
|
||||
func NewHash(h hash.Hash, space UUID, data []byte, version int) UUID { |
||||
h.Reset() |
||||
h.Write(space[:]) |
||||
h.Write(data) |
||||
s := h.Sum(nil) |
||||
var uuid UUID |
||||
copy(uuid[:], s) |
||||
uuid[6] = (uuid[6] & 0x0f) | uint8((version&0xf)<<4) |
||||
uuid[8] = (uuid[8] & 0x3f) | 0x80 // RFC 4122 variant
|
||||
return uuid |
||||
} |
||||
|
||||
// NewMD5 returns a new MD5 (Version 3) UUID based on the
|
||||
// supplied name space and data. It is the same as calling:
|
||||
//
|
||||
// NewHash(md5.New(), space, data, 3)
|
||||
func NewMD5(space UUID, data []byte) UUID { |
||||
return NewHash(md5.New(), space, data, 3) |
||||
} |
||||
|
||||
// NewSHA1 returns a new SHA1 (Version 5) UUID based on the
|
||||
// supplied name space and data. It is the same as calling:
|
||||
//
|
||||
// NewHash(sha1.New(), space, data, 5)
|
||||
func NewSHA1(space UUID, data []byte) UUID { |
||||
return NewHash(sha1.New(), space, data, 5) |
||||
} |
||||
@ -0,0 +1,37 @@ |
||||
// Copyright 2016 Google Inc. All rights reserved.
|
||||
// Use of this source code is governed by a BSD-style
|
||||
// license that can be found in the LICENSE file.
|
||||
|
||||
package uuid |
||||
|
||||
import "fmt" |
||||
|
||||
// MarshalText implements encoding.TextMarshaler.
|
||||
func (uuid UUID) MarshalText() ([]byte, error) { |
||||
var js [36]byte |
||||
encodeHex(js[:], uuid) |
||||
return js[:], nil |
||||
} |
||||
|
||||
// UnmarshalText implements encoding.TextUnmarshaler.
|
||||
func (uuid *UUID) UnmarshalText(data []byte) error { |
||||
id, err := ParseBytes(data) |
||||
if err == nil { |
||||
*uuid = id |
||||
} |
||||
return err |
||||
} |
||||
|
||||
// MarshalBinary implements encoding.BinaryMarshaler.
|
||||
func (uuid UUID) MarshalBinary() ([]byte, error) { |
||||
return uuid[:], nil |
||||
} |
||||
|
||||
// UnmarshalBinary implements encoding.BinaryUnmarshaler.
|
||||
func (uuid *UUID) UnmarshalBinary(data []byte) error { |
||||
if len(data) != 16 { |
||||
return fmt.Errorf("invalid UUID (got %d bytes)", len(data)) |
||||
} |
||||
copy(uuid[:], data) |
||||
return nil |
||||
} |
||||
@ -0,0 +1,90 @@ |
||||
// Copyright 2016 Google Inc. All rights reserved.
|
||||
// Use of this source code is governed by a BSD-style
|
||||
// license that can be found in the LICENSE file.
|
||||
|
||||
package uuid |
||||
|
||||
import ( |
||||
"sync" |
||||
) |
||||
|
||||
var ( |
||||
nodeMu sync.Mutex |
||||
ifname string // name of interface being used
|
||||
nodeID [6]byte // hardware for version 1 UUIDs
|
||||
zeroID [6]byte // nodeID with only 0's
|
||||
) |
||||
|
||||
// NodeInterface returns the name of the interface from which the NodeID was
|
||||
// derived. The interface "user" is returned if the NodeID was set by
|
||||
// SetNodeID.
|
||||
func NodeInterface() string { |
||||
defer nodeMu.Unlock() |
||||
nodeMu.Lock() |
||||
return ifname |
||||
} |
||||
|
||||
// SetNodeInterface selects the hardware address to be used for Version 1 UUIDs.
|
||||
// If name is "" then the first usable interface found will be used or a random
|
||||
// Node ID will be generated. If a named interface cannot be found then false
|
||||
// is returned.
|
||||
//
|
||||
// SetNodeInterface never fails when name is "".
|
||||
func SetNodeInterface(name string) bool { |
||||
defer nodeMu.Unlock() |
||||
nodeMu.Lock() |
||||
return setNodeInterface(name) |
||||
} |
||||
|
||||
func setNodeInterface(name string) bool { |
||||
iname, addr := getHardwareInterface(name) // null implementation for js
|
||||
if iname != "" && addr != nil { |
||||
ifname = iname |
||||
copy(nodeID[:], addr) |
||||
return true |
||||
} |
||||
|
||||
// We found no interfaces with a valid hardware address. If name
|
||||
// does not specify a specific interface generate a random Node ID
|
||||
// (section 4.1.6)
|
||||
if name == "" { |
||||
ifname = "random" |
||||
randomBits(nodeID[:]) |
||||
return true |
||||
} |
||||
return false |
||||
} |
||||
|
||||
// NodeID returns a slice of a copy of the current Node ID, setting the Node ID
|
||||
// if not already set.
|
||||
func NodeID() []byte { |
||||
defer nodeMu.Unlock() |
||||
nodeMu.Lock() |
||||
if nodeID == zeroID { |
||||
setNodeInterface("") |
||||
} |
||||
nid := nodeID |
||||
return nid[:] |
||||
} |
||||
|
||||
// SetNodeID sets the Node ID to be used for Version 1 UUIDs. The first 6 bytes
|
||||
// of id are used. If id is less than 6 bytes then false is returned and the
|
||||
// Node ID is not set.
|
||||
func SetNodeID(id []byte) bool { |
||||
if len(id) < 6 { |
||||
return false |
||||
} |
||||
defer nodeMu.Unlock() |
||||
nodeMu.Lock() |
||||
copy(nodeID[:], id) |
||||
ifname = "user" |
||||
return true |
||||
} |
||||
|
||||
// NodeID returns the 6 byte node id encoded in uuid. It returns nil if uuid is
|
||||
// not valid. The NodeID is only well defined for version 1 and 2 UUIDs.
|
||||
func (uuid UUID) NodeID() []byte { |
||||
var node [6]byte |
||||
copy(node[:], uuid[10:]) |
||||
return node[:] |
||||
} |
||||
@ -0,0 +1,12 @@ |
||||
// Copyright 2017 Google Inc. All rights reserved.
|
||||
// Use of this source code is governed by a BSD-style
|
||||
// license that can be found in the LICENSE file.
|
||||
|
||||
// +build js
|
||||
|
||||
package uuid |
||||
|
||||
// getHardwareInterface returns nil values for the JS version of the code.
|
||||
// This remvoves the "net" dependency, because it is not used in the browser.
|
||||
// Using the "net" library inflates the size of the transpiled JS code by 673k bytes.
|
||||
func getHardwareInterface(name string) (string, []byte) { return "", nil } |
||||
@ -0,0 +1,33 @@ |
||||
// Copyright 2017 Google Inc. All rights reserved.
|
||||
// Use of this source code is governed by a BSD-style
|
||||
// license that can be found in the LICENSE file.
|
||||
|
||||
// +build !js
|
||||
|
||||
package uuid |
||||
|
||||
import "net" |
||||
|
||||
var interfaces []net.Interface // cached list of interfaces
|
||||
|
||||
// getHardwareInterface returns the name and hardware address of interface name.
|
||||
// If name is "" then the name and hardware address of one of the system's
|
||||
// interfaces is returned. If no interfaces are found (name does not exist or
|
||||
// there are no interfaces) then "", nil is returned.
|
||||
//
|
||||
// Only addresses of at least 6 bytes are returned.
|
||||
func getHardwareInterface(name string) (string, []byte) { |
||||
if interfaces == nil { |
||||
var err error |
||||
interfaces, err = net.Interfaces() |
||||
if err != nil { |
||||
return "", nil |
||||
} |
||||
} |
||||
for _, ifs := range interfaces { |
||||
if len(ifs.HardwareAddr) >= 6 && (name == "" || name == ifs.Name) { |
||||
return ifs.Name, ifs.HardwareAddr |
||||
} |
||||
} |
||||
return "", nil |
||||
} |
||||
@ -0,0 +1,59 @@ |
||||
// Copyright 2016 Google Inc. All rights reserved.
|
||||
// Use of this source code is governed by a BSD-style
|
||||
// license that can be found in the LICENSE file.
|
||||
|
||||
package uuid |
||||
|
||||
import ( |
||||
"database/sql/driver" |
||||
"fmt" |
||||
) |
||||
|
||||
// Scan implements sql.Scanner so UUIDs can be read from databases transparently
|
||||
// Currently, database types that map to string and []byte are supported. Please
|
||||
// consult database-specific driver documentation for matching types.
|
||||
func (uuid *UUID) Scan(src interface{}) error { |
||||
switch src := src.(type) { |
||||
case nil: |
||||
return nil |
||||
|
||||
case string: |
||||
// if an empty UUID comes from a table, we return a null UUID
|
||||
if src == "" { |
||||
return nil |
||||
} |
||||
|
||||
// see Parse for required string format
|
||||
u, err := Parse(src) |
||||
if err != nil { |
||||
return fmt.Errorf("Scan: %v", err) |
||||
} |
||||
|
||||
*uuid = u |
||||
|
||||
case []byte: |
||||
// if an empty UUID comes from a table, we return a null UUID
|
||||
if len(src) == 0 { |
||||
return nil |
||||
} |
||||
|
||||
// assumes a simple slice of bytes if 16 bytes
|
||||
// otherwise attempts to parse
|
||||
if len(src) != 16 { |
||||
return uuid.Scan(string(src)) |
||||
} |
||||
copy((*uuid)[:], src) |
||||
|
||||
default: |
||||
return fmt.Errorf("Scan: unable to scan type %T into UUID", src) |
||||
} |
||||
|
||||
return nil |
||||
} |
||||
|
||||
// Value implements sql.Valuer so that UUIDs can be written to databases
|
||||
// transparently. Currently, UUIDs map to strings. Please consult
|
||||
// database-specific driver documentation for matching types.
|
||||
func (uuid UUID) Value() (driver.Value, error) { |
||||
return uuid.String(), nil |
||||
} |
||||
@ -0,0 +1,123 @@ |
||||
// Copyright 2016 Google Inc. All rights reserved.
|
||||
// Use of this source code is governed by a BSD-style
|
||||
// license that can be found in the LICENSE file.
|
||||
|
||||
package uuid |
||||
|
||||
import ( |
||||
"encoding/binary" |
||||
"sync" |
||||
"time" |
||||
) |
||||
|
||||
// A Time represents a time as the number of 100's of nanoseconds since 15 Oct
|
||||
// 1582.
|
||||
type Time int64 |
||||
|
||||
const ( |
||||
lillian = 2299160 // Julian day of 15 Oct 1582
|
||||
unix = 2440587 // Julian day of 1 Jan 1970
|
||||
epoch = unix - lillian // Days between epochs
|
||||
g1582 = epoch * 86400 // seconds between epochs
|
||||
g1582ns100 = g1582 * 10000000 // 100s of a nanoseconds between epochs
|
||||
) |
||||
|
||||
var ( |
||||
timeMu sync.Mutex |
||||
lasttime uint64 // last time we returned
|
||||
clockSeq uint16 // clock sequence for this run
|
||||
|
||||
timeNow = time.Now // for testing
|
||||
) |
||||
|
||||
// UnixTime converts t the number of seconds and nanoseconds using the Unix
|
||||
// epoch of 1 Jan 1970.
|
||||
func (t Time) UnixTime() (sec, nsec int64) { |
||||
sec = int64(t - g1582ns100) |
||||
nsec = (sec % 10000000) * 100 |
||||
sec /= 10000000 |
||||
return sec, nsec |
||||
} |
||||
|
||||
// GetTime returns the current Time (100s of nanoseconds since 15 Oct 1582) and
|
||||
// clock sequence as well as adjusting the clock sequence as needed. An error
|
||||
// is returned if the current time cannot be determined.
|
||||
func GetTime() (Time, uint16, error) { |
||||
defer timeMu.Unlock() |
||||
timeMu.Lock() |
||||
return getTime() |
||||
} |
||||
|
||||
func getTime() (Time, uint16, error) { |
||||
t := timeNow() |
||||
|
||||
// If we don't have a clock sequence already, set one.
|
||||
if clockSeq == 0 { |
||||
setClockSequence(-1) |
||||
} |
||||
now := uint64(t.UnixNano()/100) + g1582ns100 |
||||
|
||||
// If time has gone backwards with this clock sequence then we
|
||||
// increment the clock sequence
|
||||
if now <= lasttime { |
||||
clockSeq = ((clockSeq + 1) & 0x3fff) | 0x8000 |
||||
} |
||||
lasttime = now |
||||
return Time(now), clockSeq, nil |
||||
} |
||||
|
||||
// ClockSequence returns the current clock sequence, generating one if not
|
||||
// already set. The clock sequence is only used for Version 1 UUIDs.
|
||||
//
|
||||
// The uuid package does not use global static storage for the clock sequence or
|
||||
// the last time a UUID was generated. Unless SetClockSequence is used, a new
|
||||
// random clock sequence is generated the first time a clock sequence is
|
||||
// requested by ClockSequence, GetTime, or NewUUID. (section 4.2.1.1)
|
||||
func ClockSequence() int { |
||||
defer timeMu.Unlock() |
||||
timeMu.Lock() |
||||
return clockSequence() |
||||
} |
||||
|
||||
func clockSequence() int { |
||||
if clockSeq == 0 { |
||||
setClockSequence(-1) |
||||
} |
||||
return int(clockSeq & 0x3fff) |
||||
} |
||||
|
||||
// SetClockSequence sets the clock sequence to the lower 14 bits of seq. Setting to
|
||||
// -1 causes a new sequence to be generated.
|
||||
func SetClockSequence(seq int) { |
||||
defer timeMu.Unlock() |
||||
timeMu.Lock() |
||||
setClockSequence(seq) |
||||
} |
||||
|
||||
func setClockSequence(seq int) { |
||||
if seq == -1 { |
||||
var b [2]byte |
||||
randomBits(b[:]) // clock sequence
|
||||
seq = int(b[0])<<8 | int(b[1]) |
||||
} |
||||
oldSeq := clockSeq |
||||
clockSeq = uint16(seq&0x3fff) | 0x8000 // Set our variant
|
||||
if oldSeq != clockSeq { |
||||
lasttime = 0 |
||||
} |
||||
} |
||||
|
||||
// Time returns the time in 100s of nanoseconds since 15 Oct 1582 encoded in
|
||||
// uuid. The time is only defined for version 1 and 2 UUIDs.
|
||||
func (uuid UUID) Time() Time { |
||||
time := int64(binary.BigEndian.Uint32(uuid[0:4])) |
||||
time |= int64(binary.BigEndian.Uint16(uuid[4:6])) << 32 |
||||
time |= int64(binary.BigEndian.Uint16(uuid[6:8])&0xfff) << 48 |
||||
return Time(time) |
||||
} |
||||
|
||||
// ClockSequence returns the clock sequence encoded in uuid.
|
||||
// The clock sequence is only well defined for version 1 and 2 UUIDs.
|
||||
func (uuid UUID) ClockSequence() int { |
||||
return int(binary.BigEndian.Uint16(uuid[8:10])) & 0x3fff |
||||
} |
||||
@ -0,0 +1,43 @@ |
||||
// Copyright 2016 Google Inc. All rights reserved.
|
||||
// Use of this source code is governed by a BSD-style
|
||||
// license that can be found in the LICENSE file.
|
||||
|
||||
package uuid |
||||
|
||||
import ( |
||||
"io" |
||||
) |
||||
|
||||
// randomBits completely fills slice b with random data.
|
||||
func randomBits(b []byte) { |
||||
if _, err := io.ReadFull(rander, b); err != nil { |
||||
panic(err.Error()) // rand should never fail
|
||||
} |
||||
} |
||||
|
||||
// xvalues returns the value of a byte as a hexadecimal digit or 255.
|
||||
var xvalues = [256]byte{ |
||||
255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, |
||||
255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, |
||||
255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, |
||||
0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 255, 255, 255, 255, 255, 255, |
||||
255, 10, 11, 12, 13, 14, 15, 255, 255, 255, 255, 255, 255, 255, 255, 255, |
||||
255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, |
||||
255, 10, 11, 12, 13, 14, 15, 255, 255, 255, 255, 255, 255, 255, 255, 255, |
||||
255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, |
||||
255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, |
||||
255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, |
||||
255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, |
||||
255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, |
||||
255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, |
||||
255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, |
||||
255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, |
||||
255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, |
||||
} |
||||
|
||||
// xtob converts hex characters x1 and x2 into a byte.
|
||||
func xtob(x1, x2 byte) (byte, bool) { |
||||
b1 := xvalues[x1] |
||||
b2 := xvalues[x2] |
||||
return (b1 << 4) | b2, b1 != 255 && b2 != 255 |
||||
} |
||||
@ -0,0 +1,245 @@ |
||||
// Copyright 2018 Google Inc. All rights reserved.
|
||||
// Use of this source code is governed by a BSD-style
|
||||
// license that can be found in the LICENSE file.
|
||||
|
||||
package uuid |
||||
|
||||
import ( |
||||
"bytes" |
||||
"crypto/rand" |
||||
"encoding/hex" |
||||
"errors" |
||||
"fmt" |
||||
"io" |
||||
"strings" |
||||
) |
||||
|
||||
// A UUID is a 128 bit (16 byte) Universal Unique IDentifier as defined in RFC
|
||||
// 4122.
|
||||
type UUID [16]byte |
||||
|
||||
// A Version represents a UUID's version.
|
||||
type Version byte |
||||
|
||||
// A Variant represents a UUID's variant.
|
||||
type Variant byte |
||||
|
||||
// Constants returned by Variant.
|
||||
const ( |
||||
Invalid = Variant(iota) // Invalid UUID
|
||||
RFC4122 // The variant specified in RFC4122
|
||||
Reserved // Reserved, NCS backward compatibility.
|
||||
Microsoft // Reserved, Microsoft Corporation backward compatibility.
|
||||
Future // Reserved for future definition.
|
||||
) |
||||
|
||||
var rander = rand.Reader // random function
|
||||
|
||||
// Parse decodes s into a UUID or returns an error. Both the standard UUID
|
||||
// forms of xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx and
|
||||
// urn:uuid:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx are decoded as well as the
|
||||
// Microsoft encoding {xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx} and the raw hex
|
||||
// encoding: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx.
|
||||
func Parse(s string) (UUID, error) { |
||||
var uuid UUID |
||||
switch len(s) { |
||||
// xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
|
||||
case 36: |
||||
|
||||
// urn:uuid:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
|
||||
case 36 + 9: |
||||
if strings.ToLower(s[:9]) != "urn:uuid:" { |
||||
return uuid, fmt.Errorf("invalid urn prefix: %q", s[:9]) |
||||
} |
||||
s = s[9:] |
||||
|
||||
// {xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx}
|
||||
case 36 + 2: |
||||
s = s[1:] |
||||
|
||||
// xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
|
||||
case 32: |
||||
var ok bool |
||||
for i := range uuid { |
||||
uuid[i], ok = xtob(s[i*2], s[i*2+1]) |
||||
if !ok { |
||||
return uuid, errors.New("invalid UUID format") |
||||
} |
||||
} |
||||
return uuid, nil |
||||
default: |
||||
return uuid, fmt.Errorf("invalid UUID length: %d", len(s)) |
||||
} |
||||
// s is now at least 36 bytes long
|
||||
// it must be of the form xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
|
||||
if s[8] != '-' || s[13] != '-' || s[18] != '-' || s[23] != '-' { |
||||
return uuid, errors.New("invalid UUID format") |
||||
} |
||||
for i, x := range [16]int{ |
||||
0, 2, 4, 6, |
||||
9, 11, |
||||
14, 16, |
||||
19, 21, |
||||
24, 26, 28, 30, 32, 34} { |
||||
v, ok := xtob(s[x], s[x+1]) |
||||
if !ok { |
||||
return uuid, errors.New("invalid UUID format") |
||||
} |
||||
uuid[i] = v |
||||
} |
||||
return uuid, nil |
||||
} |
||||
|
||||
// ParseBytes is like Parse, except it parses a byte slice instead of a string.
|
||||
func ParseBytes(b []byte) (UUID, error) { |
||||
var uuid UUID |
||||
switch len(b) { |
||||
case 36: // xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
|
||||
case 36 + 9: // urn:uuid:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
|
||||
if !bytes.Equal(bytes.ToLower(b[:9]), []byte("urn:uuid:")) { |
||||
return uuid, fmt.Errorf("invalid urn prefix: %q", b[:9]) |
||||
} |
||||
b = b[9:] |
||||
case 36 + 2: // {xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx}
|
||||
b = b[1:] |
||||
case 32: // xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
|
||||
var ok bool |
||||
for i := 0; i < 32; i += 2 { |
||||
uuid[i/2], ok = xtob(b[i], b[i+1]) |
||||
if !ok { |
||||
return uuid, errors.New("invalid UUID format") |
||||
} |
||||
} |
||||
return uuid, nil |
||||
default: |
||||
return uuid, fmt.Errorf("invalid UUID length: %d", len(b)) |
||||
} |
||||
// s is now at least 36 bytes long
|
||||
// it must be of the form xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
|
||||
if b[8] != '-' || b[13] != '-' || b[18] != '-' || b[23] != '-' { |
||||
return uuid, errors.New("invalid UUID format") |
||||
} |
||||
for i, x := range [16]int{ |
||||
0, 2, 4, 6, |
||||
9, 11, |
||||
14, 16, |
||||
19, 21, |
||||
24, 26, 28, 30, 32, 34} { |
||||
v, ok := xtob(b[x], b[x+1]) |
||||
if !ok { |
||||
return uuid, errors.New("invalid UUID format") |
||||
} |
||||
uuid[i] = v |
||||
} |
||||
return uuid, nil |
||||
} |
||||
|
||||
// MustParse is like Parse but panics if the string cannot be parsed.
|
||||
// It simplifies safe initialization of global variables holding compiled UUIDs.
|
||||
func MustParse(s string) UUID { |
||||
uuid, err := Parse(s) |
||||
if err != nil { |
||||
panic(`uuid: Parse(` + s + `): ` + err.Error()) |
||||
} |
||||
return uuid |
||||
} |
||||
|
||||
// FromBytes creates a new UUID from a byte slice. Returns an error if the slice
|
||||
// does not have a length of 16. The bytes are copied from the slice.
|
||||
func FromBytes(b []byte) (uuid UUID, err error) { |
||||
err = uuid.UnmarshalBinary(b) |
||||
return uuid, err |
||||
} |
||||
|
||||
// Must returns uuid if err is nil and panics otherwise.
|
||||
func Must(uuid UUID, err error) UUID { |
||||
if err != nil { |
||||
panic(err) |
||||
} |
||||
return uuid |
||||
} |
||||
|
||||
// String returns the string form of uuid, xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
|
||||
// , or "" if uuid is invalid.
|
||||
func (uuid UUID) String() string { |
||||
var buf [36]byte |
||||
encodeHex(buf[:], uuid) |
||||
return string(buf[:]) |
||||
} |
||||
|
||||
// URN returns the RFC 2141 URN form of uuid,
|
||||
// urn:uuid:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx, or "" if uuid is invalid.
|
||||
func (uuid UUID) URN() string { |
||||
var buf [36 + 9]byte |
||||
copy(buf[:], "urn:uuid:") |
||||
encodeHex(buf[9:], uuid) |
||||
return string(buf[:]) |
||||
} |
||||
|
||||
func encodeHex(dst []byte, uuid UUID) { |
||||
hex.Encode(dst, uuid[:4]) |
||||
dst[8] = '-' |
||||
hex.Encode(dst[9:13], uuid[4:6]) |
||||
dst[13] = '-' |
||||
hex.Encode(dst[14:18], uuid[6:8]) |
||||
dst[18] = '-' |
||||
hex.Encode(dst[19:23], uuid[8:10]) |
||||
dst[23] = '-' |
||||
hex.Encode(dst[24:], uuid[10:]) |
||||
} |
||||
|
||||
// Variant returns the variant encoded in uuid.
|
||||
func (uuid UUID) Variant() Variant { |
||||
switch { |
||||
case (uuid[8] & 0xc0) == 0x80: |
||||
return RFC4122 |
||||
case (uuid[8] & 0xe0) == 0xc0: |
||||
return Microsoft |
||||
case (uuid[8] & 0xe0) == 0xe0: |
||||
return Future |
||||
default: |
||||
return Reserved |
||||
} |
||||
} |
||||
|
||||
// Version returns the version of uuid.
|
||||
func (uuid UUID) Version() Version { |
||||
return Version(uuid[6] >> 4) |
||||
} |
||||
|
||||
func (v Version) String() string { |
||||
if v > 15 { |
||||
return fmt.Sprintf("BAD_VERSION_%d", v) |
||||
} |
||||
return fmt.Sprintf("VERSION_%d", v) |
||||
} |
||||
|
||||
func (v Variant) String() string { |
||||
switch v { |
||||
case RFC4122: |
||||
return "RFC4122" |
||||
case Reserved: |
||||
return "Reserved" |
||||
case Microsoft: |
||||
return "Microsoft" |
||||
case Future: |
||||
return "Future" |
||||
case Invalid: |
||||
return "Invalid" |
||||
} |
||||
return fmt.Sprintf("BadVariant%d", int(v)) |
||||
} |
||||
|
||||
// SetRand sets the random number generator to r, which implements io.Reader.
|
||||
// If r.Read returns an error when the package requests random data then
|
||||
// a panic will be issued.
|
||||
//
|
||||
// Calling SetRand with nil sets the random number generator to the default
|
||||
// generator.
|
||||
func SetRand(r io.Reader) { |
||||
if r == nil { |
||||
rander = rand.Reader |
||||
return |
||||
} |
||||
rander = r |
||||
} |
||||
@ -0,0 +1,44 @@ |
||||
// Copyright 2016 Google Inc. All rights reserved.
|
||||
// Use of this source code is governed by a BSD-style
|
||||
// license that can be found in the LICENSE file.
|
||||
|
||||
package uuid |
||||
|
||||
import ( |
||||
"encoding/binary" |
||||
) |
||||
|
||||
// NewUUID returns a Version 1 UUID based on the current NodeID and clock
|
||||
// sequence, and the current time. If the NodeID has not been set by SetNodeID
|
||||
// or SetNodeInterface then it will be set automatically. If the NodeID cannot
|
||||
// be set NewUUID returns nil. If clock sequence has not been set by
|
||||
// SetClockSequence then it will be set automatically. If GetTime fails to
|
||||
// return the current NewUUID returns nil and an error.
|
||||
//
|
||||
// In most cases, New should be used.
|
||||
func NewUUID() (UUID, error) { |
||||
nodeMu.Lock() |
||||
if nodeID == zeroID { |
||||
setNodeInterface("") |
||||
} |
||||
nodeMu.Unlock() |
||||
|
||||
var uuid UUID |
||||
now, seq, err := GetTime() |
||||
if err != nil { |
||||
return uuid, err |
||||
} |
||||
|
||||
timeLow := uint32(now & 0xffffffff) |
||||
timeMid := uint16((now >> 32) & 0xffff) |
||||
timeHi := uint16((now >> 48) & 0x0fff) |
||||
timeHi |= 0x1000 // Version 1
|
||||
|
||||
binary.BigEndian.PutUint32(uuid[0:], timeLow) |
||||
binary.BigEndian.PutUint16(uuid[4:], timeMid) |
||||
binary.BigEndian.PutUint16(uuid[6:], timeHi) |
||||
binary.BigEndian.PutUint16(uuid[8:], seq) |
||||
copy(uuid[10:], nodeID[:]) |
||||
|
||||
return uuid, nil |
||||
} |
||||
@ -0,0 +1,38 @@ |
||||
// Copyright 2016 Google Inc. All rights reserved.
|
||||
// Use of this source code is governed by a BSD-style
|
||||
// license that can be found in the LICENSE file.
|
||||
|
||||
package uuid |
||||
|
||||
import "io" |
||||
|
||||
// New creates a new random UUID or panics. New is equivalent to
|
||||
// the expression
|
||||
//
|
||||
// uuid.Must(uuid.NewRandom())
|
||||
func New() UUID { |
||||
return Must(NewRandom()) |
||||
} |
||||
|
||||
// NewRandom returns a Random (Version 4) UUID.
|
||||
//
|
||||
// The strength of the UUIDs is based on the strength of the crypto/rand
|
||||
// package.
|
||||
//
|
||||
// A note about uniqueness derived from the UUID Wikipedia entry:
|
||||
//
|
||||
// Randomly generated UUIDs have 122 random bits. One's annual risk of being
|
||||
// hit by a meteorite is estimated to be one chance in 17 billion, that
|
||||
// means the probability is about 0.00000000006 (6 × 10−11),
|
||||
// equivalent to the odds of creating a few tens of trillions of UUIDs in a
|
||||
// year and having one duplicate.
|
||||
func NewRandom() (UUID, error) { |
||||
var uuid UUID |
||||
_, err := io.ReadFull(rander, uuid[:]) |
||||
if err != nil { |
||||
return Nil, err |
||||
} |
||||
uuid[6] = (uuid[6] & 0x0f) | 0x40 // Version 4
|
||||
uuid[8] = (uuid[8] & 0x3f) | 0x80 // Variant is 10
|
||||
return uuid, nil |
||||
} |
||||
@ -1,23 +0,0 @@ |
||||
language: go |
||||
sudo: false |
||||
go: |
||||
- 1.2 |
||||
- 1.3 |
||||
- 1.4 |
||||
- 1.5 |
||||
- 1.6 |
||||
- 1.7 |
||||
- 1.8 |
||||
- 1.9 |
||||
- tip |
||||
matrix: |
||||
allow_failures: |
||||
- go: tip |
||||
fast_finish: true |
||||
before_install: |
||||
- go get github.com/mattn/goveralls |
||||
- go get golang.org/x/tools/cmd/cover |
||||
script: |
||||
- $HOME/gopath/bin/goveralls -service=travis-ci |
||||
notifications: |
||||
email: false |
||||
@ -1,20 +0,0 @@ |
||||
Copyright (C) 2013-2018 by Maxim Bublis <b@codemonkey.ru> |
||||
|
||||
Permission is hereby granted, free of charge, to any person obtaining |
||||
a copy of this software and associated documentation files (the |
||||
"Software"), to deal in the Software without restriction, including |
||||
without limitation the rights to use, copy, modify, merge, publish, |
||||
distribute, sublicense, and/or sell copies of the Software, and to |
||||
permit persons to whom the Software is furnished to do so, subject to |
||||
the following conditions: |
||||
|
||||
The above copyright notice and this permission notice shall be |
||||
included in all copies or substantial portions of the Software. |
||||
|
||||
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, |
||||
EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF |
||||
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND |
||||
NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE |
||||
LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION |
||||
OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION |
||||
WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. |
||||
@ -1,65 +0,0 @@ |
||||
# UUID package for Go language |
||||
|
||||
[](https://travis-ci.org/satori/go.uuid) |
||||
[](https://coveralls.io/github/satori/go.uuid) |
||||
[](http://godoc.org/github.com/satori/go.uuid) |
||||
|
||||
This package provides pure Go implementation of Universally Unique Identifier (UUID). Supported both creation and parsing of UUIDs. |
||||
|
||||
With 100% test coverage and benchmarks out of box. |
||||
|
||||
Supported versions: |
||||
* Version 1, based on timestamp and MAC address (RFC 4122) |
||||
* Version 2, based on timestamp, MAC address and POSIX UID/GID (DCE 1.1) |
||||
* Version 3, based on MD5 hashing (RFC 4122) |
||||
* Version 4, based on random numbers (RFC 4122) |
||||
* Version 5, based on SHA-1 hashing (RFC 4122) |
||||
|
||||
## Installation |
||||
|
||||
Use the `go` command: |
||||
|
||||
$ go get github.com/satori/go.uuid |
||||
|
||||
## Requirements |
||||
|
||||
UUID package requires Go >= 1.2. |
||||
|
||||
## Example |
||||
|
||||
```go |
||||
package main |
||||
|
||||
import ( |
||||
"fmt" |
||||
"github.com/satori/go.uuid" |
||||
) |
||||
|
||||
func main() { |
||||
// Creating UUID Version 4 |
||||
u1 := uuid.NewV4() |
||||
fmt.Printf("UUIDv4: %s\n", u1) |
||||
|
||||
// Parsing UUID from string input |
||||
u2, err := uuid.FromString("6ba7b810-9dad-11d1-80b4-00c04fd430c8") |
||||
if err != nil { |
||||
fmt.Printf("Something gone wrong: %s", err) |
||||
} |
||||
fmt.Printf("Successfully parsed: %s", u2) |
||||
} |
||||
``` |
||||
|
||||
## Documentation |
||||
|
||||
[Documentation](http://godoc.org/github.com/satori/go.uuid) is hosted at GoDoc project. |
||||
|
||||
## Links |
||||
* [RFC 4122](http://tools.ietf.org/html/rfc4122) |
||||
* [DCE 1.1: Authentication and Security Services](http://pubs.opengroup.org/onlinepubs/9696989899/chap5.htm#tagcjh_08_02_01_01) |
||||
|
||||
## Copyright |
||||
|
||||
Copyright (C) 2013-2018 by Maxim Bublis <b@codemonkey.ru>. |
||||
|
||||
UUID package released under MIT License. |
||||
See [LICENSE](https://github.com/satori/go.uuid/blob/master/LICENSE) for details. |
||||
@ -1,206 +0,0 @@ |
||||
// Copyright (C) 2013-2018 by Maxim Bublis <b@codemonkey.ru>
|
||||
//
|
||||
// Permission is hereby granted, free of charge, to any person obtaining
|
||||
// a copy of this software and associated documentation files (the
|
||||
// "Software"), to deal in the Software without restriction, including
|
||||
// without limitation the rights to use, copy, modify, merge, publish,
|
||||
// distribute, sublicense, and/or sell copies of the Software, and to
|
||||
// permit persons to whom the Software is furnished to do so, subject to
|
||||
// the following conditions:
|
||||
//
|
||||
// The above copyright notice and this permission notice shall be
|
||||
// included in all copies or substantial portions of the Software.
|
||||
//
|
||||
// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
|
||||
// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
|
||||
// MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
|
||||
// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
|
||||
// LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
|
||||
// OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
|
||||
// WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
|
||||
|
||||
package uuid |
||||
|
||||
import ( |
||||
"bytes" |
||||
"encoding/hex" |
||||
"fmt" |
||||
) |
||||
|
||||
// FromBytes returns UUID converted from raw byte slice input.
|
||||
// It will return error if the slice isn't 16 bytes long.
|
||||
func FromBytes(input []byte) (u UUID, err error) { |
||||
err = u.UnmarshalBinary(input) |
||||
return |
||||
} |
||||
|
||||
// FromBytesOrNil returns UUID converted from raw byte slice input.
|
||||
// Same behavior as FromBytes, but returns a Nil UUID on error.
|
||||
func FromBytesOrNil(input []byte) UUID { |
||||
uuid, err := FromBytes(input) |
||||
if err != nil { |
||||
return Nil |
||||
} |
||||
return uuid |
||||
} |
||||
|
||||
// FromString returns UUID parsed from string input.
|
||||
// Input is expected in a form accepted by UnmarshalText.
|
||||
func FromString(input string) (u UUID, err error) { |
||||
err = u.UnmarshalText([]byte(input)) |
||||
return |
||||
} |
||||
|
||||
// FromStringOrNil returns UUID parsed from string input.
|
||||
// Same behavior as FromString, but returns a Nil UUID on error.
|
||||
func FromStringOrNil(input string) UUID { |
||||
uuid, err := FromString(input) |
||||
if err != nil { |
||||
return Nil |
||||
} |
||||
return uuid |
||||
} |
||||
|
||||
// MarshalText implements the encoding.TextMarshaler interface.
|
||||
// The encoding is the same as returned by String.
|
||||
func (u UUID) MarshalText() (text []byte, err error) { |
||||
text = []byte(u.String()) |
||||
return |
||||
} |
||||
|
||||
// UnmarshalText implements the encoding.TextUnmarshaler interface.
|
||||
// Following formats are supported:
|
||||
// "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
|
||||
// "{6ba7b810-9dad-11d1-80b4-00c04fd430c8}",
|
||||
// "urn:uuid:6ba7b810-9dad-11d1-80b4-00c04fd430c8"
|
||||
// "6ba7b8109dad11d180b400c04fd430c8"
|
||||
// ABNF for supported UUID text representation follows:
|
||||
// uuid := canonical | hashlike | braced | urn
|
||||
// plain := canonical | hashlike
|
||||
// canonical := 4hexoct '-' 2hexoct '-' 2hexoct '-' 6hexoct
|
||||
// hashlike := 12hexoct
|
||||
// braced := '{' plain '}'
|
||||
// urn := URN ':' UUID-NID ':' plain
|
||||
// URN := 'urn'
|
||||
// UUID-NID := 'uuid'
|
||||
// 12hexoct := 6hexoct 6hexoct
|
||||
// 6hexoct := 4hexoct 2hexoct
|
||||
// 4hexoct := 2hexoct 2hexoct
|
||||
// 2hexoct := hexoct hexoct
|
||||
// hexoct := hexdig hexdig
|
||||
// hexdig := '0' | '1' | '2' | '3' | '4' | '5' | '6' | '7' | '8' | '9' |
|
||||
// 'a' | 'b' | 'c' | 'd' | 'e' | 'f' |
|
||||
// 'A' | 'B' | 'C' | 'D' | 'E' | 'F'
|
||||
func (u *UUID) UnmarshalText(text []byte) (err error) { |
||||
switch len(text) { |
||||
case 32: |
||||
return u.decodeHashLike(text) |
||||
case 36: |
||||
return u.decodeCanonical(text) |
||||
case 38: |
||||
return u.decodeBraced(text) |
||||
case 41: |
||||
fallthrough |
||||
case 45: |
||||
return u.decodeURN(text) |
||||
default: |
||||
return fmt.Errorf("uuid: incorrect UUID length: %s", text) |
||||
} |
||||
} |
||||
|
||||
// decodeCanonical decodes UUID string in format
|
||||
// "6ba7b810-9dad-11d1-80b4-00c04fd430c8".
|
||||
func (u *UUID) decodeCanonical(t []byte) (err error) { |
||||
if t[8] != '-' || t[13] != '-' || t[18] != '-' || t[23] != '-' { |
||||
return fmt.Errorf("uuid: incorrect UUID format %s", t) |
||||
} |
||||
|
||||
src := t[:] |
||||
dst := u[:] |
||||
|
||||
for i, byteGroup := range byteGroups { |
||||
if i > 0 { |
||||
src = src[1:] // skip dash
|
||||
} |
||||
_, err = hex.Decode(dst[:byteGroup/2], src[:byteGroup]) |
||||
if err != nil { |
||||
return |
||||
} |
||||
src = src[byteGroup:] |
||||
dst = dst[byteGroup/2:] |
||||
} |
||||
|
||||
return |
||||
} |
||||
|
||||
// decodeHashLike decodes UUID string in format
|
||||
// "6ba7b8109dad11d180b400c04fd430c8".
|
||||
func (u *UUID) decodeHashLike(t []byte) (err error) { |
||||
src := t[:] |
||||
dst := u[:] |
||||
|
||||
if _, err = hex.Decode(dst, src); err != nil { |
||||
return err |
||||
} |
||||
return |
||||
} |
||||
|
||||
// decodeBraced decodes UUID string in format
|
||||
// "{6ba7b810-9dad-11d1-80b4-00c04fd430c8}" or in format
|
||||
// "{6ba7b8109dad11d180b400c04fd430c8}".
|
||||
func (u *UUID) decodeBraced(t []byte) (err error) { |
||||
l := len(t) |
||||
|
||||
if t[0] != '{' || t[l-1] != '}' { |
||||
return fmt.Errorf("uuid: incorrect UUID format %s", t) |
||||
} |
||||
|
||||
return u.decodePlain(t[1 : l-1]) |
||||
} |
||||
|
||||
// decodeURN decodes UUID string in format
|
||||
// "urn:uuid:6ba7b810-9dad-11d1-80b4-00c04fd430c8" or in format
|
||||
// "urn:uuid:6ba7b8109dad11d180b400c04fd430c8".
|
||||
func (u *UUID) decodeURN(t []byte) (err error) { |
||||
total := len(t) |
||||
|
||||
urn_uuid_prefix := t[:9] |
||||
|
||||
if !bytes.Equal(urn_uuid_prefix, urnPrefix) { |
||||
return fmt.Errorf("uuid: incorrect UUID format: %s", t) |
||||
} |
||||
|
||||
return u.decodePlain(t[9:total]) |
||||
} |
||||
|
||||
// decodePlain decodes UUID string in canonical format
|
||||
// "6ba7b810-9dad-11d1-80b4-00c04fd430c8" or in hash-like format
|
||||
// "6ba7b8109dad11d180b400c04fd430c8".
|
||||
func (u *UUID) decodePlain(t []byte) (err error) { |
||||
switch len(t) { |
||||
case 32: |
||||
return u.decodeHashLike(t) |
||||
case 36: |
||||
return u.decodeCanonical(t) |
||||
default: |
||||
return fmt.Errorf("uuid: incorrrect UUID length: %s", t) |
||||
} |
||||
} |
||||
|
||||
// MarshalBinary implements the encoding.BinaryMarshaler interface.
|
||||
func (u UUID) MarshalBinary() (data []byte, err error) { |
||||
data = u.Bytes() |
||||
return |
||||
} |
||||
|
||||
// UnmarshalBinary implements the encoding.BinaryUnmarshaler interface.
|
||||
// It will return error if the slice isn't 16 bytes long.
|
||||
func (u *UUID) UnmarshalBinary(data []byte) (err error) { |
||||
if len(data) != Size { |
||||
err = fmt.Errorf("uuid: UUID must be exactly 16 bytes long, got %d bytes", len(data)) |
||||
return |
||||
} |
||||
copy(u[:], data) |
||||
|
||||
return |
||||
} |
||||
@ -1,239 +0,0 @@ |
||||
// Copyright (C) 2013-2018 by Maxim Bublis <b@codemonkey.ru>
|
||||
//
|
||||
// Permission is hereby granted, free of charge, to any person obtaining
|
||||
// a copy of this software and associated documentation files (the
|
||||
// "Software"), to deal in the Software without restriction, including
|
||||
// without limitation the rights to use, copy, modify, merge, publish,
|
||||
// distribute, sublicense, and/or sell copies of the Software, and to
|
||||
// permit persons to whom the Software is furnished to do so, subject to
|
||||
// the following conditions:
|
||||
//
|
||||
// The above copyright notice and this permission notice shall be
|
||||
// included in all copies or substantial portions of the Software.
|
||||
//
|
||||
// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
|
||||
// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
|
||||
// MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
|
||||
// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
|
||||
// LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
|
||||
// OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
|
||||
// WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
|
||||
|
||||
package uuid |
||||
|
||||
import ( |
||||
"crypto/md5" |
||||
"crypto/rand" |
||||
"crypto/sha1" |
||||
"encoding/binary" |
||||
"hash" |
||||
"net" |
||||
"os" |
||||
"sync" |
||||
"time" |
||||
) |
||||
|
||||
// Difference in 100-nanosecond intervals between
|
||||
// UUID epoch (October 15, 1582) and Unix epoch (January 1, 1970).
|
||||
const epochStart = 122192928000000000 |
||||
|
||||
var ( |
||||
global = newDefaultGenerator() |
||||
|
||||
epochFunc = unixTimeFunc |
||||
posixUID = uint32(os.Getuid()) |
||||
posixGID = uint32(os.Getgid()) |
||||
) |
||||
|
||||
// NewV1 returns UUID based on current timestamp and MAC address.
|
||||
func NewV1() UUID { |
||||
return global.NewV1() |
||||
} |
||||
|
||||
// NewV2 returns DCE Security UUID based on POSIX UID/GID.
|
||||
func NewV2(domain byte) UUID { |
||||
return global.NewV2(domain) |
||||
} |
||||
|
||||
// NewV3 returns UUID based on MD5 hash of namespace UUID and name.
|
||||
func NewV3(ns UUID, name string) UUID { |
||||
return global.NewV3(ns, name) |
||||
} |
||||
|
||||
// NewV4 returns random generated UUID.
|
||||
func NewV4() UUID { |
||||
return global.NewV4() |
||||
} |
||||
|
||||
// NewV5 returns UUID based on SHA-1 hash of namespace UUID and name.
|
||||
func NewV5(ns UUID, name string) UUID { |
||||
return global.NewV5(ns, name) |
||||
} |
||||
|
||||
// Generator provides interface for generating UUIDs.
|
||||
type Generator interface { |
||||
NewV1() UUID |
||||
NewV2(domain byte) UUID |
||||
NewV3(ns UUID, name string) UUID |
||||
NewV4() UUID |
||||
NewV5(ns UUID, name string) UUID |
||||
} |
||||
|
||||
// Default generator implementation.
|
||||
type generator struct { |
||||
storageOnce sync.Once |
||||
storageMutex sync.Mutex |
||||
|
||||
lastTime uint64 |
||||
clockSequence uint16 |
||||
hardwareAddr [6]byte |
||||
} |
||||
|
||||
func newDefaultGenerator() Generator { |
||||
return &generator{} |
||||
} |
||||
|
||||
// NewV1 returns UUID based on current timestamp and MAC address.
|
||||
func (g *generator) NewV1() UUID { |
||||
u := UUID{} |
||||
|
||||
timeNow, clockSeq, hardwareAddr := g.getStorage() |
||||
|
||||
binary.BigEndian.PutUint32(u[0:], uint32(timeNow)) |
||||
binary.BigEndian.PutUint16(u[4:], uint16(timeNow>>32)) |
||||
binary.BigEndian.PutUint16(u[6:], uint16(timeNow>>48)) |
||||
binary.BigEndian.PutUint16(u[8:], clockSeq) |
||||
|
||||
copy(u[10:], hardwareAddr) |
||||
|
||||
u.SetVersion(V1) |
||||
u.SetVariant(VariantRFC4122) |
||||
|
||||
return u |
||||
} |
||||
|
||||
// NewV2 returns DCE Security UUID based on POSIX UID/GID.
|
||||
func (g *generator) NewV2(domain byte) UUID { |
||||
u := UUID{} |
||||
|
||||
timeNow, clockSeq, hardwareAddr := g.getStorage() |
||||
|
||||
switch domain { |
||||
case DomainPerson: |
||||
binary.BigEndian.PutUint32(u[0:], posixUID) |
||||
case DomainGroup: |
||||
binary.BigEndian.PutUint32(u[0:], posixGID) |
||||
} |
||||
|
||||
binary.BigEndian.PutUint16(u[4:], uint16(timeNow>>32)) |
||||
binary.BigEndian.PutUint16(u[6:], uint16(timeNow>>48)) |
||||
binary.BigEndian.PutUint16(u[8:], clockSeq) |
||||
u[9] = domain |
||||
|
||||
copy(u[10:], hardwareAddr) |
||||
|
||||
u.SetVersion(V2) |
||||
u.SetVariant(VariantRFC4122) |
||||
|
||||
return u |
||||
} |
||||
|
||||
// NewV3 returns UUID based on MD5 hash of namespace UUID and name.
|
||||
func (g *generator) NewV3(ns UUID, name string) UUID { |
||||
u := newFromHash(md5.New(), ns, name) |
||||
u.SetVersion(V3) |
||||
u.SetVariant(VariantRFC4122) |
||||
|
||||
return u |
||||
} |
||||
|
||||
// NewV4 returns random generated UUID.
|
||||
func (g *generator) NewV4() UUID { |
||||
u := UUID{} |
||||
g.safeRandom(u[:]) |
||||
u.SetVersion(V4) |
||||
u.SetVariant(VariantRFC4122) |
||||
|
||||
return u |
||||
} |
||||
|
||||
// NewV5 returns UUID based on SHA-1 hash of namespace UUID and name.
|
||||
func (g *generator) NewV5(ns UUID, name string) UUID { |
||||
u := newFromHash(sha1.New(), ns, name) |
||||
u.SetVersion(V5) |
||||
u.SetVariant(VariantRFC4122) |
||||
|
||||
return u |
||||
} |
||||
|
||||
func (g *generator) initStorage() { |
||||
g.initClockSequence() |
||||
g.initHardwareAddr() |
||||
} |
||||
|
||||
func (g *generator) initClockSequence() { |
||||
buf := make([]byte, 2) |
||||
g.safeRandom(buf) |
||||
g.clockSequence = binary.BigEndian.Uint16(buf) |
||||
} |
||||
|
||||
func (g *generator) initHardwareAddr() { |
||||
interfaces, err := net.Interfaces() |
||||
if err == nil { |
||||
for _, iface := range interfaces { |
||||
if len(iface.HardwareAddr) >= 6 { |
||||
copy(g.hardwareAddr[:], iface.HardwareAddr) |
||||
return |
||||
} |
||||
} |
||||
} |
||||
|
||||
// Initialize hardwareAddr randomly in case
|
||||
// of real network interfaces absence
|
||||
g.safeRandom(g.hardwareAddr[:]) |
||||
|
||||
// Set multicast bit as recommended in RFC 4122
|
||||
g.hardwareAddr[0] |= 0x01 |
||||
} |
||||
|
||||
func (g *generator) safeRandom(dest []byte) { |
||||
if _, err := rand.Read(dest); err != nil { |
||||
panic(err) |
||||
} |
||||
} |
||||
|
||||
// Returns UUID v1/v2 storage state.
|
||||
// Returns epoch timestamp, clock sequence, and hardware address.
|
||||
func (g *generator) getStorage() (uint64, uint16, []byte) { |
||||
g.storageOnce.Do(g.initStorage) |
||||
|
||||
g.storageMutex.Lock() |
||||
defer g.storageMutex.Unlock() |
||||
|
||||
timeNow := epochFunc() |
||||
// Clock changed backwards since last UUID generation.
|
||||
// Should increase clock sequence.
|
||||
if timeNow <= g.lastTime { |
||||
g.clockSequence++ |
||||
} |
||||
g.lastTime = timeNow |
||||
|
||||
return timeNow, g.clockSequence, g.hardwareAddr[:] |
||||
} |
||||
|
||||
// Returns difference in 100-nanosecond intervals between
|
||||
// UUID epoch (October 15, 1582) and current time.
|
||||
// This is default epoch calculation function.
|
||||
func unixTimeFunc() uint64 { |
||||
return epochStart + uint64(time.Now().UnixNano()/100) |
||||
} |
||||
|
||||
// Returns UUID based on hashing of namespace UUID and name.
|
||||
func newFromHash(h hash.Hash, ns UUID, name string) UUID { |
||||
u := UUID{} |
||||
h.Write(ns[:]) |
||||
h.Write([]byte(name)) |
||||
copy(u[:], h.Sum(nil)) |
||||
|
||||
return u |
||||
} |
||||
@ -1,78 +0,0 @@ |
||||
// Copyright (C) 2013-2018 by Maxim Bublis <b@codemonkey.ru>
|
||||
//
|
||||
// Permission is hereby granted, free of charge, to any person obtaining
|
||||
// a copy of this software and associated documentation files (the
|
||||
// "Software"), to deal in the Software without restriction, including
|
||||
// without limitation the rights to use, copy, modify, merge, publish,
|
||||
// distribute, sublicense, and/or sell copies of the Software, and to
|
||||
// permit persons to whom the Software is furnished to do so, subject to
|
||||
// the following conditions:
|
||||
//
|
||||
// The above copyright notice and this permission notice shall be
|
||||
// included in all copies or substantial portions of the Software.
|
||||
//
|
||||
// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
|
||||
// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
|
||||
// MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
|
||||
// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
|
||||
// LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
|
||||
// OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
|
||||
// WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
|
||||
|
||||
package uuid |
||||
|
||||
import ( |
||||
"database/sql/driver" |
||||
"fmt" |
||||
) |
||||
|
||||
// Value implements the driver.Valuer interface.
|
||||
func (u UUID) Value() (driver.Value, error) { |
||||
return u.String(), nil |
||||
} |
||||
|
||||
// Scan implements the sql.Scanner interface.
|
||||
// A 16-byte slice is handled by UnmarshalBinary, while
|
||||
// a longer byte slice or a string is handled by UnmarshalText.
|
||||
func (u *UUID) Scan(src interface{}) error { |
||||
switch src := src.(type) { |
||||
case []byte: |
||||
if len(src) == Size { |
||||
return u.UnmarshalBinary(src) |
||||
} |
||||
return u.UnmarshalText(src) |
||||
|
||||
case string: |
||||
return u.UnmarshalText([]byte(src)) |
||||
} |
||||
|
||||
return fmt.Errorf("uuid: cannot convert %T to UUID", src) |
||||
} |
||||
|
||||
// NullUUID can be used with the standard sql package to represent a
|
||||
// UUID value that can be NULL in the database
|
||||
type NullUUID struct { |
||||
UUID UUID |
||||
Valid bool |
||||
} |
||||
|
||||
// Value implements the driver.Valuer interface.
|
||||
func (u NullUUID) Value() (driver.Value, error) { |
||||
if !u.Valid { |
||||
return nil, nil |
||||
} |
||||
// Delegate to UUID Value function
|
||||
return u.UUID.Value() |
||||
} |
||||
|
||||
// Scan implements the sql.Scanner interface.
|
||||
func (u *NullUUID) Scan(src interface{}) error { |
||||
if src == nil { |
||||
u.UUID, u.Valid = Nil, false |
||||
return nil |
||||
} |
||||
|
||||
// Delegate to UUID Scan function
|
||||
u.Valid = true |
||||
return u.UUID.Scan(src) |
||||
} |
||||
@ -1,161 +0,0 @@ |
||||
// Copyright (C) 2013-2018 by Maxim Bublis <b@codemonkey.ru>
|
||||
//
|
||||
// Permission is hereby granted, free of charge, to any person obtaining
|
||||
// a copy of this software and associated documentation files (the
|
||||
// "Software"), to deal in the Software without restriction, including
|
||||
// without limitation the rights to use, copy, modify, merge, publish,
|
||||
// distribute, sublicense, and/or sell copies of the Software, and to
|
||||
// permit persons to whom the Software is furnished to do so, subject to
|
||||
// the following conditions:
|
||||
//
|
||||
// The above copyright notice and this permission notice shall be
|
||||
// included in all copies or substantial portions of the Software.
|
||||
//
|
||||
// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
|
||||
// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
|
||||
// MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
|
||||
// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
|
||||
// LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
|
||||
// OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
|
||||
// WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
|
||||
|
||||
// Package uuid provides implementation of Universally Unique Identifier (UUID).
|
||||
// Supported versions are 1, 3, 4 and 5 (as specified in RFC 4122) and
|
||||
// version 2 (as specified in DCE 1.1).
|
||||
package uuid |
||||
|
||||
import ( |
||||
"bytes" |
||||
"encoding/hex" |
||||
) |
||||
|
||||
// Size of a UUID in bytes.
|
||||
const Size = 16 |
||||
|
||||
// UUID representation compliant with specification
|
||||
// described in RFC 4122.
|
||||
type UUID [Size]byte |
||||
|
||||
// UUID versions
|
||||
const ( |
||||
_ byte = iota |
||||
V1 |
||||
V2 |
||||
V3 |
||||
V4 |
||||
V5 |
||||
) |
||||
|
||||
// UUID layout variants.
|
||||
const ( |
||||
VariantNCS byte = iota |
||||
VariantRFC4122 |
||||
VariantMicrosoft |
||||
VariantFuture |
||||
) |
||||
|
||||
// UUID DCE domains.
|
||||
const ( |
||||
DomainPerson = iota |
||||
DomainGroup |
||||
DomainOrg |
||||
) |
||||
|
||||
// String parse helpers.
|
||||
var ( |
||||
urnPrefix = []byte("urn:uuid:") |
||||
byteGroups = []int{8, 4, 4, 4, 12} |
||||
) |
||||
|
||||
// Nil is special form of UUID that is specified to have all
|
||||
// 128 bits set to zero.
|
||||
var Nil = UUID{} |
||||
|
||||
// Predefined namespace UUIDs.
|
||||
var ( |
||||
NamespaceDNS = Must(FromString("6ba7b810-9dad-11d1-80b4-00c04fd430c8")) |
||||
NamespaceURL = Must(FromString("6ba7b811-9dad-11d1-80b4-00c04fd430c8")) |
||||
NamespaceOID = Must(FromString("6ba7b812-9dad-11d1-80b4-00c04fd430c8")) |
||||
NamespaceX500 = Must(FromString("6ba7b814-9dad-11d1-80b4-00c04fd430c8")) |
||||
) |
||||
|
||||
// Equal returns true if u1 and u2 equals, otherwise returns false.
|
||||
func Equal(u1 UUID, u2 UUID) bool { |
||||
return bytes.Equal(u1[:], u2[:]) |
||||
} |
||||
|
||||
// Version returns algorithm version used to generate UUID.
|
||||
func (u UUID) Version() byte { |
||||
return u[6] >> 4 |
||||
} |
||||
|
||||
// Variant returns UUID layout variant.
|
||||
func (u UUID) Variant() byte { |
||||
switch { |
||||
case (u[8] >> 7) == 0x00: |
||||
return VariantNCS |
||||
case (u[8] >> 6) == 0x02: |
||||
return VariantRFC4122 |
||||
case (u[8] >> 5) == 0x06: |
||||
return VariantMicrosoft |
||||
case (u[8] >> 5) == 0x07: |
||||
fallthrough |
||||
default: |
||||
return VariantFuture |
||||
} |
||||
} |
||||
|
||||
// Bytes returns bytes slice representation of UUID.
|
||||
func (u UUID) Bytes() []byte { |
||||
return u[:] |
||||
} |
||||
|
||||
// Returns canonical string representation of UUID:
|
||||
// xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.
|
||||
func (u UUID) String() string { |
||||
buf := make([]byte, 36) |
||||
|
||||
hex.Encode(buf[0:8], u[0:4]) |
||||
buf[8] = '-' |
||||
hex.Encode(buf[9:13], u[4:6]) |
||||
buf[13] = '-' |
||||
hex.Encode(buf[14:18], u[6:8]) |
||||
buf[18] = '-' |
||||
hex.Encode(buf[19:23], u[8:10]) |
||||
buf[23] = '-' |
||||
hex.Encode(buf[24:], u[10:]) |
||||
|
||||
return string(buf) |
||||
} |
||||
|
||||
// SetVersion sets version bits.
|
||||
func (u *UUID) SetVersion(v byte) { |
||||
u[6] = (u[6] & 0x0f) | (v << 4) |
||||
} |
||||
|
||||
// SetVariant sets variant bits.
|
||||
func (u *UUID) SetVariant(v byte) { |
||||
switch v { |
||||
case VariantNCS: |
||||
u[8] = (u[8]&(0xff>>1) | (0x00 << 7)) |
||||
case VariantRFC4122: |
||||
u[8] = (u[8]&(0xff>>2) | (0x02 << 6)) |
||||
case VariantMicrosoft: |
||||
u[8] = (u[8]&(0xff>>3) | (0x06 << 5)) |
||||
case VariantFuture: |
||||
fallthrough |
||||
default: |
||||
u[8] = (u[8]&(0xff>>3) | (0x07 << 5)) |
||||
} |
||||
} |
||||
|
||||
// Must is a helper that wraps a call to a function returning (UUID, error)
|
||||
// and panics if the error is non-nil. It is intended for use in variable
|
||||
// initializations such as
|
||||
// var packageUUID = uuid.Must(uuid.FromString("123e4567-e89b-12d3-a456-426655440000"));
|
||||
func Must(u UUID, err error) UUID { |
||||
if err != nil { |
||||
panic(err) |
||||
} |
||||
return u |
||||
} |
||||
Loading…
Reference in new issue