apicontext

2024-12-23 16:01:54 +00:00
parent ce5e566c9e
commit a54a70047b
129 changed files with 1107 additions and 693 deletions
@@ -0,0 +1,22 @@
+package controllers
+
+import (
+	"context"
+	"gotemplate/api/grpc/spec"
+	"gotemplate/internal/export"
+)
+
+type ExportController struct {
+	spec.UnimplementedExportServiceServer
+	export export.Service
+}
+
+func NewExportController(exportSvc export.Service) *ExportController {
+	return &ExportController{
+		export: exportSvc,
+	}
+}
+
+func (s *ExportController) Trigger(ctx context.Context, req *spec.ExportTrigger) (*spec.IdMessage, error) {
+	return &spec.IdMessage{}, nil
+}
@@ -0,0 +1,32 @@
+package controllers
+
+import (
+	"context"
+	"gotemplate/api/grpc/spec"
+	"gotemplate/internal/collector"
+
+	"google.golang.org/protobuf/types/known/emptypb"
+)
+
+type JobCollectorController struct {
+	spec.UnimplementedJobCollectorServiceServer
+	collector collector.Service
+}
+
+func NewJobCollectorController(collSvc collector.Service) *JobCollectorController {
+	return &JobCollectorController{
+		collector: collSvc,
+	}
+}
+
+func (s *JobCollectorController) Get(ctx context.Context, req *spec.IdMessage) (*spec.JobCollector, error) {
+	return &spec.JobCollector{}, nil
+}
+
+func (s *JobCollectorController) Create(ctx context.Context, req *spec.JobCollectorCreate) (*spec.IdMessage, error) {
+	return &spec.IdMessage{}, nil
+}
+
+func (s *JobCollectorController) Update(ctx context.Context, req *spec.JobCollectorUpdate) (*emptypb.Empty, error) {
+	return &emptypb.Empty{}, nil
+}
@@ -1,40 +0,0 @@
-package controllers
-
-import (
-	"context"
-	"gotemplate/api/grpc/spec"
-	"gotemplate/internal/name"
-)
-
-type NameController struct {
-	spec.UnimplementedNameServer
-	name name.Service
-}
-
-func NewNameController(nameSvc name.Service) *NameController {
-	return &NameController{
-		name: nameSvc,
-	}
-}
-
-func (s *NameController) Add(ctx context.Context, req *spec.NameMessage) (*spec.NameMessage, error) {
-	err := s.name.Add(ctx, req.GetName())
-	if err != nil {
-		return &spec.NameMessage{}, err
-	}
-
-	return &spec.NameMessage{
-		Name: req.GetName(),
-	}, nil
-}
-
-func (s *NameController) Get(ctx context.Context, req *spec.NameMessage) (*spec.NameMessage, error) {
-	name, err := s.name.Get(ctx, req.GetName())
-	if err != nil {
-		return &spec.NameMessage{}, err
-	}
-
-	return &spec.NameMessage{
-		Name: name,
-	}, nil
-}
@@ -0,0 +1,44 @@
+package controllers
+
+import (
+	"context"
+	"gotemplate/api/grpc/spec"
+	"gotemplate/internal/query"
+
+	"google.golang.org/protobuf/types/known/emptypb"
+)
+
+type QueryController struct {
+	spec.UnimplementedQueryServiceServer
+	query query.Service
+}
+
+func NewQueryController(querySvc query.Service) *QueryController {
+	return &QueryController{
+		query: querySvc,
+	}
+}
+
+func (s *QueryController) List(ctx context.Context, req *spec.QueryFilter) (*spec.Queries, error) {
+	return &spec.Queries{}, nil
+}
+
+func (s *QueryController) Get(ctx context.Context, req *spec.IdMessage) (*spec.Query, error) {
+	return &spec.Query{}, nil
+}
+
+func (s *QueryController) Create(ctx context.Context, req *spec.QueryCreate) (*spec.IdMessage, error) {
+	return &spec.IdMessage{}, nil
+}
+
+func (s *QueryController) Update(ctx context.Context, req *spec.QueryUpdate) (*emptypb.Empty, error) {
+	return &emptypb.Empty{}, nil
+}
+
+func (s *QueryController) Remove(ctx context.Context, req *spec.IdMessage) (*emptypb.Empty, error) {
+	return &emptypb.Empty{}, nil
+}
+
+func (s *QueryController) Test(ctx context.Context, req *spec.QueryTestRequest) (*spec.QueryTestResponse, error) {
+	return &spec.QueryTestResponse{}, nil
+}
@@ -4,9 +4,12 @@ import (
 	"context"
 	"gotemplate/api/grpc/controllers"
 	"gotemplate/api/grpc/spec"
+	"gotemplate/internal/collector"
 	"gotemplate/internal/database"
 	"gotemplate/internal/database/repository"
+	"gotemplate/internal/export"
 	"gotemplate/internal/otel"
+	"gotemplate/internal/query"
 	"log"
 	"net"
 	"strconv"
@@ -36,7 +39,9 @@ func main() {
 	db := repository.New(pool)

 	grpcServer := grpc.NewServer()
-	spec.RegisterNameServer(grpcServer, controllers.NewNameController(*name.New(ctx, db)))
+	spec.RegisterQueryServiceServer(grpcServer, controllers.NewQueryController(*query.New(db)))
+	spec.RegisterExportServiceServer(grpcServer, controllers.NewExportController(*export.New(db)))
+	spec.RegisterJobCollectorServiceServer(grpcServer, controllers.NewJobCollectorController(*collector.New(db)))

 	log.Printf("Listening on port %d", port)
 	if err := grpcServer.Serve(lis); err != nil {
@@ -36,7 +36,7 @@ func main() {
 	db := repository.New(conn)

 	controllers := queue.Controllers{
-		Document: *queue.NewDocumentController(*document.New(ctx, db)),
+		Document: *queue.NewDocumentController(*document.New(db)),
 	}

 	config := queue.Queue{
@@ -7,6 +7,7 @@ require (
 	github.com/aws/aws-sdk-go-v2/config v1.28.5
 	github.com/aws/aws-sdk-go-v2/service/sqs v1.37.1
 	github.com/golang-migrate/migrate/v4 v4.18.1
+	github.com/golang/protobuf v1.5.4
 	github.com/jackc/pgx/v5 v5.5.5
 	github.com/lib/pq v1.10.9
 	github.com/stretchr/testify v1.10.0
@@ -0,0 +1,47 @@
+package collector
+
+import (
+	"context"
+	"gotemplate/internal/database"
+	"gotemplate/internal/database/repository"
+
+	"github.com/google/uuid"
+)
+
+type Collector struct {
+	ID              uuid.UUID
+	MinCleanVersion int32
+	MinTextVersion  int32
+	db              *repository.Queries
+}
+
+func NewByJobId(ctx context.Context, db *repository.Queries, jobID uuid.UUID) (*Collector, error) {
+	collector := Collector{
+		db: db,
+	}
+
+	err := collector.getByJobID(ctx, jobID)
+	if err != nil {
+		return nil, err
+	}
+
+	return &collector, nil
+}
+
+func (c *Collector) getByJobID(ctx context.Context, jobID uuid.UUID) error {
+	dbJobID, err := database.ToDBUUID(jobID)
+	if err != nil {
+		return err
+	}
+
+	dbCollector, err := c.db.GetCollectorFromJobID(ctx, dbJobID)
+	if err != nil {
+		return err
+	}
+
+	c.ID = database.MustToUUID(dbCollector.ID)
+	c.MinCleanVersion = dbCollector.Mincleanversion
+	c.MinTextVersion = dbCollector.Mintextversion
+
+	return nil
+}
@@ -1,47 +1,11 @@
 package collector

-import (
-	"context"
-	"gotemplate/internal/database"
-	"gotemplate/internal/database/repository"
+import "gotemplate/internal/database/repository"

-	"github.com/google/uuid"
-)
-
-type Collector struct {
-	ID              uuid.UUID
-	MinCleanVersion int32
-	MinTextVersion  int32
-	db              *repository.Queries
+type Service struct {
+	db *repository.Queries
 }

-func NewByJobId(ctx context.Context, db *repository.Queries, jobID uuid.UUID) (*Collector, error) {
-	collector := Collector{
-		db: db,
-	}
-
-	err := collector.getByJobID(ctx, jobID)
-	if err != nil {
-		return nil, err
-	}
-
-	return &collector, nil
-}
-
-func (c *Collector) getByJobID(ctx context.Context, jobID uuid.UUID) error {
-	dbJobID, err := database.ToDBUUID(jobID)
-	if err != nil {
-		return err
-	}
-
-	dbCollector, err := c.db.GetCollectorFromJobID(ctx, dbJobID)
-	if err != nil {
-		return err
-	}
-
-	c.ID = database.MustToUUID(dbCollector.ID)
-	c.MinCleanVersion = dbCollector.Mincleanversion
-	c.MinTextVersion = dbCollector.Mintextversion
-
-	return nil
+func New(db *repository.Queries) *Service {
+	return &Service{db}
 }
@@ -22,7 +22,7 @@ type Service struct {
 	db *repository.Queries
 }

-func New(ctx context.Context, db *repository.Queries) *Service {
+func New(db *repository.Queries) *Service {
 	return &Service{
 		db: db,
 	}
@@ -0,0 +1,11 @@
+package export
+
+import "gotemplate/internal/database/repository"
+
+type Service struct {
+	db *repository.Queries
+}
+
+func New(db *repository.Queries) *Service {
+	return &Service{db}
+}
@@ -0,0 +1,44 @@
+package query
+
+import (
+	"context"
+	"gotemplate/internal/collector"
+	"gotemplate/internal/database/repository"
+
+	"github.com/google/uuid"
+)
+
+type Queue struct {
+	unsyncedQueue    *[]Query
+	collectorQueries *[]Query
+	results          *[]Result
+	collector        *collector.Collector
+	db               *repository.Queries
+	cleanVersion     int32
+	textVersion      int32
+	documentId       uuid.UUID
+}
+
+func NewQueue(ctx context.Context, db *repository.Queries, coll *collector.Collector, results *[]Result, docId uuid.UUID, cleanVersion int32, textVersion int32) (*Queue, error) {
+	queue := Queue{
+		db:           db,
+		results:      results,
+		collector:    coll,
+		documentId:   docId,
+		cleanVersion: cleanVersion,
+		textVersion:  textVersion,
+	}
+
+	err := queue.getCollectorQueries(ctx)
+	if err != nil {
+		return nil, err
+	}
+
+	queue.getUnsyncedQueries()
+
+	return &queue, nil
+}
+
+func (q *Queue) GetQueue() []Query {
+	return *q.unsyncedQueue
+}
@@ -1,8 +1,6 @@
 package query

 import (
-	"context"
-	"gotemplate/internal/collector"
 	"gotemplate/internal/database/repository"

 	"github.com/google/uuid"
@@ -27,37 +25,10 @@ type Result struct {
 	QueryVersion int32
 }

-type Queue struct {
-	unsyncedQueue    *[]Query
-	collectorQueries *[]Query
-	results          *[]Result
-	collector        *collector.Collector
-	db               *repository.Queries
-	cleanVersion     int32
-	textVersion      int32
-	documentId       uuid.UUID
+type Service struct {
+	db *repository.Queries
 }

-func NewQueue(ctx context.Context, db *repository.Queries, coll *collector.Collector, results *[]Result, docId uuid.UUID, cleanVersion int32, textVersion int32) (*Queue, error) {
-	queue := Queue{
-		db:           db,
-		results:      results,
-		collector:    coll,
-		documentId:   docId,
-		cleanVersion: cleanVersion,
-		textVersion:  textVersion,
-	}
-
-	err := queue.getCollectorQueries(ctx)
-	if err != nil {
-		return nil, err
-	}
-
-	queue.getUnsyncedQueries()
-
-	return &queue, nil
-}
-
-func (q *Queue) GetQueue() []Query {
-	return *q.unsyncedQueue
+func New(db *repository.Queries) *Service {
+	return &Service{db}
 }
@@ -43,7 +43,6 @@ tasks:
      - ./{{.OUT_FILE}}
  lint:
    cmds:
-      - task proto:lint
      - task code:lint
      - task db:lint
      - task yaml:lint
@@ -52,7 +51,6 @@ tasks:
      - task shell:lint
  lint:fix:
    cmds:
-      - task proto:lint:fix
      - task code:lint:fix
  code:lint:
    cmds:
@@ -1,41 +0,0 @@
-package grpc_test
-
-import (
-	"context"
-	"testing"
-
-	"gotemplate/api/grpc/spec"
-
-	"github.com/stretchr/testify/assert"
-)
-
-func TestName(t *testing.T) {
-	ctx := context.Background()
-
-	conn, cleanup := createDependencies(t, ctx)
-	defer cleanup()
-
-	client := spec.NewNameClient(conn)
-
-	name := "Doczy.ai"
-
-	_, err := client.Get(ctx, &spec.NameMessage{
-		Name: name,
-	})
-
-	assert.NotNil(t, err)
-
-	response, err := client.Add(ctx, &spec.NameMessage{
-		Name: name,
-	})
-
-	assert.Nil(t, err)
-	assert.Equal(t, name, response.Name)
-
-	response, err = client.Get(ctx, &spec.NameMessage{
-		Name: name,
-	})
-
-	assert.Nil(t, err)
-	assert.Equal(t, name, response.Name)
-}
@@ -0,0 +1,27 @@
+package grpc_test
+
+import (
+	"context"
+	"testing"
+
+	"gotemplate/api/grpc/spec"
+
+	"github.com/stretchr/testify/assert"
+)
+
+func TestName(t *testing.T) {
+	ctx := context.Background()
+
+	conn, cleanup := createDependencies(t, ctx)
+	defer cleanup()
+
+	client := spec.NewQueryServiceClient(conn)
+
+	id := "sample_id"
+
+	_, err := client.Get(ctx, &spec.IdMessage{
+		Id: id,
+	})
+
+	assert.NotNil(t, err)
+}
@@ -23,7 +23,7 @@ func TestSync(t *testing.T) {
 	defer db.Close(ctx)

 	queries := repository.New(db)
-	docSvc := document.New(ctx, queries)
+	docSvc := document.New(queries)

 	doc := document.Document{
 		ID:    uuid.New(),
@@ -1,3 +1,4 @@
+//go:build windows
 // +build windows

 package winterm
@@ -1,3 +1,4 @@
+//go:build windows
 // +build windows

 package winterm
@@ -1,3 +1,4 @@
+//go:build windows
 // +build windows

 package winterm
@@ -1,3 +1,4 @@
+//go:build windows
 // +build windows

 package winterm
@@ -1,3 +1,4 @@
+//go:build windows
 // +build windows

 package winterm
@@ -1,3 +1,4 @@
+//go:build windows
 // +build windows

 package winterm
@@ -1,3 +1,4 @@
+//go:build windows
 // +build windows

 package winterm
@@ -1,3 +1,4 @@
+//go:build windows
 // +build windows

 package winterm
@@ -15,26 +15,26 @@ import (
 // When defining struct types. the `document` struct tag can be used to control how the value will be
 // marshaled into the resulting protocol document.
 //
-//		// Field is ignored
-//		Field int `document:"-"`
+//	// Field is ignored
+//	Field int `document:"-"`
 //
-//		// Field object of key "myName"
-//		Field int `document:"myName"`
+//	// Field object of key "myName"
+//	Field int `document:"myName"`
 //
-//		// Field object key of key "myName", and
-//		// Field is omitted if the field is a zero value for the type.
-//		Field int `document:"myName,omitempty"`
+//	// Field object key of key "myName", and
+//	// Field is omitted if the field is a zero value for the type.
+//	Field int `document:"myName,omitempty"`
 //
-//		// Field object key of "Field", and
-//		// Field is omitted if the field is a zero value for the type.
-//		Field int `document:",omitempty"`
+//	// Field object key of "Field", and
+//	// Field is omitted if the field is a zero value for the type.
+//	Field int `document:",omitempty"`
 //
 // All struct fields, including anonymous fields, are marshaled unless the
 // any of the following conditions are meet.
 //
-//		- the field is not exported
-//		- document field tag is "-"
-//		- document field tag specifies "omitempty", and is a zero value.
+//   - the field is not exported
+//   - document field tag is "-"
+//   - document field tag specifies "omitempty", and is a zero value.
 //
 // Pointer and interface values are encoded as the value pointed to or
 // contained in the interface. A nil value encodes as a null
@@ -63,12 +63,13 @@ type Marshaler interface {
 //
 // Both generic interface{} and concrete types are valid unmarshal destination types. When unmarshaling a document
 // into an empty interface the Unmarshaler will store one of these values:
-//   bool,                   for boolean values
-//   document.Number,        for arbitrary-precision numbers (int64, float64, big.Int, big.Float)
-//   string,                 for string values
-//   []interface{},          for array values
-//   map[string]interface{}, for objects
-//   nil,                    for null values
+//
+//	bool,                   for boolean values
+//	document.Number,        for arbitrary-precision numbers (int64, float64, big.Int, big.Float)
+//	string,                 for string values
+//	[]interface{},          for array values
+//	map[string]interface{}, for objects
+//	nil,                    for null values
 //
 // When unmarshaling, any error that occurs will halt the unmarshal and return the error.
 type Unmarshaler interface {
@@ -4,21 +4,21 @@ shape serializer function in which a xml.Value will be passed around.

 Resources followed: https://smithy.io/2.0/spec/protocol-traits.html#xml-bindings

-Member Element
+# Member Element

 Member element should be used to encode xml shapes into xml elements except for flattened xml shapes. Member element
 write their own element start tag. These elements should always be closed.

-Flattened Element
+# Flattened Element

 Flattened element should be used to encode shapes marked with flattened trait into xml elements. Flattened element
 do not write a start tag, and thus should not be closed.

-Simple types encoding
+# Simple types encoding

 All simple type methods on value such as String(), Long() etc; auto close the associated member element.

-Array
+# Array

 Array returns the collection encoder. It has two modes, wrapped and flattened encoding.

@@ -32,7 +32,7 @@ If a shape is marked as flattened, Array() will use the shape element name as wr

 	<flattenedAarray>apple</flattenedArray><flattenedArray>tree</flattenedArray>

-Map
+# Map

 Map is the map encoder. It has two modes, wrapped and flattened encoding.

@@ -14,7 +14,7 @@
 // handler. A handler could be something like an HTTP Client that round trips an
 // API operation over HTTP.
 //
-// Smithy Middleware Stack
+// # Smithy Middleware Stack
 //
 // A Stack is a collection of middleware that wrap a handler. The stack can be
 // broken down into discreet steps. Each step may contain zero or more middleware
@@ -48,20 +48,20 @@
 // the request message. Deserializes the response into a structured type or
 // error above stacks can react to.
 //
-// Adding Middleware to a Stack Step
+// # Adding Middleware to a Stack Step
 //
 // Middleware can be added to a step front or back, or relative, by name, to an
 // existing middleware in that stack. If a middleware does not have a name, a
 // unique name will be generated at the middleware and be added to the step.
 //
-//     // Create middleware stack
-//     stack := middleware.NewStack()
+//	// Create middleware stack
+//	stack := middleware.NewStack()
 //
-//     // Add middleware to stack steps
-//     stack.Initialize.Add(paramValidationMiddleware, middleware.After)
-//     stack.Serialize.Add(marshalOperationFoo, middleware.After)
-//     stack.Deserialize.Add(unmarshalOperationFoo, middleware.After)
+//	// Add middleware to stack steps
+//	stack.Initialize.Add(paramValidationMiddleware, middleware.After)
+//	stack.Serialize.Add(marshalOperationFoo, middleware.After)
+//	stack.Deserialize.Add(unmarshalOperationFoo, middleware.After)
 //
-//     // Invoke middleware on handler.
-//     resp, err := stack.HandleMiddleware(ctx, req.Input, clientHandler)
+//	// Invoke middleware on handler.
+//	resp, err := stack.HandleMiddleware(ctx, req.Input, clientHandler)
 package middleware
@@ -13,7 +13,7 @@ import (
 // Steps are composed as middleware around the underlying handler in the
 // following order:
 //
-//   Initialize -> Serialize -> Build -> Finalize -> Deserialize -> Handler
+//	Initialize -> Serialize -> Build -> Finalize -> Deserialize -> Handler
 //
 // Any middleware within the chain may choose to stop and return an error or
 // response. Since the middleware decorate the handler like a call stack, each
@@ -21,7 +21,7 @@ import (
 // Middleware that does not need to react to an input, or result must forward
 // along the input down the chain, or return the result back up the chain.
 //
-//   Initialize <- Serialize -> Build -> Finalize <- Deserialize <- Handler
+//	Initialize <- Serialize -> Build -> Finalize <- Deserialize <- Handler
 type Stack struct {
 	// Initialize prepares the input, and sets any default parameters as
 	// needed, (e.g. idempotency token, and presigned URLs).
@@ -11,17 +11,17 @@ period for each retry attempt using a randomization function that grows exponent

 NextBackOff() is calculated using the following formula:

- randomized interval =
-     RetryInterval * (random value in range [1 - RandomizationFactor, 1 + RandomizationFactor])
+	randomized interval =
+	    RetryInterval * (random value in range [1 - RandomizationFactor, 1 + RandomizationFactor])

 In other words NextBackOff() will range between the randomization factor
 percentage below and above the retry interval.

 For example, given the following parameters:

- RetryInterval = 2
- RandomizationFactor = 0.5
- Multiplier = 2
+	RetryInterval = 2
+	RandomizationFactor = 0.5
+	Multiplier = 2

 the actual backoff period used in the next retry attempt will range between 1 and 3 seconds,
 multiplied by the exponential, that is, between 2 and 6 seconds.
@@ -36,18 +36,18 @@ The elapsed time can be reset by calling Reset().
 Example: Given the following default arguments, for 10 tries the sequence will be,
 and assuming we go over the MaxElapsedTime on the 10th try:

- Request #  RetryInterval (seconds)  Randomized Interval (seconds)
+	Request #  RetryInterval (seconds)  Randomized Interval (seconds)

-  1          0.5                     [0.25,   0.75]
-  2          0.75                    [0.375,  1.125]
-  3          1.125                   [0.562,  1.687]
-  4          1.687                   [0.8435, 2.53]
-  5          2.53                    [1.265,  3.795]
-  6          3.795                   [1.897,  5.692]
-  7          5.692                   [2.846,  8.538]
-  8          8.538                   [4.269, 12.807]
-  9         12.807                   [6.403, 19.210]
- 10         19.210                   backoff.Stop
+	 1          0.5                     [0.25,   0.75]
+	 2          0.75                    [0.375,  1.125]
+	 3          1.125                   [0.562,  1.687]
+	 4          1.687                   [0.8435, 2.53]
+	 5          2.53                    [1.265,  3.795]
+	 6          3.795                   [1.897,  5.692]
+	 7          5.692                   [2.846,  8.538]
+	 8          8.538                   [4.269, 12.807]
+	 9         12.807                   [6.403, 19.210]
+	10         19.210                   backoff.Stop

 Note: Implementation is not thread-safe.
 */
@@ -167,7 +167,8 @@ func (b *ExponentialBackOff) Reset() {
 }

 // NextBackOff calculates the next backoff interval using the formula:
-// 	Randomized interval = RetryInterval * (1 ± RandomizationFactor)
+//
+//	Randomized interval = RetryInterval * (1 ± RandomizationFactor)
 func (b *ExponentialBackOff) NextBackOff() time.Duration {
 	// Make sure we have not gone over the maximum elapsed time.
 	elapsed := b.GetElapsedTime()
@@ -200,7 +201,8 @@ func (b *ExponentialBackOff) incrementCurrentInterval() {
 }

 // Returns a random value from the following interval:
-// 	[currentInterval - randomizationFactor * currentInterval, currentInterval + randomizationFactor * currentInterval].
+//
+//	[currentInterval - randomizationFactor * currentInterval, currentInterval + randomizationFactor * currentInterval].
 func getRandomValueFromInterval(randomizationFactor, random float64, currentInterval time.Duration) time.Duration {
 	if randomizationFactor == 0 {
 		return currentInterval // make sure no randomness is used when randomizationFactor is 0.
@@ -18,6 +18,7 @@
 // tag is deprecated and thus should not be used.
 // Go versions prior to 1.4 are disabled because they use a different layout
 // for interfaces which make the implementation of unsafeReflectValue more complex.
+//go:build !js && !appengine && !safe && !disableunsafe && go1.4
 // +build !js,!appengine,!safe,!disableunsafe,go1.4

 package spew
@@ -16,6 +16,7 @@
 // when the code is running on Google App Engine, compiled by GopherJS, or
 // "-tags safe" is added to the go build command line.  The "disableunsafe"
 // tag is deprecated and thus should not be used.
+//go:build js || appengine || safe || disableunsafe || !go1.4
 // +build js appengine safe disableunsafe !go1.4

 package spew
@@ -254,15 +254,15 @@ pointer addresses used to indirect to the final value.  It provides the
 following features over the built-in printing facilities provided by the fmt
 package:

-	* Pointers are dereferenced and followed
-	* Circular data structures are detected and handled properly
-	* Custom Stringer/error interfaces are optionally invoked, including
-	  on unexported types
-	* Custom types which only implement the Stringer/error interfaces via
-	  a pointer receiver are optionally invoked when passing non-pointer
-	  variables
-	* Byte arrays and slices are dumped like the hexdump -C command which
-	  includes offsets, byte values in hex, and ASCII output
+  - Pointers are dereferenced and followed
+  - Circular data structures are detected and handled properly
+  - Custom Stringer/error interfaces are optionally invoked, including
+    on unexported types
+  - Custom types which only implement the Stringer/error interfaces via
+    a pointer receiver are optionally invoked when passing non-pointer
+    variables
+  - Byte arrays and slices are dumped like the hexdump -C command which
+    includes offsets, byte values in hex, and ASCII output

 The configuration options are controlled by modifying the public members
 of c.  See ConfigState for options documentation.
@@ -295,12 +295,12 @@ func (c *ConfigState) convertArgs(args []interface{}) (formatters []interface{})

 // NewDefaultConfig returns a ConfigState with the following default settings.
 //
-// 	Indent: " "
-// 	MaxDepth: 0
-// 	DisableMethods: false
-// 	DisablePointerMethods: false
-// 	ContinueOnMethod: false
-// 	SortKeys: false
+//	Indent: " "
+//	MaxDepth: 0
+//	DisableMethods: false
+//	DisablePointerMethods: false
+//	ContinueOnMethod: false
+//	SortKeys: false
 func NewDefaultConfig() *ConfigState {
 	return &ConfigState{Indent: " "}
 }
@@ -21,35 +21,36 @@ debugging.
 A quick overview of the additional features spew provides over the built-in
 printing facilities for Go data types are as follows:

-	* Pointers are dereferenced and followed
-	* Circular data structures are detected and handled properly
-	* Custom Stringer/error interfaces are optionally invoked, including
-	  on unexported types
-	* Custom types which only implement the Stringer/error interfaces via
-	  a pointer receiver are optionally invoked when passing non-pointer
-	  variables
-	* Byte arrays and slices are dumped like the hexdump -C command which
-	  includes offsets, byte values in hex, and ASCII output (only when using
-	  Dump style)
+  - Pointers are dereferenced and followed
+  - Circular data structures are detected and handled properly
+  - Custom Stringer/error interfaces are optionally invoked, including
+    on unexported types
+  - Custom types which only implement the Stringer/error interfaces via
+    a pointer receiver are optionally invoked when passing non-pointer
+    variables
+  - Byte arrays and slices are dumped like the hexdump -C command which
+    includes offsets, byte values in hex, and ASCII output (only when using
+    Dump style)

 There are two different approaches spew allows for dumping Go data structures:

-	* Dump style which prints with newlines, customizable indentation,
-	  and additional debug information such as types and all pointer addresses
-	  used to indirect to the final value
-	* A custom Formatter interface that integrates cleanly with the standard fmt
-	  package and replaces %v, %+v, %#v, and %#+v to provide inline printing
-	  similar to the default %v while providing the additional functionality
-	  outlined above and passing unsupported format verbs such as %x and %q
-	  along to fmt
+  - Dump style which prints with newlines, customizable indentation,
+    and additional debug information such as types and all pointer addresses
+    used to indirect to the final value
+  - A custom Formatter interface that integrates cleanly with the standard fmt
+    package and replaces %v, %+v, %#v, and %#+v to provide inline printing
+    similar to the default %v while providing the additional functionality
+    outlined above and passing unsupported format verbs such as %x and %q
+    along to fmt

-Quick Start
+# Quick Start

 This section demonstrates how to quickly get started with spew.  See the
 sections below for further details on formatting and configuration options.

 To dump a variable with full newlines, indentation, type, and pointer
 information use Dump, Fdump, or Sdump:
+
 	spew.Dump(myVar1, myVar2, ...)
 	spew.Fdump(someWriter, myVar1, myVar2, ...)
 	str := spew.Sdump(myVar1, myVar2, ...)
@@ -58,12 +59,13 @@ Alternatively, if you would prefer to use format strings with a compacted inline
 printing style, use the convenience wrappers Printf, Fprintf, etc with
 %v (most compact), %+v (adds pointer addresses), %#v (adds types), or
 %#+v (adds types and pointer addresses):
+
 	spew.Printf("myVar1: %v -- myVar2: %+v", myVar1, myVar2)
 	spew.Printf("myVar3: %#v -- myVar4: %#+v", myVar3, myVar4)
 	spew.Fprintf(someWriter, "myVar1: %v -- myVar2: %+v", myVar1, myVar2)
 	spew.Fprintf(someWriter, "myVar3: %#v -- myVar4: %#+v", myVar3, myVar4)

-Configuration Options
+# Configuration Options

 Configuration of spew is handled by fields in the ConfigState type.  For
 convenience, all of the top-level functions use a global state available
@@ -74,51 +76,52 @@ equivalent to the top-level functions.  This allows concurrent configuration
 options.  See the ConfigState documentation for more details.

 The following configuration options are available:
-	* Indent
-		String to use for each indentation level for Dump functions.
-		It is a single space by default.  A popular alternative is "\t".

-	* MaxDepth
-		Maximum number of levels to descend into nested data structures.
-		There is no limit by default.
+  - Indent
+    String to use for each indentation level for Dump functions.
+    It is a single space by default.  A popular alternative is "\t".

-	* DisableMethods
-		Disables invocation of error and Stringer interface methods.
-		Method invocation is enabled by default.
+  - MaxDepth
+    Maximum number of levels to descend into nested data structures.
+    There is no limit by default.

-	* DisablePointerMethods
-		Disables invocation of error and Stringer interface methods on types
-		which only accept pointer receivers from non-pointer variables.
-		Pointer method invocation is enabled by default.
+  - DisableMethods
+    Disables invocation of error and Stringer interface methods.
+    Method invocation is enabled by default.

-	* DisablePointerAddresses
-		DisablePointerAddresses specifies whether to disable the printing of
-		pointer addresses. This is useful when diffing data structures in tests.
+  - DisablePointerMethods
+    Disables invocation of error and Stringer interface methods on types
+    which only accept pointer receivers from non-pointer variables.
+    Pointer method invocation is enabled by default.

-	* DisableCapacities
-		DisableCapacities specifies whether to disable the printing of
-		capacities for arrays, slices, maps and channels. This is useful when
-		diffing data structures in tests.
+  - DisablePointerAddresses
+    DisablePointerAddresses specifies whether to disable the printing of
+    pointer addresses. This is useful when diffing data structures in tests.

-	* ContinueOnMethod
-		Enables recursion into types after invoking error and Stringer interface
-		methods. Recursion after method invocation is disabled by default.
+  - DisableCapacities
+    DisableCapacities specifies whether to disable the printing of
+    capacities for arrays, slices, maps and channels. This is useful when
+    diffing data structures in tests.

-	* SortKeys
-		Specifies map keys should be sorted before being printed. Use
-		this to have a more deterministic, diffable output.  Note that
-		only native types (bool, int, uint, floats, uintptr and string)
-		and types which implement error or Stringer interfaces are
-		supported with other types sorted according to the
-		reflect.Value.String() output which guarantees display
-		stability.  Natural map order is used by default.
+  - ContinueOnMethod
+    Enables recursion into types after invoking error and Stringer interface
+    methods. Recursion after method invocation is disabled by default.

-	* SpewKeys
-		Specifies that, as a last resort attempt, map keys should be
-		spewed to strings and sorted by those strings.  This is only
-		considered if SortKeys is true.
+  - SortKeys
+    Specifies map keys should be sorted before being printed. Use
+    this to have a more deterministic, diffable output.  Note that
+    only native types (bool, int, uint, floats, uintptr and string)
+    and types which implement error or Stringer interfaces are
+    supported with other types sorted according to the
+    reflect.Value.String() output which guarantees display
+    stability.  Natural map order is used by default.

-Dump Usage
+  - SpewKeys
+    Specifies that, as a last resort attempt, map keys should be
+    spewed to strings and sorted by those strings.  This is only
+    considered if SortKeys is true.
+
+# Dump Usage

 Simply call spew.Dump with a list of variables you want to dump:

@@ -133,7 +136,7 @@ A third option is to call spew.Sdump to get the formatted output as a string:

 	str := spew.Sdump(myVar1, myVar2, ...)

-Sample Dump Output
+# Sample Dump Output

 See the Dump example for details on the setup of the types and variables being
 shown here.
@@ -150,13 +153,14 @@ shown here.

 Byte (and uint8) arrays and slices are displayed uniquely like the hexdump -C
 command as shown.
+
 	([]uint8) (len=32 cap=32) {
 	 00000000  11 12 13 14 15 16 17 18  19 1a 1b 1c 1d 1e 1f 20  |............... |
 	 00000010  21 22 23 24 25 26 27 28  29 2a 2b 2c 2d 2e 2f 30  |!"#$%&'()*+,-./0|
 	 00000020  31 32                                             |12|
 	}

-Custom Formatter
+# Custom Formatter

 Spew provides a custom formatter that implements the fmt.Formatter interface
 so that it integrates cleanly with standard fmt package printing functions. The
@@ -170,7 +174,7 @@ standard fmt package for formatting.  In addition, the custom formatter ignores
 the width and precision arguments (however they will still work on the format
 specifiers not handled by the custom formatter).

-Custom Formatter Usage
+# Custom Formatter Usage

 The simplest way to make use of the spew custom formatter is to call one of the
 convenience functions such as spew.Printf, spew.Println, or spew.Printf.  The
@@ -184,15 +188,17 @@ functions have syntax you are most likely already familiar with:

 See the Index for the full list convenience functions.

-Sample Formatter Output
+# Sample Formatter Output

 Double pointer to a uint8:
+
 	  %v: <**>5
 	 %+v: <**>(0xf8400420d0->0xf8400420c8)5
 	 %#v: (**uint8)5
 	%#+v: (**uint8)(0xf8400420d0->0xf8400420c8)5

 Pointer to circular struct with a uint8 field and a pointer to itself:
+
 	  %v: <*>{1 <*><shown>}
 	 %+v: <*>(0xf84003e260){ui8:1 c:<*>(0xf84003e260)<shown>}
 	 %#v: (*main.circular){ui8:(uint8)1 c:(*main.circular)<shown>}
@@ -201,7 +207,7 @@ Pointer to circular struct with a uint8 field and a pointer to itself:
 See the Printf example for details on the setup of variables being shown
 here.

-Errors
+# Errors

 Since it is possible for custom Stringer/error interfaces to panic, spew
 detects them and handles them internally by printing the panic information
@@ -488,15 +488,15 @@ pointer addresses used to indirect to the final value.  It provides the
 following features over the built-in printing facilities provided by the fmt
 package:

-	* Pointers are dereferenced and followed
-	* Circular data structures are detected and handled properly
-	* Custom Stringer/error interfaces are optionally invoked, including
-	  on unexported types
-	* Custom types which only implement the Stringer/error interfaces via
-	  a pointer receiver are optionally invoked when passing non-pointer
-	  variables
-	* Byte arrays and slices are dumped like the hexdump -C command which
-	  includes offsets, byte values in hex, and ASCII output
+  - Pointers are dereferenced and followed
+  - Circular data structures are detected and handled properly
+  - Custom Stringer/error interfaces are optionally invoked, including
+    on unexported types
+  - Custom types which only implement the Stringer/error interfaces via
+    a pointer receiver are optionally invoked when passing non-pointer
+    variables
+  - Byte arrays and slices are dumped like the hexdump -C command which
+    includes offsets, byte values in hex, and ASCII output

 The configuration options are controlled by an exported package global,
 spew.Config.  See ConfigState for options documentation.
@@ -1,4 +1,6 @@
+//go:build go1.8
 // +build go1.8
+
 // Code generated by "httpsnoop/codegen"; DO NOT EDIT.

 package httpsnoop
@@ -1,4 +1,6 @@
+//go:build !go1.8
 // +build !go1.8
+
 // Code generated by "httpsnoop/codegen"; DO NOT EDIT.

 package httpsnoop
@@ -1,3 +1,4 @@
+//go:build windows
 // +build windows

 package ole
@@ -1,3 +1,4 @@
+//go:build !windows
 // +build !windows

 package ole
@@ -1,3 +1,4 @@
+//go:build !windows
 // +build !windows

 package ole
@@ -1,3 +1,4 @@
+//go:build windows
 // +build windows

 package ole
@@ -108,9 +108,9 @@ type GUID struct {
 //
 // The supplied string may be in any of these formats:
 //
-//  XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-//  XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX
-//  {XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX}
+//	XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
+//	XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX
+//	{XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX}
 //
 // The conversion of the supplied string is not case-sensitive.
 func NewGUID(guid string) *GUID {
@@ -216,11 +216,11 @@ func decodeHexChar(c byte) (byte, bool) {

 // String converts the GUID to string form. It will adhere to this pattern:
 //
-//  {XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX}
+//	{XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX}
 //
 // If the GUID is nil, the string representation of an empty GUID is returned:
 //
-//  {00000000-0000-0000-0000-000000000000}
+//	{00000000-0000-0000-0000-000000000000}
 func (guid *GUID) String() string {
 	if guid == nil {
 		return emptyGUID
@@ -1,3 +1,4 @@
+//go:build !windows
 // +build !windows

 package ole
@@ -1,3 +1,4 @@
+//go:build windows
 // +build windows

 package ole
@@ -1,3 +1,4 @@
+//go:build !windows
 // +build !windows

 package ole
@@ -1,3 +1,4 @@
+//go:build windows
 // +build windows

 package ole
@@ -1,3 +1,4 @@
+//go:build !windows
 // +build !windows

 package ole
@@ -1,3 +1,4 @@
+//go:build !windows
 // +build !windows

 package ole
@@ -1,3 +1,4 @@
+//go:build windows
 // +build windows

 package ole
@@ -1,3 +1,4 @@
+//go:build !windows
 // +build !windows

 package ole
@@ -1,3 +1,4 @@
+//go:build windows
 // +build windows

 package ole
@@ -1,3 +1,4 @@
+//go:build !windows
 // +build !windows

 package ole
@@ -1,3 +1,4 @@
+//go:build windows
 // +build windows

 package ole
@@ -1,3 +1,4 @@
+//go:build !windows
 // +build !windows

 package ole
@@ -1,3 +1,4 @@
+//go:build windows
 // +build windows

 package ole
@@ -1,3 +1,4 @@
+//go:build !windows
 // +build !windows

 package ole
@@ -1,3 +1,4 @@
+//go:build windows
 // +build windows

 package ole
@@ -1,3 +1,4 @@
+//go:build windows
 // +build windows

 package oleutil
@@ -1,3 +1,4 @@
+//go:build !windows
 // +build !windows

 package oleutil
@@ -1,3 +1,4 @@
+//go:build windows
 // +build windows

 package oleutil
@@ -1,6 +1,7 @@
 // This file is here so go get succeeds as without it errors with:
 // no buildable Go source files in ...
 //
+//go:build !windows
 // +build !windows

 package oleutil
@@ -1,3 +1,4 @@
+//go:build !windows
 // +build !windows

 package ole
@@ -1,3 +1,4 @@
+//go:build windows
 // +build windows

 package ole
@@ -84,7 +84,7 @@ func (sac *SafeArrayConversion) ToValueArray() (values []interface{}) {
 			safeArrayGetElement(sac.Array, i, unsafe.Pointer(&v))
 			values[i] = v
 		case VT_BSTR:
-			v , _ := safeArrayGetElementString(sac.Array, i)
+			v, _ := safeArrayGetElementString(sac.Array, i)
 			values[i] = v
 		case VT_VARIANT:
 			var v VARIANT
@@ -1,3 +1,4 @@
+//go:build windows
 // +build windows

 package ole
@@ -1,3 +1,4 @@
+//go:build windows
 // +build windows

 package ole
@@ -1,3 +1,4 @@
+//go:build 386
 // +build 386

 package ole
@@ -1,3 +1,4 @@
+//go:build amd64
 // +build amd64

 package ole
@@ -1,3 +1,4 @@
+//go:build arm
 // +build arm

 package ole
@@ -1,3 +1,4 @@
+//go:build windows && 386
 // +build windows,386

 package ole
@@ -1,3 +1,4 @@
+//go:build windows && amd64
 // +build windows,amd64

 package ole
@@ -1,3 +1,4 @@
+//go:build windows && arm
 // +build windows,arm

 package ole
@@ -1,3 +1,4 @@
+//go:build ppc64le
 // +build ppc64le

 package ole
@@ -1,3 +1,4 @@
+//go:build s390x
 // +build s390x

 package ole
@@ -1,3 +1,4 @@
+//go:build windows
 // +build windows

 package ole
@@ -1,3 +1,4 @@
+//go:build !windows
 // +build !windows

 package ole
@@ -39,35 +39,35 @@ for a protocol buffer variable v:

  - Names are turned from camel_case to CamelCase for export.
  - There are no methods on v to set fields; just treat
-	them as structure fields.
+    them as structure fields.
  - There are getters that return a field's value if set,
-	and return the field's default value if unset.
-	The getters work even if the receiver is a nil message.
+    and return the field's default value if unset.
+    The getters work even if the receiver is a nil message.
  - The zero value for a struct is its correct initialization state.
-	All desired fields must be set before marshaling.
+    All desired fields must be set before marshaling.
  - A Reset() method will restore a protobuf struct to its zero state.
  - Non-repeated fields are pointers to the values; nil means unset.
-	That is, optional or required field int32 f becomes F *int32.
+    That is, optional or required field int32 f becomes F *int32.
  - Repeated fields are slices.
  - Helper functions are available to aid the setting of fields.
-	msg.Foo = proto.String("hello") // set field
+    msg.Foo = proto.String("hello") // set field
  - Constants are defined to hold the default values of all fields that
-	have them.  They have the form Default_StructName_FieldName.
-	Because the getter methods handle defaulted values,
-	direct use of these constants should be rare.
+    have them.  They have the form Default_StructName_FieldName.
+    Because the getter methods handle defaulted values,
+    direct use of these constants should be rare.
  - Enums are given type names and maps from names to values.
-	Enum values are prefixed by the enclosing message's name, or by the
-	enum's type name if it is a top-level enum. Enum types have a String
-	method, and a Enum method to assist in message construction.
+    Enum values are prefixed by the enclosing message's name, or by the
+    enum's type name if it is a top-level enum. Enum types have a String
+    method, and a Enum method to assist in message construction.
  - Nested messages, groups and enums have type names prefixed with the name of
-	the surrounding message type.
+    the surrounding message type.
  - Extensions are given descriptor names that start with E_,
-	followed by an underscore-delimited list of the nested messages
-	that contain it (if any) followed by the CamelCased name of the
-	extension field itself.  HasExtension, ClearExtension, GetExtension
-	and SetExtension are functions for manipulating extensions.
+    followed by an underscore-delimited list of the nested messages
+    that contain it (if any) followed by the CamelCased name of the
+    extension field itself.  HasExtension, ClearExtension, GetExtension
+    and SetExtension are functions for manipulating extensions.
  - Oneof field sets are given a single field in their message,
-	with distinguished wrapper types for each possible field value.
+    with distinguished wrapper types for each possible field value.
  - Marshal and Unmarshal are functions to encode and decode the wire format.

 When the .proto file specifies `syntax="proto3"`, there are some differences:
@@ -29,6 +29,7 @@
 // (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
 // OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

+//go:build purego || appengine || js
 // +build purego appengine js

 // This file contains an implementation of proto field accesses using package reflect.
@@ -26,6 +26,7 @@
 // (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
 // OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

+//go:build purego || appengine || js
 // +build purego appengine js

 // This file contains an implementation of proto field accesses using package reflect.
@@ -29,6 +29,7 @@
 // (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
 // OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

+//go:build !purego && !appengine && !js
 // +build !purego,!appengine,!js

 // This file contains the implementation of the proto field accesses using package unsafe.
@@ -26,6 +26,7 @@
 // (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
 // OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

+//go:build !purego && !appengine && !js
 // +build !purego,!appengine,!js

 // This file contains the implementation of the proto field accesses using package unsafe.
@@ -2004,12 +2004,14 @@ func makeUnmarshalMap(f *reflect.StructField) unmarshaler {

 // makeUnmarshalOneof makes an unmarshaler for oneof fields.
 // for:
-// message Msg {
-//   oneof F {
-//     int64 X = 1;
-//     float64 Y = 2;
-//   }
-// }
+//
+//	message Msg {
+//	  oneof F {
+//	    int64 X = 1;
+//	    float64 Y = 2;
+//	  }
+//	}
+//
 // typ is the type of the concrete entry for a oneof case (e.g. Msg_X).
 // ityp is the interface type of the oneof field (e.g. isMsg_F).
 // unmarshal is the unmarshaler for the base type of the oneof case (e.g. int64).
@@ -0,0 +1,3 @@
+# This source code refers to The Go Authors for copyright purposes.
+# The master list of authors is in the main Go distribution,
+# visible at http://tip.golang.org/AUTHORS.
@@ -0,0 +1,3 @@
+# This source code was written by the Go contributors.
+# The master list of contributors is in the main Go distribution,
+# visible at http://tip.golang.org/CONTRIBUTORS.
@@ -0,0 +1,28 @@
+Copyright 2010 The Go Authors.  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,62 @@
+// Code generated by protoc-gen-go. DO NOT EDIT.
+// source: github.com/golang/protobuf/ptypes/empty/empty.proto
+
+package empty
+
+import (
+	protoreflect "google.golang.org/protobuf/reflect/protoreflect"
+	protoimpl "google.golang.org/protobuf/runtime/protoimpl"
+	emptypb "google.golang.org/protobuf/types/known/emptypb"
+	reflect "reflect"
+)
+
+// Symbols defined in public import of google/protobuf/empty.proto.
+
+type Empty = emptypb.Empty
+
+var File_github_com_golang_protobuf_ptypes_empty_empty_proto protoreflect.FileDescriptor
+
+var file_github_com_golang_protobuf_ptypes_empty_empty_proto_rawDesc = []byte{
+	0x0a, 0x33, 0x67, 0x69, 0x74, 0x68, 0x75, 0x62, 0x2e, 0x63, 0x6f, 0x6d, 0x2f, 0x67, 0x6f, 0x6c,
+	0x61, 0x6e, 0x67, 0x2f, 0x70, 0x72, 0x6f, 0x74, 0x6f, 0x62, 0x75, 0x66, 0x2f, 0x70, 0x74, 0x79,
+	0x70, 0x65, 0x73, 0x2f, 0x65, 0x6d, 0x70, 0x74, 0x79, 0x2f, 0x65, 0x6d, 0x70, 0x74, 0x79, 0x2e,
+	0x70, 0x72, 0x6f, 0x74, 0x6f, 0x1a, 0x1b, 0x67, 0x6f, 0x6f, 0x67, 0x6c, 0x65, 0x2f, 0x70, 0x72,
+	0x6f, 0x74, 0x6f, 0x62, 0x75, 0x66, 0x2f, 0x65, 0x6d, 0x70, 0x74, 0x79, 0x2e, 0x70, 0x72, 0x6f,
+	0x74, 0x6f, 0x42, 0x2f, 0x5a, 0x2d, 0x67, 0x69, 0x74, 0x68, 0x75, 0x62, 0x2e, 0x63, 0x6f, 0x6d,
+	0x2f, 0x67, 0x6f, 0x6c, 0x61, 0x6e, 0x67, 0x2f, 0x70, 0x72, 0x6f, 0x74, 0x6f, 0x62, 0x75, 0x66,
+	0x2f, 0x70, 0x74, 0x79, 0x70, 0x65, 0x73, 0x2f, 0x65, 0x6d, 0x70, 0x74, 0x79, 0x3b, 0x65, 0x6d,
+	0x70, 0x74, 0x79, 0x50, 0x00, 0x62, 0x06, 0x70, 0x72, 0x6f, 0x74, 0x6f, 0x33,
+}
+
+var file_github_com_golang_protobuf_ptypes_empty_empty_proto_goTypes = []interface{}{}
+var file_github_com_golang_protobuf_ptypes_empty_empty_proto_depIdxs = []int32{
+	0, // [0:0] is the sub-list for method output_type
+	0, // [0:0] is the sub-list for method input_type
+	0, // [0:0] is the sub-list for extension type_name
+	0, // [0:0] is the sub-list for extension extendee
+	0, // [0:0] is the sub-list for field type_name
+}
+
+func init() { file_github_com_golang_protobuf_ptypes_empty_empty_proto_init() }
+func file_github_com_golang_protobuf_ptypes_empty_empty_proto_init() {
+	if File_github_com_golang_protobuf_ptypes_empty_empty_proto != nil {
+		return
+	}
+	type x struct{}
+	out := protoimpl.TypeBuilder{
+		File: protoimpl.DescBuilder{
+			GoPackagePath: reflect.TypeOf(x{}).PkgPath(),
+			RawDescriptor: file_github_com_golang_protobuf_ptypes_empty_empty_proto_rawDesc,
+			NumEnums:      0,
+			NumMessages:   0,
+			NumExtensions: 0,
+			NumServices:   0,
+		},
+		GoTypes:           file_github_com_golang_protobuf_ptypes_empty_empty_proto_goTypes,
+		DependencyIndexes: file_github_com_golang_protobuf_ptypes_empty_empty_proto_depIdxs,
+	}.Build()
+	File_github_com_golang_protobuf_ptypes_empty_empty_proto = out.File
+	file_github_com_golang_protobuf_ptypes_empty_empty_proto_rawDesc = nil
+	file_github_com_golang_protobuf_ptypes_empty_empty_proto_goTypes = nil
+	file_github_com_golang_protobuf_ptypes_empty_empty_proto_depIdxs = nil
+}
@@ -42,7 +42,7 @@ func NewDCESecurity(domain Domain, id uint32) (UUID, error) {
 // NewDCEPerson returns a DCE Security (Version 2) UUID in the person
 // domain with the id returned by os.Getuid.
 //
-//  NewDCESecurity(Person, uint32(os.Getuid()))
+//	NewDCESecurity(Person, uint32(os.Getuid()))
 func NewDCEPerson() (UUID, error) {
 	return NewDCESecurity(Person, uint32(os.Getuid()))
 }
@@ -50,7 +50,7 @@ func NewDCEPerson() (UUID, error) {
 // NewDCEGroup returns a DCE Security (Version 2) UUID in the group
 // domain with the id returned by os.Getgid.
 //
-//  NewDCESecurity(Group, uint32(os.Getgid()))
+//	NewDCESecurity(Group, uint32(os.Getgid()))
 func NewDCEGroup() (UUID, error) {
 	return NewDCESecurity(Group, uint32(os.Getgid()))
 }
@@ -45,7 +45,7 @@ func NewHash(h hash.Hash, space UUID, data []byte, version int) 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)
+//	NewHash(md5.New(), space, data, 3)
 func NewMD5(space UUID, data []byte) UUID {
 	return NewHash(md5.New(), space, data, 3)
 }
@@ -53,7 +53,7 @@ func NewMD5(space UUID, data []byte) UUID {
 // 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)
+//	NewHash(sha1.New(), space, data, 5)
 func NewSHA1(space UUID, data []byte) UUID {
 	return NewHash(sha1.New(), space, data, 5)
 }
@@ -2,6 +2,7 @@
 // Use of this source code is governed by a BSD-style
 // license that can be found in the LICENSE file.

+//go:build js
 // +build js

 package uuid
@@ -2,6 +2,7 @@
 // Use of this source code is governed by a BSD-style
 // license that can be found in the LICENSE file.

+//go:build !js
 // +build !js

 package uuid
@@ -17,15 +17,14 @@ var jsonNull = []byte("null")
 // NullUUID implements the SQL driver.Scanner interface so
 // it can be used as a scan destination:
 //
-//  var u uuid.NullUUID
-//  err := db.QueryRow("SELECT name FROM foo WHERE id=?", id).Scan(&u)
-//  ...
-//  if u.Valid {
-//     // use u.UUID
-//  } else {
-//     // NULL value
-//  }
-//
+//	var u uuid.NullUUID
+//	err := db.QueryRow("SELECT name FROM foo WHERE id=?", id).Scan(&u)
+//	...
+//	if u.Valid {
+//	   // use u.UUID
+//	} else {
+//	   // NULL value
+//	}
 type NullUUID struct {
 	UUID  UUID
 	Valid bool // Valid is true if UUID is not NULL
@@ -187,10 +187,12 @@ func Must(uuid UUID, err error) UUID {
 }

 // Validate returns an error if s is not a properly formatted UUID in one of the following formats:
-//   xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
-//   urn:uuid:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
-//   xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
-//   {xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx}
+//
+//	xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
+//	urn:uuid:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
+//	xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
+//	{xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx}
+//
 // It returns an error if the format is invalid, otherwise nil.
 func Validate(s string) error {
 	switch len(s) {
@@ -9,7 +9,7 @@ import "io"
 // New creates a new random UUID or panics.  New is equivalent to
 // the expression
 //
-//    uuid.Must(uuid.NewRandom())
+//	uuid.Must(uuid.NewRandom())
 func New() UUID {
 	return Must(NewRandom())
 }
@@ -17,7 +17,7 @@ func New() UUID {
 // NewString creates a new random UUID and returns it as a string or panics.
 // NewString is equivalent to the expression
 //
-//    uuid.New().String()
+//	uuid.New().String()
 func NewString() string {
 	return Must(NewRandom()).String()
 }
@@ -31,11 +31,11 @@ func NewString() string {
 //
 // 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.
+//	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) {
 	if !poolEnabled {
 		return NewRandomFromReader(rander)
@@ -19,10 +19,11 @@ var typeSQLScanner = reflect.TypeOf((*sql.Scanner)(nil)).Elem()
 // slice of any dimension.
 //
 // For example:
-//  db.Query(`SELECT * FROM t WHERE id = ANY($1)`, pq.Array([]int{235, 401}))
 //
-//  var x []sql.NullInt64
-//  db.QueryRow(`SELECT ARRAY[235, 401]`).Scan(pq.Array(&x))
+//	db.Query(`SELECT * FROM t WHERE id = ANY($1)`, pq.Array([]int{235, 401}))
+//
+//	var x []sql.NullInt64
+//	db.QueryRow(`SELECT ARRAY[235, 401]`).Scan(pq.Array(&x))
 //
 // Scanning multi-dimensional arrays is not supported.  Arrays where the lower
 // bound is not one (such as `[0:0]={1}') are not supported.
@@ -27,9 +27,7 @@ You can also connect to a database using a URL. For example:
 	connStr := "postgres://pqgotest:password@localhost/pqgotest?sslmode=verify-full"
 	db, err := sql.Open("postgres", connStr)

-
-Connection String Parameters
-
+# Connection String Parameters

 Similarly to libpq, when establishing a connection using pq you are expected to
 supply a connection string containing zero or more parameters.
@@ -42,42 +40,42 @@ them in the options parameter.
 For compatibility with libpq, the following special connection parameters are
 supported:

-	* dbname - The name of the database to connect to
-	* user - The user to sign in as
-	* password - The user's password
-	* host - The host to connect to. Values that start with / are for unix
-	  domain sockets. (default is localhost)
-	* port - The port to bind to. (default is 5432)
-	* sslmode - Whether or not to use SSL (default is require, this is not
-	  the default for libpq)
-	* fallback_application_name - An application_name to fall back to if one isn't provided.
-	* connect_timeout - Maximum wait for connection, in seconds. Zero or
-	  not specified means wait indefinitely.
-	* sslcert - Cert file location. The file must contain PEM encoded data.
-	* sslkey - Key file location. The file must contain PEM encoded data.
-	* sslrootcert - The location of the root certificate file. The file
-	  must contain PEM encoded data.
+  - dbname - The name of the database to connect to
+  - user - The user to sign in as
+  - password - The user's password
+  - host - The host to connect to. Values that start with / are for unix
+    domain sockets. (default is localhost)
+  - port - The port to bind to. (default is 5432)
+  - sslmode - Whether or not to use SSL (default is require, this is not
+    the default for libpq)
+  - fallback_application_name - An application_name to fall back to if one isn't provided.
+  - connect_timeout - Maximum wait for connection, in seconds. Zero or
+    not specified means wait indefinitely.
+  - sslcert - Cert file location. The file must contain PEM encoded data.
+  - sslkey - Key file location. The file must contain PEM encoded data.
+  - sslrootcert - The location of the root certificate file. The file
+    must contain PEM encoded data.

 Valid values for sslmode are:

-	* disable - No SSL
-	* require - Always SSL (skip verification)
-	* verify-ca - Always SSL (verify that the certificate presented by the
-	  server was signed by a trusted CA)
-	* verify-full - Always SSL (verify that the certification presented by
-	  the server was signed by a trusted CA and the server host name
-	  matches the one in the certificate)
+  - disable - No SSL
+  - require - Always SSL (skip verification)
+  - verify-ca - Always SSL (verify that the certificate presented by the
+    server was signed by a trusted CA)
+  - verify-full - Always SSL (verify that the certification presented by
+    the server was signed by a trusted CA and the server host name
+    matches the one in the certificate)

 See http://www.postgresql.org/docs/current/static/libpq-connect.html#LIBPQ-CONNSTRING
 for more information about connection string parameters.

 Use single quotes for values that contain whitespace:

-    "user=pqgotest password='with spaces'"
+	"user=pqgotest password='with spaces'"

 A backslash will escape the next character in values:

-    "user=space\ man password='it\'s valid'"
+	"user=space\ man password='it\'s valid'"

 Note that the connection parameter client_encoding (which sets the
 text encoding for the connection) may be set but must be "UTF8",
@@ -98,9 +96,7 @@ provided connection parameters.
 The pgpass mechanism as described in http://www.postgresql.org/docs/current/static/libpq-pgpass.html
 is supported, but on Windows PGPASSFILE must be specified explicitly.

-
-Queries
-
+# Queries

 database/sql does not dictate any specific format for parameter
 markers in query strings, and pq uses the Postgres-native ordinal markers,
@@ -125,9 +121,7 @@ For more details on RETURNING, see the Postgres documentation:

 For additional instructions on querying see the documentation for the database/sql package.

-
-Data Types
-
+# Data Types

 Parameters pass through driver.DefaultParameterConverter before they are handled
 by this package. When the binary_parameters connection option is enabled,
@@ -135,30 +129,27 @@ by this package. When the binary_parameters connection option is enabled,

 This package returns the following types for values from the PostgreSQL backend:

-	- integer types smallint, integer, and bigint are returned as int64
-	- floating-point types real and double precision are returned as float64
-	- character types char, varchar, and text are returned as string
-	- temporal types date, time, timetz, timestamp, and timestamptz are
-	  returned as time.Time
-	- the boolean type is returned as bool
-	- the bytea type is returned as []byte
+  - integer types smallint, integer, and bigint are returned as int64
+  - floating-point types real and double precision are returned as float64
+  - character types char, varchar, and text are returned as string
+  - temporal types date, time, timetz, timestamp, and timestamptz are
+    returned as time.Time
+  - the boolean type is returned as bool
+  - the bytea type is returned as []byte

 All other types are returned directly from the backend as []byte values in text format.

-
-Errors
-
+# Errors

 pq may return errors of type *pq.Error which can be interrogated for error details:

-        if err, ok := err.(*pq.Error); ok {
-            fmt.Println("pq error:", err.Code.Name())
-        }
+	if err, ok := err.(*pq.Error); ok {
+	    fmt.Println("pq error:", err.Code.Name())
+	}

 See the pq.Error type for details.

-
-Bulk imports
+# Bulk imports

 You can perform bulk imports by preparing a statement returned by pq.CopyIn (or
 pq.CopyInSchema) in an explicit transaction (sql.Tx). The returned statement
@@ -206,9 +197,7 @@ Usage example:
 		log.Fatal(err)
 	}

-
-Notifications
-
+# Notifications

 PostgreSQL supports a simple publish/subscribe model over database
 connections.  See http://www.postgresql.org/docs/current/static/sql-notify.html
@@ -241,9 +230,7 @@ bytes by the PostgreSQL server.
 You can find a complete, working example of Listener usage at
 https://godoc.org/github.com/lib/pq/example/listen.

-
-Kerberos Support
-
+# Kerberos Support

 If you need support for Kerberos authentication, add the following to your main
 package:
@@ -259,10 +246,10 @@ don't have to download unnecessary dependencies.

 When imported, additional connection string parameters are supported:

-	* krbsrvname - GSS (Kerberos) service name when constructing the
-	  SPN (default is `postgres`). This will be combined with the host
-	  to form the full SPN: `krbsrvname/host`.
-	* krbspn - GSS (Kerberos) SPN. This takes priority over
-	  `krbsrvname` if present.
+  - krbsrvname - GSS (Kerberos) service name when constructing the
+    SPN (default is `postgres`). This will be combined with the host
+    to form the full SPN: `krbsrvname/host`.
+  - krbspn - GSS (Kerberos) SPN. This takes priority over
+    `krbsrvname` if present.
 */
 package pq
@@ -330,11 +330,11 @@ func (l *ListenerConn) sendSimpleQuery(q string) (err error) {

 // ExecSimpleQuery executes a "simple query" (i.e. one with no bindable
 // parameters) on the connection. The possible return values are:
-//   1) "executed" is true; the query was executed to completion on the
-//      database server.  If the query failed, err will be set to the error
-//      returned by the database, otherwise err will be nil.
-//   2) If "executed" is false, the query could not be executed on the remote
-//      server.  err will be non-nil.
+//  1. "executed" is true; the query was executed to completion on the
+//     database server.  If the query failed, err will be set to the error
+//     returned by the database, otherwise err will be nil.
+//  2. If "executed" is false, the query could not be executed on the remote
+//     server.  err will be non-nil.
 //
 // After a call to ExecSimpleQuery has returned an executed=false value, the
 // connection has either been closed or will be closed shortly thereafter, and
@@ -541,12 +541,12 @@ func (l *Listener) NotificationChannel() <-chan *Notification {
 // connection can not be re-established.
 //
 // Listen will only fail in three conditions:
-//   1) The channel is already open.  The returned error will be
-//      ErrChannelAlreadyOpen.
-//   2) The query was executed on the remote server, but PostgreSQL returned an
-//      error message in response to the query.  The returned error will be a
-//      pq.Error containing the information the server supplied.
-//   3) Close is called on the Listener before the request could be completed.
+//  1. The channel is already open.  The returned error will be
+//     ErrChannelAlreadyOpen.
+//  2. The query was executed on the remote server, but PostgreSQL returned an
+//     error message in response to the query.  The returned error will be a
+//     pq.Error containing the information the server supplied.
+//  3. Close is called on the Listener before the request could be completed.
 //
 // The channel name is case-sensitive.
 func (l *Listener) Listen(channel string) error {
@@ -25,7 +25,6 @@
 // Package scram implements a SCRAM-{SHA-1,etc} client per RFC5802.
 //
 // http://tools.ietf.org/html/rfc5802
-//
 package scram

 import (
@@ -43,17 +42,16 @@ import (
 //
 // A Client may be used within a SASL conversation with logic resembling:
 //
-//    var in []byte
-//    var client = scram.NewClient(sha1.New, user, pass)
-//    for client.Step(in) {
-//            out := client.Out()
-//            // send out to server
-//            in := serverOut
-//    }
-//    if client.Err() != nil {
-//            // auth failed
-//    }
-//
+//	var in []byte
+//	var client = scram.NewClient(sha1.New, user, pass)
+//	for client.Step(in) {
+//	        out := client.Out()
+//	        // send out to server
+//	        in := serverOut
+//	}
+//	if client.Err() != nil {
+//	        // auth failed
+//	}
 type Client struct {
 	newHash func() hash.Hash

@@ -73,8 +71,7 @@ type Client struct {
 //
 // For SCRAM-SHA-256, for example, use:
 //
-//    client := scram.NewClient(sha256.New, user, pass)
-//
+//	client := scram.NewClient(sha256.New, user, pass)
 func NewClient(newHash func() hash.Hash, user, pass string) *Client {
 	c := &Client{
 		newHash: newHash,
@@ -30,7 +30,7 @@ import (
 //
 // The following is an example of the contents of Digest types:
 //
-// 	sha256:7173b809ca12ec5dee4506cd86be934c4596dd234ee82c0662eac04a8c2c71dc
+//	sha256:7173b809ca12ec5dee4506cd86be934c4596dd234ee82c0662eac04a8c2c71dc
 //
 // This allows to abstract the digest behind this type and work only in those
 // terms.
@@ -19,16 +19,16 @@
 // More importantly, it provides tools and wrappers to work with
 // hash.Hash-based digests with little effort.
 //
-// Basics
+// # Basics
 //
 // The format of a digest is simply a string with two parts, dubbed the
 // "algorithm" and the "digest", separated by a colon:
 //
-// 	<algorithm>:<digest>
+//	<algorithm>:<digest>
 //
 // An example of a sha256 digest representation follows:
 //
-// 	sha256:7173b809ca12ec5dee4506cd86be934c4596dd234ee82c0662eac04a8c2c71dc
+//	sha256:7173b809ca12ec5dee4506cd86be934c4596dd234ee82c0662eac04a8c2c71dc
 //
 // The "algorithm" portion defines both the hashing algorithm used to calculate
 // the digest and the encoding of the resulting digest, which defaults to "hex"
@@ -42,7 +42,7 @@
 // obtained, comparisons are cheap, quick and simple to express with the
 // standard equality operator.
 //
-// Verification
+// # Verification
 //
 // The main benefit of using the Digest type is simple verification against a
 // given digest. The Verifier interface, modeled after the stdlib hash.Hash
@@ -50,7 +50,7 @@
 // writing is complete, calling the Verifier.Verified method will indicate
 // whether or not the stream of bytes matches the target digest.
 //
-// Missing Features
+// # Missing Features
 //
 // In addition to the above, we intend to add the following features to this
 // package:
@@ -58,5 +58,4 @@
 // 1. A Digester type that supports write sink digest calculation.
 //
 // 2. Suspend and resume of ongoing digest calculations to support efficient digest verification in the registry.
-//
 package digest
@@ -20,4 +20,3 @@ type anyArgument struct{}
 func (a anyArgument) Match(_ interface{}) bool {
 	return true
 }
-
--- a/Show More
+++ b/Show More