12a2a21083
full diff: https://github.com/google/uuid/compare/v1.1.2...v1.2.0 I did not switch to us the `uuid.NewString()` function; we are not currently using `uuid.New()`, probably because it can `panic` in case an invalid UUID is produced; in stead we are using `uuid.NewRandom()`, which is equivalent, but returns an error instead. Changes: - v1.2.0: Add NewString() This release introduces the NewString() function which is the equivalent of uuid.New().String(). - v1.1.5: 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) - v1.1.4: Further error optimizations Do not allocate memory for errors (it is only one word) - v1.1.3: 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. Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
60 lines
1.4 KiB
Go
60 lines
1.4 KiB
Go
// 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
|
|
}
|