Add function to validate uuid strings

internals/api/uuid/uuid.go

@@ -3,6 +3,14 @@ package uuid
 
 import (
 	gid "github.com/satori/go.uuid"
+
+	"github.com/secrethub/secrethub-go/internals/errio"
+)
+
+// Errors
+var (
+	errInvalidUUID    = errio.Namespace("uuid").Code("invalid")
+	ErrInvalidUUIDErr = errInvalidUUID.ErrorPref("invalid uuid: %s")
 )
 
 // UUID is a wrapper around go.uuid.UUID
@@ -20,7 +28,7 @@ func New() *UUID {
 func FromString(str string) (*UUID, error) {
 	id, err := gid.FromString(str)
 	if err != nil {
-		return nil, err
+		return nil, ErrInvalidUUIDErr(err)
 	}
 	return &UUID{id}, nil
 }
@@ -39,3 +47,18 @@ func (u *UUID) IsZero() bool {
 func Equal(a *UUID, b *UUID) bool {
 	return gid.Equal(a.UUID, b.UUID)
 }
+
+// Validate validates a uuid string is a valid UUID.
+func Validate(str string) error {
+	_, err := FromString(str)
+	return err
+}
+
+// IsErrInvalidUUID returns whether the given error is returned for an invalid uuid.
+func IsErrInvalidUUID(err error) bool {
+	publicErr, ok := err.(errio.PublicError)
+	if !ok {
+		return false
+	}
+	return publicErr.Namespace == errInvalidUUID.Namespace && publicErr.Code == errInvalidUUID.Code
+}