Use goa v2 to create to manage a /v2 subpath for new rest api

Author: matteosuppo

Gopkg.lock

@@ -24,6 +24,7 @@
 #   go-tests = true
 #   unused-packages = true
 
+required = ["goa.design/goa/codegen/generator"]
 
 [[constraint]]
   name = "github.com/Sirupsen/logrus"

Gopkg.toml

@@ -0,0 +1,13 @@
+package design
+
+import . "goa.design/goa/dsl"
+
+var _ = API("arduino-create-agent", func() {
+	Title("Arduino Create Agent")
+	Description(`A companion of Arduino Create. 
+	Allows the website to perform operations on the user computer, 
+	such as detecting which boards are connected and upload sketches on them.`)
+	HTTP(func() {
+		Path("/v2")
+	})
+})

design/design.go

@@ -0,0 +1,33 @@
+package design
+
+import . "goa.design/goa/dsl"
+
+var _ = Service("tools", func() {
+	Description("The tools service managed the tools installed in the system.")
+	Method("list", func() {
+		Result(Tool)
+		HTTP(func() {
+			GET("/tools")
+			Response(StatusOK)
+		})
+	})
+})
+
+var Tool = ResultType("application/vnd.arduino.tool", func() {
+	Description("A tool is an executable program that can upload sketches.")
+	TypeName("Tool")
+
+	Attributes(func() {
+		Attribute("name", String, "The name of the tool", func() {
+			Example("avrdude")
+		})
+		Attribute("version", String, "The version of the tool", func() {
+			Example("6.3.0-arduino9")
+		})
+		Attribute("packager", String, "The packager of the tool", func() {
+			Example("arduino")
+		})
+	})
+
+	Required("name", "version", "packager")
+})

design/tools.go

@@ -0,0 +1 @@
+{"swagger":"2.0","info":{"title":"Arduino Create Agent","description":"A companion of Arduino Create. \n\tAllows the website to perform operations on the user computer, \n\tsuch as detecting which boards are connected and upload sketches on them.","version":""},"host":"localhost:80","basePath":"/v2","consumes":["application/json","application/xml","application/gob"],"produces":["application/json","application/xml","application/gob"],"paths":{"/tools":{"get":{"tags":["tools"],"summary":"list tools","operationId":"tools#list","responses":{"200":{"description":"OK response.","schema":{"$ref":"#/definitions/ToolsListResponseBody"}}},"schemes":["http"]}}},"definitions":{"ToolsListResponseBody":{"title":"Mediatype identifier: application/vnd.arduino.tool; view=default","type":"object","properties":{"name":{"type":"string","description":"The name of the tool","example":"avrdude"},"packager":{"type":"string","description":"The packager of the tool","example":"arduino"},"version":{"type":"string","description":"The version of the tool","example":"6.3.0-arduino9"}},"description":"ListResponseBody result type (default view)","example":{"name":"avrdude","packager":"arduino","version":"6.3.0-arduino9"},"required":["name","version","packager"]}}}