mirror of
				https://github.com/caddyserver/caddy.git
				synced 2025-11-03 19:17:29 -05:00 
			
		
		
		
	Implement 'http.on' plugin and replace UUID lib (#1864)
* Implement 'command' plugin * Rename 'command' to 'on' * Split this PR
This commit is contained in:
		
							parent
							
								
									f9cba03d25
								
							
						
					
					
						commit
						118cf5f240
					
				@ -45,5 +45,6 @@ import (
 | 
			
		||||
	_ "github.com/mholt/caddy/caddyhttp/templates"
 | 
			
		||||
	_ "github.com/mholt/caddy/caddyhttp/timeouts"
 | 
			
		||||
	_ "github.com/mholt/caddy/caddyhttp/websocket"
 | 
			
		||||
	_ "github.com/mholt/caddy/onevent"
 | 
			
		||||
	_ "github.com/mholt/caddy/startupshutdown"
 | 
			
		||||
)
 | 
			
		||||
 | 
			
		||||
@ -25,7 +25,7 @@ import (
 | 
			
		||||
// ensure that the standard plugins are in fact plugged in
 | 
			
		||||
// and registered properly; this is a quick/naive way to do it.
 | 
			
		||||
func TestStandardPlugins(t *testing.T) {
 | 
			
		||||
	numStandardPlugins := 32 // importing caddyhttp plugs in this many plugins
 | 
			
		||||
	numStandardPlugins := 33 // importing caddyhttp plugs in this many plugins
 | 
			
		||||
	s := caddy.DescribePlugins()
 | 
			
		||||
	if got, want := strings.Count(s, "\n"), numStandardPlugins+5; got != want {
 | 
			
		||||
		t.Errorf("Expected all standard plugins to be plugged in, got:\n%s", s)
 | 
			
		||||
 | 
			
		||||
@ -455,8 +455,9 @@ var directives = []string{
 | 
			
		||||
	"tls",
 | 
			
		||||
 | 
			
		||||
	// services/utilities, or other directives that don't necessarily inject handlers
 | 
			
		||||
	"startup",
 | 
			
		||||
	"shutdown",
 | 
			
		||||
	"startup",  // TODO: Deprecate this directive
 | 
			
		||||
	"shutdown", // TODO: Deprecate this directive
 | 
			
		||||
	"on",
 | 
			
		||||
	"request_id",
 | 
			
		||||
	"realip", // github.com/captncraig/caddy-realip
 | 
			
		||||
	"git",    // github.com/abiosoft/caddy-git
 | 
			
		||||
 | 
			
		||||
@ -16,11 +16,10 @@ package requestid
 | 
			
		||||
 | 
			
		||||
import (
 | 
			
		||||
	"context"
 | 
			
		||||
	"log"
 | 
			
		||||
	"net/http"
 | 
			
		||||
 | 
			
		||||
	"github.com/google/uuid"
 | 
			
		||||
	"github.com/mholt/caddy/caddyhttp/httpserver"
 | 
			
		||||
	uuid "github.com/nu7hatch/gouuid"
 | 
			
		||||
)
 | 
			
		||||
 | 
			
		||||
// Handler is a middleware handler
 | 
			
		||||
@ -29,20 +28,9 @@ type Handler struct {
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
func (h Handler) ServeHTTP(w http.ResponseWriter, r *http.Request) (int, error) {
 | 
			
		||||
	reqid := UUID()
 | 
			
		||||
	reqid := uuid.New().String()
 | 
			
		||||
	c := context.WithValue(r.Context(), httpserver.RequestIDCtxKey, reqid)
 | 
			
		||||
	r = r.WithContext(c)
 | 
			
		||||
 | 
			
		||||
	return h.Next.ServeHTTP(w, r)
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
// UUID returns U4 UUID
 | 
			
		||||
func UUID() string {
 | 
			
		||||
	u4, err := uuid.NewV4()
 | 
			
		||||
	if err != nil {
 | 
			
		||||
		log.Printf("[ERROR] generating request ID: %v", err)
 | 
			
		||||
		return ""
 | 
			
		||||
	}
 | 
			
		||||
 | 
			
		||||
	return u4.String()
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
@ -19,6 +19,7 @@ import (
 | 
			
		||||
	"net/http"
 | 
			
		||||
	"testing"
 | 
			
		||||
 | 
			
		||||
	"github.com/google/uuid"
 | 
			
		||||
	"github.com/mholt/caddy/caddyhttp/httpserver"
 | 
			
		||||
)
 | 
			
		||||
 | 
			
		||||
@ -28,7 +29,7 @@ func TestRequestID(t *testing.T) {
 | 
			
		||||
		t.Fatal("Could not create HTTP request:", err)
 | 
			
		||||
	}
 | 
			
		||||
 | 
			
		||||
	reqid := UUID()
 | 
			
		||||
	reqid := uuid.New().String()
 | 
			
		||||
 | 
			
		||||
	c := context.WithValue(request.Context(), httpserver.RequestIDCtxKey, reqid)
 | 
			
		||||
 | 
			
		||||
 | 
			
		||||
							
								
								
									
										20
									
								
								onevent/hook/config.go
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										20
									
								
								onevent/hook/config.go
									
									
									
									
									
										Normal file
									
								
							@ -0,0 +1,20 @@
 | 
			
		||||
package hook
 | 
			
		||||
 | 
			
		||||
import (
 | 
			
		||||
	"github.com/mholt/caddy"
 | 
			
		||||
)
 | 
			
		||||
 | 
			
		||||
// Config describes how Hook should be configured and used.
 | 
			
		||||
type Config struct {
 | 
			
		||||
	ID      string
 | 
			
		||||
	Event   caddy.EventName
 | 
			
		||||
	Command string
 | 
			
		||||
	Args    []string
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
// SupportedEvents is a map of supported events.
 | 
			
		||||
var SupportedEvents = map[string]caddy.EventName{
 | 
			
		||||
	"startup":   caddy.InstanceStartupEvent,
 | 
			
		||||
	"shutdown":  caddy.ShutdownEvent,
 | 
			
		||||
	"certrenew": caddy.CertRenewEvent,
 | 
			
		||||
}
 | 
			
		||||
							
								
								
									
										41
									
								
								onevent/hook/hook.go
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										41
									
								
								onevent/hook/hook.go
									
									
									
									
									
										Normal file
									
								
							@ -0,0 +1,41 @@
 | 
			
		||||
package hook
 | 
			
		||||
 | 
			
		||||
import (
 | 
			
		||||
	"log"
 | 
			
		||||
	"os"
 | 
			
		||||
	"os/exec"
 | 
			
		||||
	"strings"
 | 
			
		||||
 | 
			
		||||
	"github.com/mholt/caddy"
 | 
			
		||||
)
 | 
			
		||||
 | 
			
		||||
// Hook executes a command.
 | 
			
		||||
func (cfg *Config) Hook(event caddy.EventName, info interface{}) error {
 | 
			
		||||
	if event != cfg.Event {
 | 
			
		||||
		return nil
 | 
			
		||||
	}
 | 
			
		||||
 | 
			
		||||
	nonblock := false
 | 
			
		||||
	if len(cfg.Args) > 1 && cfg.Args[len(cfg.Args)-1] == "&" {
 | 
			
		||||
		// Run command in background; non-blocking
 | 
			
		||||
		nonblock = true
 | 
			
		||||
		cfg.Args = cfg.Args[:len(cfg.Args)-1]
 | 
			
		||||
	}
 | 
			
		||||
 | 
			
		||||
	// Execute command.
 | 
			
		||||
	cmd := exec.Command(cfg.Command, cfg.Args...)
 | 
			
		||||
	cmd.Stdin = os.Stdin
 | 
			
		||||
	cmd.Stdout = os.Stdout
 | 
			
		||||
	cmd.Stderr = os.Stderr
 | 
			
		||||
	if nonblock {
 | 
			
		||||
		log.Printf("[INFO] Nonblocking Command with ID %s: \"%s %s\"", cfg.ID, cfg.Command, strings.Join(cfg.Args, " "))
 | 
			
		||||
		return cmd.Start()
 | 
			
		||||
	}
 | 
			
		||||
	log.Printf("[INFO] Blocking Command with ID %s: \"%s %s\"", cfg.ID, cfg.Command, strings.Join(cfg.Args, " "))
 | 
			
		||||
	err := cmd.Run()
 | 
			
		||||
	if err != nil {
 | 
			
		||||
		return err
 | 
			
		||||
	}
 | 
			
		||||
 | 
			
		||||
	return nil
 | 
			
		||||
}
 | 
			
		||||
							
								
								
									
										60
									
								
								onevent/hook/hook_test.go
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										60
									
								
								onevent/hook/hook_test.go
									
									
									
									
									
										Normal file
									
								
							@ -0,0 +1,60 @@
 | 
			
		||||
package hook
 | 
			
		||||
 | 
			
		||||
import (
 | 
			
		||||
	"os"
 | 
			
		||||
	"path/filepath"
 | 
			
		||||
	"strconv"
 | 
			
		||||
	"testing"
 | 
			
		||||
	"time"
 | 
			
		||||
 | 
			
		||||
	"github.com/google/uuid"
 | 
			
		||||
	"github.com/mholt/caddy"
 | 
			
		||||
)
 | 
			
		||||
 | 
			
		||||
func TestHook(t *testing.T) {
 | 
			
		||||
	tempDirPath := os.TempDir()
 | 
			
		||||
 | 
			
		||||
	testDir := filepath.Join(tempDirPath, "temp_dir_for_testing_command")
 | 
			
		||||
	defer func() {
 | 
			
		||||
		// clean up after non-blocking startup function quits
 | 
			
		||||
		time.Sleep(500 * time.Millisecond)
 | 
			
		||||
		os.RemoveAll(testDir)
 | 
			
		||||
	}()
 | 
			
		||||
	osSenitiveTestDir := filepath.FromSlash(testDir)
 | 
			
		||||
	os.RemoveAll(osSenitiveTestDir) // start with a clean slate
 | 
			
		||||
 | 
			
		||||
	tests := []struct {
 | 
			
		||||
		name            string
 | 
			
		||||
		event           caddy.EventName
 | 
			
		||||
		command         string
 | 
			
		||||
		args            []string
 | 
			
		||||
		shouldErr       bool
 | 
			
		||||
		shouldRemoveErr bool
 | 
			
		||||
	}{
 | 
			
		||||
		{name: "blocking", event: caddy.InstanceStartupEvent, command: "mkdir", args: []string{osSenitiveTestDir}, shouldErr: false, shouldRemoveErr: false},
 | 
			
		||||
		{name: "nonBlocking", event: caddy.ShutdownEvent, command: "mkdir", args: []string{osSenitiveTestDir, "&"}, shouldErr: false, shouldRemoveErr: true},
 | 
			
		||||
		{name: "nonExistent", event: caddy.CertRenewEvent, command: strconv.Itoa(int(time.Now().UnixNano())), shouldErr: true, shouldRemoveErr: true},
 | 
			
		||||
	}
 | 
			
		||||
 | 
			
		||||
	for _, test := range tests {
 | 
			
		||||
		t.Run(test.name, func(t *testing.T) {
 | 
			
		||||
			cfg := new(Config)
 | 
			
		||||
			cfg.ID = uuid.New().String()
 | 
			
		||||
			cfg.Event = test.event
 | 
			
		||||
			cfg.Command = test.command
 | 
			
		||||
			cfg.Args = test.args
 | 
			
		||||
 | 
			
		||||
			err := cfg.Hook(test.event, nil)
 | 
			
		||||
			if err == nil && test.shouldErr {
 | 
			
		||||
				t.Error("Test didn't error, but it should have")
 | 
			
		||||
			} else if err != nil && !test.shouldErr {
 | 
			
		||||
				t.Errorf("Test errored, but it shouldn't have; got '%v'", err)
 | 
			
		||||
			}
 | 
			
		||||
 | 
			
		||||
			err = os.Remove(osSenitiveTestDir)
 | 
			
		||||
			if err != nil && !test.shouldRemoveErr {
 | 
			
		||||
				t.Errorf("Test received an error of:\n%v", err)
 | 
			
		||||
			}
 | 
			
		||||
		})
 | 
			
		||||
	}
 | 
			
		||||
}
 | 
			
		||||
							
								
								
									
										65
									
								
								onevent/on.go
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										65
									
								
								onevent/on.go
									
									
									
									
									
										Normal file
									
								
							@ -0,0 +1,65 @@
 | 
			
		||||
package onevent
 | 
			
		||||
 | 
			
		||||
import (
 | 
			
		||||
	"strings"
 | 
			
		||||
 | 
			
		||||
	"github.com/google/uuid"
 | 
			
		||||
	"github.com/mholt/caddy"
 | 
			
		||||
	"github.com/mholt/caddy/onevent/hook"
 | 
			
		||||
)
 | 
			
		||||
 | 
			
		||||
func init() {
 | 
			
		||||
	// Register Directive.
 | 
			
		||||
	caddy.RegisterPlugin("on", caddy.Plugin{Action: setup})
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
func setup(c *caddy.Controller) error {
 | 
			
		||||
	config, err := onParse(c)
 | 
			
		||||
	if err != nil {
 | 
			
		||||
		return err
 | 
			
		||||
	}
 | 
			
		||||
 | 
			
		||||
	// Register Event Hooks.
 | 
			
		||||
	for _, cfg := range config {
 | 
			
		||||
		caddy.RegisterEventHook("on-"+cfg.ID, cfg.Hook)
 | 
			
		||||
	}
 | 
			
		||||
 | 
			
		||||
	return nil
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
func onParse(c *caddy.Controller) ([]*hook.Config, error) {
 | 
			
		||||
	var config []*hook.Config
 | 
			
		||||
 | 
			
		||||
	for c.Next() {
 | 
			
		||||
		cfg := new(hook.Config)
 | 
			
		||||
 | 
			
		||||
		if !c.NextArg() {
 | 
			
		||||
			return config, c.ArgErr()
 | 
			
		||||
		}
 | 
			
		||||
 | 
			
		||||
		// Configure Event.
 | 
			
		||||
		event, ok := hook.SupportedEvents[strings.ToLower(c.Val())]
 | 
			
		||||
		if !ok {
 | 
			
		||||
			return config, c.Errf("Wrong event name or event not supported: '%s'", c.Val())
 | 
			
		||||
		}
 | 
			
		||||
		cfg.Event = event
 | 
			
		||||
 | 
			
		||||
		// Assign an unique ID.
 | 
			
		||||
		cfg.ID = uuid.New().String()
 | 
			
		||||
 | 
			
		||||
		args := c.RemainingArgs()
 | 
			
		||||
 | 
			
		||||
		// Extract command and arguments.
 | 
			
		||||
		command, args, err := caddy.SplitCommandAndArgs(strings.Join(args, " "))
 | 
			
		||||
		if err != nil {
 | 
			
		||||
			return config, c.Err(err.Error())
 | 
			
		||||
		}
 | 
			
		||||
 | 
			
		||||
		cfg.Command = command
 | 
			
		||||
		cfg.Args = args
 | 
			
		||||
 | 
			
		||||
		config = append(config, cfg)
 | 
			
		||||
	}
 | 
			
		||||
 | 
			
		||||
	return config, nil
 | 
			
		||||
}
 | 
			
		||||
							
								
								
									
										81
									
								
								onevent/on_test.go
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										81
									
								
								onevent/on_test.go
									
									
									
									
									
										Normal file
									
								
							@ -0,0 +1,81 @@
 | 
			
		||||
package onevent
 | 
			
		||||
 | 
			
		||||
import (
 | 
			
		||||
	"testing"
 | 
			
		||||
 | 
			
		||||
	"github.com/mholt/caddy"
 | 
			
		||||
	"github.com/mholt/caddy/onevent/hook"
 | 
			
		||||
)
 | 
			
		||||
 | 
			
		||||
func TestSetup(t *testing.T) {
 | 
			
		||||
	tests := []struct {
 | 
			
		||||
		name      string
 | 
			
		||||
		input     string
 | 
			
		||||
		shouldErr bool
 | 
			
		||||
	}{
 | 
			
		||||
		{name: "noInput", input: "on", shouldErr: true},
 | 
			
		||||
		{name: "nonExistent", input: "on xyz cmd arg", shouldErr: true},
 | 
			
		||||
		{name: "startup", input: "on startup cmd arg", shouldErr: false},
 | 
			
		||||
		{name: "shutdown", input: "on shutdown cmd arg &", shouldErr: false},
 | 
			
		||||
		{name: "certrenew", input: "on certrenew cmd arg", shouldErr: false},
 | 
			
		||||
	}
 | 
			
		||||
 | 
			
		||||
	for _, test := range tests {
 | 
			
		||||
		t.Run(test.name, func(t *testing.T) {
 | 
			
		||||
			c := caddy.NewTestController("http", test.input)
 | 
			
		||||
			c.Key = test.name
 | 
			
		||||
 | 
			
		||||
			err := setup(c)
 | 
			
		||||
 | 
			
		||||
			if err == nil && test.shouldErr {
 | 
			
		||||
				t.Error("Test didn't error, but it should have")
 | 
			
		||||
			} else if err != nil && !test.shouldErr {
 | 
			
		||||
				t.Errorf("Test errored, but it shouldn't have; got '%v'", err)
 | 
			
		||||
			}
 | 
			
		||||
		})
 | 
			
		||||
	}
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
func TestCommandParse(t *testing.T) {
 | 
			
		||||
	tests := []struct {
 | 
			
		||||
		name      string
 | 
			
		||||
		input     string
 | 
			
		||||
		shouldErr bool
 | 
			
		||||
		config    hook.Config
 | 
			
		||||
	}{
 | 
			
		||||
		{name: "noInput", input: `on`, shouldErr: true},
 | 
			
		||||
		{name: "nonExistent", input: "on xyz cmd arg", shouldErr: true},
 | 
			
		||||
		{name: "startup", input: `on startup cmd arg1 arg2`, shouldErr: false, config: hook.Config{Event: caddy.InstanceStartupEvent, Command: "cmd", Args: []string{"arg1", "arg2"}}},
 | 
			
		||||
		{name: "shutdown", input: `on shutdown cmd arg1 arg2 &`, shouldErr: false, config: hook.Config{Event: caddy.ShutdownEvent, Command: "cmd", Args: []string{"arg1", "arg2", "&"}}},
 | 
			
		||||
		{name: "certrenew", input: `on certrenew cmd arg1 arg2`, shouldErr: false, config: hook.Config{Event: caddy.CertRenewEvent, Command: "cmd", Args: []string{"arg1", "arg2"}}},
 | 
			
		||||
	}
 | 
			
		||||
 | 
			
		||||
	for _, test := range tests {
 | 
			
		||||
		t.Run(test.name, func(t *testing.T) {
 | 
			
		||||
			config, err := onParse(caddy.NewTestController("http", test.input))
 | 
			
		||||
 | 
			
		||||
			if err == nil && test.shouldErr {
 | 
			
		||||
				t.Error("Test didn't error, but it should have")
 | 
			
		||||
			} else if err != nil && !test.shouldErr {
 | 
			
		||||
				t.Errorf("Test errored, but it shouldn't have; got '%v'", err)
 | 
			
		||||
			}
 | 
			
		||||
 | 
			
		||||
			for _, cfg := range config {
 | 
			
		||||
				if cfg.Event != test.config.Event {
 | 
			
		||||
					t.Errorf("Expected event %s; got %s", test.config.Event, cfg.Event)
 | 
			
		||||
				}
 | 
			
		||||
 | 
			
		||||
				if cfg.Command != test.config.Command {
 | 
			
		||||
					t.Errorf("Expected command %s; got %s", test.config.Command, cfg.Command)
 | 
			
		||||
				}
 | 
			
		||||
 | 
			
		||||
				for i, arg := range cfg.Args {
 | 
			
		||||
					if arg != test.config.Args[i] {
 | 
			
		||||
						t.Errorf("Expected arg in position %d to be %s, got %s", i, test.config.Args[i], arg)
 | 
			
		||||
					}
 | 
			
		||||
				}
 | 
			
		||||
 | 
			
		||||
			}
 | 
			
		||||
		})
 | 
			
		||||
	}
 | 
			
		||||
}
 | 
			
		||||
							
								
								
									
										27
									
								
								vendor/github.com/google/uuid/LICENSE
									
									
									
										generated
									
									
										vendored
									
									
										Normal file
									
								
							
							
						
						
									
										27
									
								
								vendor/github.com/google/uuid/LICENSE
									
									
									
										generated
									
									
										vendored
									
									
										Normal file
									
								
							@ -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.
 | 
			
		||||
							
								
								
									
										80
									
								
								vendor/github.com/google/uuid/dce.go
									
									
									
										generated
									
									
										vendored
									
									
										Normal file
									
								
							
							
						
						
									
										80
									
								
								vendor/github.com/google/uuid/dce.go
									
									
									
										generated
									
									
										vendored
									
									
										Normal file
									
								
							@ -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))
 | 
			
		||||
}
 | 
			
		||||
							
								
								
									
										12
									
								
								vendor/github.com/google/uuid/doc.go
									
									
									
										generated
									
									
										vendored
									
									
										Normal file
									
								
							
							
						
						
									
										12
									
								
								vendor/github.com/google/uuid/doc.go
									
									
									
										generated
									
									
										vendored
									
									
										Normal file
									
								
							@ -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
 | 
			
		||||
							
								
								
									
										53
									
								
								vendor/github.com/google/uuid/hash.go
									
									
									
										generated
									
									
										vendored
									
									
										Normal file
									
								
							
							
						
						
									
										53
									
								
								vendor/github.com/google/uuid/hash.go
									
									
									
										generated
									
									
										vendored
									
									
										Normal file
									
								
							@ -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([]byte(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)
 | 
			
		||||
}
 | 
			
		||||
							
								
								
									
										39
									
								
								vendor/github.com/google/uuid/marshal.go
									
									
									
										generated
									
									
										vendored
									
									
										Normal file
									
								
							
							
						
						
									
										39
									
								
								vendor/github.com/google/uuid/marshal.go
									
									
									
										generated
									
									
										vendored
									
									
										Normal file
									
								
							@ -0,0 +1,39 @@
 | 
			
		||||
// 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 {
 | 
			
		||||
	// See comment in ParseBytes why we do this.
 | 
			
		||||
	// id, err := ParseBytes(data)
 | 
			
		||||
	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
 | 
			
		||||
}
 | 
			
		||||
							
								
								
									
										103
									
								
								vendor/github.com/google/uuid/node.go
									
									
									
										generated
									
									
										vendored
									
									
										Normal file
									
								
							
							
						
						
									
										103
									
								
								vendor/github.com/google/uuid/node.go
									
									
									
										generated
									
									
										vendored
									
									
										Normal file
									
								
							@ -0,0 +1,103 @@
 | 
			
		||||
// 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 (
 | 
			
		||||
	"net"
 | 
			
		||||
	"sync"
 | 
			
		||||
)
 | 
			
		||||
 | 
			
		||||
var (
 | 
			
		||||
	nodeMu     sync.Mutex
 | 
			
		||||
	interfaces []net.Interface // cached list of interfaces
 | 
			
		||||
	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 {
 | 
			
		||||
	if interfaces == nil {
 | 
			
		||||
		var err error
 | 
			
		||||
		interfaces, err = net.Interfaces()
 | 
			
		||||
		if err != nil && name != "" {
 | 
			
		||||
			return false
 | 
			
		||||
		}
 | 
			
		||||
	}
 | 
			
		||||
 | 
			
		||||
	for _, ifs := range interfaces {
 | 
			
		||||
		if len(ifs.HardwareAddr) >= 6 && (name == "" || name == ifs.Name) {
 | 
			
		||||
			copy(nodeID[:], ifs.HardwareAddr)
 | 
			
		||||
			ifname = ifs.Name
 | 
			
		||||
			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 == "" {
 | 
			
		||||
		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 {
 | 
			
		||||
	if len(uuid) != 16 {
 | 
			
		||||
		return nil
 | 
			
		||||
	}
 | 
			
		||||
	var node [6]byte
 | 
			
		||||
	copy(node[:], uuid[10:])
 | 
			
		||||
	return node[:]
 | 
			
		||||
}
 | 
			
		||||
							
								
								
									
										59
									
								
								vendor/github.com/google/uuid/sql.go
									
									
									
										generated
									
									
										vendored
									
									
										Normal file
									
								
							
							
						
						
									
										59
									
								
								vendor/github.com/google/uuid/sql.go
									
									
									
										generated
									
									
										vendored
									
									
										Normal file
									
								
							@ -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
 | 
			
		||||
}
 | 
			
		||||
							
								
								
									
										123
									
								
								vendor/github.com/google/uuid/time.go
									
									
									
										generated
									
									
										vendored
									
									
										Normal file
									
								
							
							
						
						
									
										123
									
								
								vendor/github.com/google/uuid/time.go
									
									
									
										generated
									
									
										vendored
									
									
										Normal file
									
								
							@ -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)
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
// SetClockSeq 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])
 | 
			
		||||
	}
 | 
			
		||||
	old_seq := clockSeq
 | 
			
		||||
	clockSeq = uint16(seq&0x3fff) | 0x8000 // Set our variant
 | 
			
		||||
	if old_seq != 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
 | 
			
		||||
}
 | 
			
		||||
							
								
								
									
										43
									
								
								vendor/github.com/google/uuid/util.go
									
									
									
										generated
									
									
										vendored
									
									
										Normal file
									
								
							
							
						
						
									
										43
									
								
								vendor/github.com/google/uuid/util.go
									
									
									
										generated
									
									
										vendored
									
									
										Normal file
									
								
							@ -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
 | 
			
		||||
}
 | 
			
		||||
							
								
								
									
										191
									
								
								vendor/github.com/google/uuid/uuid.go
									
									
									
										generated
									
									
										vendored
									
									
										Normal file
									
								
							
							
						
						
									
										191
									
								
								vendor/github.com/google/uuid/uuid.go
									
									
									
										generated
									
									
										vendored
									
									
										Normal file
									
								
							@ -0,0 +1,191 @@
 | 
			
		||||
// 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 (
 | 
			
		||||
	"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 UUID form of
 | 
			
		||||
// xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx and
 | 
			
		||||
// urn:uuid:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx are decoded.
 | 
			
		||||
func Parse(s string) (UUID, error) {
 | 
			
		||||
	var uuid UUID
 | 
			
		||||
	if len(s) != 36 {
 | 
			
		||||
		if len(s) != 36+9 {
 | 
			
		||||
			return uuid, fmt.Errorf("invalid UUID length: %d", len(s))
 | 
			
		||||
		}
 | 
			
		||||
		if strings.ToLower(s[:9]) != "urn:uuid:" {
 | 
			
		||||
			return uuid, fmt.Errorf("invalid urn prefix: %q", s[:9])
 | 
			
		||||
		}
 | 
			
		||||
		s = s[9:]
 | 
			
		||||
	}
 | 
			
		||||
	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} {
 | 
			
		||||
		if v, ok := xtob(s[x], s[x+1]); !ok {
 | 
			
		||||
			return uuid, errors.New("invalid UUID format")
 | 
			
		||||
		} else {
 | 
			
		||||
			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
 | 
			
		||||
	if len(b) != 36 {
 | 
			
		||||
		if len(b) != 36+9 {
 | 
			
		||||
			return uuid, fmt.Errorf("invalid UUID length: %d", len(b))
 | 
			
		||||
		}
 | 
			
		||||
		if !bytes.Equal(bytes.ToLower(b[:9]), []byte("urn:uuid:")) {
 | 
			
		||||
			return uuid, fmt.Errorf("invalid urn prefix: %q", b[:9])
 | 
			
		||||
		}
 | 
			
		||||
		b = b[9:]
 | 
			
		||||
	}
 | 
			
		||||
	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} {
 | 
			
		||||
		if v, ok := xtob(b[x], b[x+1]); !ok {
 | 
			
		||||
			return uuid, errors.New("invalid UUID format")
 | 
			
		||||
		} else {
 | 
			
		||||
			uuid[i] = v
 | 
			
		||||
		}
 | 
			
		||||
	}
 | 
			
		||||
	return uuid, nil
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
// 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
 | 
			
		||||
}
 | 
			
		||||
							
								
								
									
										44
									
								
								vendor/github.com/google/uuid/version1.go
									
									
									
										generated
									
									
										vendored
									
									
										Normal file
									
								
							
							
						
						
									
										44
									
								
								vendor/github.com/google/uuid/version1.go
									
									
									
										generated
									
									
										vendored
									
									
										Normal file
									
								
							@ -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
 | 
			
		||||
}
 | 
			
		||||
							
								
								
									
										38
									
								
								vendor/github.com/google/uuid/version4.go
									
									
									
										generated
									
									
										vendored
									
									
										Normal file
									
								
							
							
						
						
									
										38
									
								
								vendor/github.com/google/uuid/version4.go
									
									
									
										generated
									
									
										vendored
									
									
										Normal file
									
								
							@ -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 or panics.
 | 
			
		||||
//
 | 
			
		||||
// 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
 | 
			
		||||
}
 | 
			
		||||
							
								
								
									
										19
									
								
								vendor/github.com/nu7hatch/gouuid/COPYING
									
									
									
										generated
									
									
										vendored
									
									
								
							
							
						
						
									
										19
									
								
								vendor/github.com/nu7hatch/gouuid/COPYING
									
									
									
										generated
									
									
										vendored
									
									
								
							@ -1,19 +0,0 @@
 | 
			
		||||
Copyright (C) 2011 by Krzysztof Kowalik <chris@nu7hat.ch>
 | 
			
		||||
 | 
			
		||||
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.
 | 
			
		||||
							
								
								
									
										173
									
								
								vendor/github.com/nu7hatch/gouuid/uuid.go
									
									
									
										generated
									
									
										vendored
									
									
								
							
							
						
						
									
										173
									
								
								vendor/github.com/nu7hatch/gouuid/uuid.go
									
									
									
										generated
									
									
										vendored
									
									
								
							@ -1,173 +0,0 @@
 | 
			
		||||
// This package provides immutable UUID structs and the functions
 | 
			
		||||
// NewV3, NewV4, NewV5 and Parse() for generating versions 3, 4
 | 
			
		||||
// and 5 UUIDs as specified in RFC 4122.
 | 
			
		||||
//
 | 
			
		||||
// Copyright (C) 2011 by Krzysztof Kowalik <chris@nu7hat.ch>
 | 
			
		||||
package uuid
 | 
			
		||||
 | 
			
		||||
import (
 | 
			
		||||
	"crypto/md5"
 | 
			
		||||
	"crypto/rand"
 | 
			
		||||
	"crypto/sha1"
 | 
			
		||||
	"encoding/hex"
 | 
			
		||||
	"errors"
 | 
			
		||||
	"fmt"
 | 
			
		||||
	"hash"
 | 
			
		||||
	"regexp"
 | 
			
		||||
)
 | 
			
		||||
 | 
			
		||||
// The UUID reserved variants. 
 | 
			
		||||
const (
 | 
			
		||||
	ReservedNCS       byte = 0x80
 | 
			
		||||
	ReservedRFC4122   byte = 0x40
 | 
			
		||||
	ReservedMicrosoft byte = 0x20
 | 
			
		||||
	ReservedFuture    byte = 0x00
 | 
			
		||||
)
 | 
			
		||||
 | 
			
		||||
// The following standard UUIDs are for use with NewV3() or NewV5().
 | 
			
		||||
var (
 | 
			
		||||
	NamespaceDNS, _  = ParseHex("6ba7b810-9dad-11d1-80b4-00c04fd430c8")
 | 
			
		||||
	NamespaceURL, _  = ParseHex("6ba7b811-9dad-11d1-80b4-00c04fd430c8")
 | 
			
		||||
	NamespaceOID, _  = ParseHex("6ba7b812-9dad-11d1-80b4-00c04fd430c8")
 | 
			
		||||
	NamespaceX500, _ = ParseHex("6ba7b814-9dad-11d1-80b4-00c04fd430c8")
 | 
			
		||||
)
 | 
			
		||||
 | 
			
		||||
// Pattern used to parse hex string representation of the UUID.
 | 
			
		||||
// FIXME: do something to consider both brackets at one time,
 | 
			
		||||
// current one allows to parse string with only one opening
 | 
			
		||||
// or closing bracket.
 | 
			
		||||
const hexPattern = "^(urn\\:uuid\\:)?\\{?([a-z0-9]{8})-([a-z0-9]{4})-" +
 | 
			
		||||
	"([1-5][a-z0-9]{3})-([a-z0-9]{4})-([a-z0-9]{12})\\}?$"
 | 
			
		||||
 | 
			
		||||
var re = regexp.MustCompile(hexPattern)
 | 
			
		||||
 | 
			
		||||
// A UUID representation compliant with specification in
 | 
			
		||||
// RFC 4122 document.
 | 
			
		||||
type UUID [16]byte
 | 
			
		||||
 | 
			
		||||
// ParseHex creates a UUID object from given hex string
 | 
			
		||||
// representation. Function accepts UUID string in following
 | 
			
		||||
// formats:
 | 
			
		||||
//
 | 
			
		||||
//     uuid.ParseHex("6ba7b814-9dad-11d1-80b4-00c04fd430c8")
 | 
			
		||||
//     uuid.ParseHex("{6ba7b814-9dad-11d1-80b4-00c04fd430c8}")
 | 
			
		||||
//     uuid.ParseHex("urn:uuid:6ba7b814-9dad-11d1-80b4-00c04fd430c8")
 | 
			
		||||
//
 | 
			
		||||
func ParseHex(s string) (u *UUID, err error) {
 | 
			
		||||
	md := re.FindStringSubmatch(s)
 | 
			
		||||
	if md == nil {
 | 
			
		||||
		err = errors.New("Invalid UUID string")
 | 
			
		||||
		return
 | 
			
		||||
	}
 | 
			
		||||
	hash := md[2] + md[3] + md[4] + md[5] + md[6]
 | 
			
		||||
	b, err := hex.DecodeString(hash)
 | 
			
		||||
	if err != nil {
 | 
			
		||||
		return
 | 
			
		||||
	}
 | 
			
		||||
	u = new(UUID)
 | 
			
		||||
	copy(u[:], b)
 | 
			
		||||
	return
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
// Parse creates a UUID object from given bytes slice.
 | 
			
		||||
func Parse(b []byte) (u *UUID, err error) {
 | 
			
		||||
	if len(b) != 16 {
 | 
			
		||||
		err = errors.New("Given slice is not valid UUID sequence")
 | 
			
		||||
		return
 | 
			
		||||
	}
 | 
			
		||||
	u = new(UUID)
 | 
			
		||||
	copy(u[:], b)
 | 
			
		||||
	return
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
// Generate a UUID based on the MD5 hash of a namespace identifier
 | 
			
		||||
// and a name.
 | 
			
		||||
func NewV3(ns *UUID, name []byte) (u *UUID, err error) {
 | 
			
		||||
	if ns == nil {
 | 
			
		||||
		err = errors.New("Invalid namespace UUID")
 | 
			
		||||
		return
 | 
			
		||||
	}
 | 
			
		||||
	u = new(UUID)
 | 
			
		||||
	// Set all bits to MD5 hash generated from namespace and name.
 | 
			
		||||
	u.setBytesFromHash(md5.New(), ns[:], name)
 | 
			
		||||
	u.setVariant(ReservedRFC4122)
 | 
			
		||||
	u.setVersion(3)
 | 
			
		||||
	return
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
// Generate a random UUID.
 | 
			
		||||
func NewV4() (u *UUID, err error) {
 | 
			
		||||
	u = new(UUID)
 | 
			
		||||
	// Set all bits to randomly (or pseudo-randomly) chosen values.
 | 
			
		||||
	_, err = rand.Read(u[:])
 | 
			
		||||
	if err != nil {
 | 
			
		||||
		return
 | 
			
		||||
	}
 | 
			
		||||
	u.setVariant(ReservedRFC4122)
 | 
			
		||||
	u.setVersion(4)
 | 
			
		||||
	return
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
// Generate a UUID based on the SHA-1 hash of a namespace identifier
 | 
			
		||||
// and a name.
 | 
			
		||||
func NewV5(ns *UUID, name []byte) (u *UUID, err error) {
 | 
			
		||||
	u = new(UUID)
 | 
			
		||||
	// Set all bits to truncated SHA1 hash generated from namespace
 | 
			
		||||
	// and name.
 | 
			
		||||
	u.setBytesFromHash(sha1.New(), ns[:], name)
 | 
			
		||||
	u.setVariant(ReservedRFC4122)
 | 
			
		||||
	u.setVersion(5)
 | 
			
		||||
	return
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
// Generate a MD5 hash of a namespace and a name, and copy it to the
 | 
			
		||||
// UUID slice.
 | 
			
		||||
func (u *UUID) setBytesFromHash(hash hash.Hash, ns, name []byte) {
 | 
			
		||||
	hash.Write(ns[:])
 | 
			
		||||
	hash.Write(name)
 | 
			
		||||
	copy(u[:], hash.Sum([]byte{})[:16])
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
// Set the two most significant bits (bits 6 and 7) of the
 | 
			
		||||
// clock_seq_hi_and_reserved to zero and one, respectively.
 | 
			
		||||
func (u *UUID) setVariant(v byte) {
 | 
			
		||||
	switch v {
 | 
			
		||||
	case ReservedNCS:
 | 
			
		||||
		u[8] = (u[8] | ReservedNCS) & 0xBF
 | 
			
		||||
	case ReservedRFC4122:
 | 
			
		||||
		u[8] = (u[8] | ReservedRFC4122) & 0x7F
 | 
			
		||||
	case ReservedMicrosoft:
 | 
			
		||||
		u[8] = (u[8] | ReservedMicrosoft) & 0x3F
 | 
			
		||||
	}
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
// Variant returns the UUID Variant, which determines the internal
 | 
			
		||||
// layout of the UUID. This will be one of the constants: RESERVED_NCS,
 | 
			
		||||
// RFC_4122, RESERVED_MICROSOFT, RESERVED_FUTURE.
 | 
			
		||||
func (u *UUID) Variant() byte {
 | 
			
		||||
	if u[8]&ReservedNCS == ReservedNCS {
 | 
			
		||||
		return ReservedNCS
 | 
			
		||||
	} else if u[8]&ReservedRFC4122 == ReservedRFC4122 {
 | 
			
		||||
		return ReservedRFC4122
 | 
			
		||||
	} else if u[8]&ReservedMicrosoft == ReservedMicrosoft {
 | 
			
		||||
		return ReservedMicrosoft
 | 
			
		||||
	}
 | 
			
		||||
	return ReservedFuture
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
// Set the four most significant bits (bits 12 through 15) of the
 | 
			
		||||
// time_hi_and_version field to the 4-bit version number.
 | 
			
		||||
func (u *UUID) setVersion(v byte) {
 | 
			
		||||
	u[6] = (u[6] & 0xF) | (v << 4)
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
// Version returns a version number of the algorithm used to
 | 
			
		||||
// generate the UUID sequence.
 | 
			
		||||
func (u *UUID) Version() uint {
 | 
			
		||||
	return uint(u[6] >> 4)
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
// Returns unparsed version of the generated UUID sequence.
 | 
			
		||||
func (u *UUID) String() string {
 | 
			
		||||
	return fmt.Sprintf("%x-%x-%x-%x-%x", u[0:4], u[4:6], u[6:8], u[8:10], u[10:])
 | 
			
		||||
}
 | 
			
		||||
							
								
								
									
										16
									
								
								vendor/manifest
									
									
									
									
										vendored
									
									
								
							
							
						
						
									
										16
									
								
								vendor/manifest
									
									
									
									
										vendored
									
									
								
							@ -76,6 +76,14 @@
 | 
			
		||||
			"path": "ptypes/any",
 | 
			
		||||
			"notests": true
 | 
			
		||||
		},
 | 
			
		||||
		{
 | 
			
		||||
			"importpath": "github.com/google/uuid",
 | 
			
		||||
			"repository": "https://github.com/google/uuid",
 | 
			
		||||
			"vcs": "git",
 | 
			
		||||
			"revision": "7e072fc3a7be179aee6d3359e46015aa8c995314",
 | 
			
		||||
			"branch": "master",
 | 
			
		||||
			"notests": true
 | 
			
		||||
		},
 | 
			
		||||
		{
 | 
			
		||||
			"importpath": "github.com/gorilla/websocket",
 | 
			
		||||
			"repository": "https://github.com/gorilla/websocket",
 | 
			
		||||
@ -165,14 +173,6 @@
 | 
			
		||||
			"branch": "master",
 | 
			
		||||
			"notests": true
 | 
			
		||||
		},
 | 
			
		||||
		{
 | 
			
		||||
			"importpath": "github.com/nu7hatch/gouuid",
 | 
			
		||||
			"repository": "https://github.com/nu7hatch/gouuid",
 | 
			
		||||
			"vcs": "git",
 | 
			
		||||
			"revision": "179d4d0c4d8d407a32af483c2354df1d2c91e6c3",
 | 
			
		||||
			"branch": "master",
 | 
			
		||||
			"notests": true
 | 
			
		||||
		},
 | 
			
		||||
		{
 | 
			
		||||
			"importpath": "github.com/russross/blackfriday",
 | 
			
		||||
			"repository": "https://github.com/russross/blackfriday",
 | 
			
		||||
 | 
			
		||||
		Loading…
	
	
			
			x
			
			
		
	
		Reference in New Issue
	
	Block a user