Switch to go modules and version toolchain

Author: bcomnes

.gitignore

@@ -3,3 +3,5 @@ vendor
 *node_modules
 yarn.lock
 dist
+.vscode
+.gobincache

.travis.yml

@@ -2,9 +2,9 @@
 language: go
 
 go:
-  - "1.10"
-  - "1.11"
-
+  - "1.12"
+env:
+  - GO111MODULE=on
 install: make deps
 script: make test
 notifications:

CONTRIBUTING.md

@@ -2,9 +2,9 @@
 
 We use [go-swagger](https://github.com/go-swagger/go-swagger) to validate our spec against the 2.0 spec of Open API.
 
-We currently depend on version 0.18.0 of the go swagger toolchain. You can download the binary for your platform from this release page:
+[We currently depend on version 0.18.0 of the go swagger toolchain. You can download the binary for your platform from this release page:
 
-https://github.com/go-swagger/go-swagger/releases/tag/0.18.0
+https://github.com/go-swagger/go-swagger/releases/tag/0.18.0](The go-client is an [netlify/open-api][open-api] derived http client generated using [go-swagger][go-swagger].  Starting with version [`2.0.0`](https://github.com/netlify/go-client/releases/tag/v2.0.0) it is managed with [Go 1.11 modules][go-modules], and all external tools used for generation are managed with [gobin][gobin] + Go modules.  The [`swagger.yml`][swagger] is consumed as a vendored build-time asset via a [git submodule](https://git-scm.com/book/en/v2/Git-Tools-Submodules).  See [GMBE:Tools as dependencies](https://github.com/go-modules-by-example/index/tree/master/010_tools) and [GMBE:Using `gobin` to install/run tools](https://github.com/go-modules-by-example/index/tree/master/017_using_gobin) for a deeper explanation.)
 
 ## Spec validation
 
@@ -21,7 +21,7 @@ The Go client must be regenerated after every change to the `swagger.yml`.
 You can use this command to generate the Go client:
 
 	make generate
-	
+
 You may first want to edit swagger.yml to add your field or endpoint definitions.
 
 ## Making PRs

Makefile

@@ -1,22 +1,23 @@
 .PHONY: all build deps generate help test validate
 CHECK_FILES?=$$(go list ./... | grep -v /vendor/)
+SWAGGER_SPEC=swagger.yml
 
 help: ## Show this help.
 		@awk 'BEGIN {FS = ":.*?## "} /^[a-zA-Z_-]+:.*?## / {sub("\\\\n",sprintf("\n%22c"," "), $$2);printf "\033[36m%-20s\033[0m %s\n", $$1, $$2}' $(MAKEFILE_LIST)
 
-all: validate generate build ## Validate the swagger spec, generate the code and build it.
+all: deps generate build test ## Validate the swagger spec, generate the code and build it.
 
 build: ## Build the API Go client.
-	cd ./go && go build ./...
+	go build ./go/...
 
 deps: ## Download dependencies.
-	go get -u github.com/golang/dep/cmd/dep && cd ./go && dep ensure
+	GO111MODULE=off go get -u github.com/myitcv/gobin && go mod download
 
 generate: validate ## Generate the API Go client and the JSON document for the UI.
-	swagger generate client -A netlify -f swagger.yml -t go -c plumbing --with-flatten=full
+	go generate
 
 test: ## Test the go code.
-	cd ./go && go test -v $(CHECK_FILES)
+	gobin -m -run github.com/kyoh86/richgo test -v $(CHECK_FILES)
 
 validate: ## Check that the swagger spec is valid.
-	swagger validate swagger.yml
+	gobin -m -run github.com/go-swagger/go-swagger/cmd/swagger validate $(SWAGGER_SPEC)

generate.go

@@ -0,0 +1,3 @@
+package tools
+
+//go:generate gobin -m -run github.com/go-swagger/go-swagger/cmd/swagger generate client -A netlify -f swagger.yml -t go -c plumbing --with-flatten=full

go.mod

@@ -0,0 +1,28 @@
+module github.com/netlify/open-api
+
+go 1.12
+
+require (
+	contrib.go.opencensus.io/exporter/ocagent v0.4.6 // indirect
+	github.com/Azure/go-autorest v11.5.0+incompatible
+	github.com/cenkalti/backoff v2.1.1+incompatible
+	github.com/dgrijalva/jwt-go v3.2.0+incompatible // indirect
+	github.com/go-openapi/errors v0.18.0
+	github.com/go-openapi/inflect v0.18.0 // indirect
+	github.com/go-openapi/runtime v0.18.0
+	github.com/go-openapi/strfmt v0.18.0
+	github.com/go-openapi/swag v0.18.0
+	github.com/go-openapi/validate v0.18.0
+	github.com/go-swagger/go-swagger v0.18.0
+	github.com/gorilla/handlers v1.4.0 // indirect
+	github.com/jessevdk/go-flags v1.4.0 // indirect
+	github.com/kr/pretty v0.1.0 // indirect
+	github.com/kyoh86/richgo v0.3.0 // indirect
+	github.com/rsc/goversion v1.2.0
+	github.com/sirupsen/logrus v1.3.0
+	github.com/spf13/viper v1.3.1 // indirect
+	github.com/stretchr/testify v1.2.2
+	github.com/toqueteos/webbrowser v1.1.0 // indirect
+	go.opencensus.io v0.19.0 // indirect
+	golang.org/x/net v0.0.0-20190226215741-afe646ca25a4
+)