Sync plugins for the Goa v3.31.0 generation upgrade

Makefile

@@ -3,15 +3,13 @@
 # Makefile for goa v3 plugins
 
 GOOS=$(shell go env GOOS)
-GOA:=$(shell goa version 2> /dev/null)
+GOA_VERSION:=$(shell go list -m -f '{{.Version}}' goa.design/goa/v3)
 
-# Only list test and build dependencies
-# Standard dependencies are installed via go get
+# These commands install the tools used to build and test the plugins.
 DEPEND=\
 	google.golang.org/protobuf/cmd/protoc-gen-go@latest \
 	google.golang.org/grpc/cmd/protoc-gen-go-grpc@latest \
-	honnef.co/go/tools/cmd/staticcheck@latest \
-	goa.design/goa/v3/cmd/goa@v3
+	honnef.co/go/tools/cmd/staticcheck@latest
 
 # Add new plugins here to enable make
 PLUGINS=\
@@ -64,15 +62,10 @@ depend:
 	fi
 
 check-goa:
-ifdef GOA
+	@# Use the Goa version in go.mod so generation and compilation use the same API.
+	go install goa.design/goa/v3/cmd/goa@$(GOA_VERSION)
 	go mod download
-	@echo $(GOA)
-else
-	go get -u goa.design/goa/v3@v3
-	go get -u goa.design/goa/v3/...@v3
-	go mod download
-	@echo $(GOA)
-endif
+	@echo "Goa $(GOA_VERSION)"
 
 tidy:
 	@go mod tidy

README.md

@@ -6,4 +6,19 @@ This repository contains plugins for
 Each sub-directory README contains the information and usage for the given
 plugin.
 
+Plugins v3.31.0 accompanies Goa v3.31.0 and requires Go 1.26 or later.
+Upgrade both modules together:
+
+```shell
+go get goa.design/goa/v3@v3.31.0 goa.design/plugins/v3@v3.31.0
+go install goa.design/goa/v3/cmd/goa@v3.31.0
+```
+
+Regenerate the complete application after upgrading. This release adapts
+declaration-producing plugins to Goa's generation plan and updates generated
+commands, transport helpers, and test scenarios. Custom plugins that declare
+names must plan those declarations before rendering. Read the
+[Goa upgrade guide](https://github.com/goadesign/goa/blob/v3.31.0/UPGRADING.md)
+for application changes and the generator API migration.
+
 Goa v2 plugins can be found [here](https://github.com/goadesign/plugins/tree/v2).

arnz/example/gen/goa.json

@@ -1,3 +1,3 @@
 {
-  "goa_version": "v3.30.0"
+  "goa_version": "v3.31.0-preview.5"
 }

arnz/example/gen/http/openapi.json

@@ -1 +1 @@
-{"swagger":"2.0","info":{"title":"","version":"0.0.1"},"host":"localhost:80","consumes":["application/json","application/xml","application/gob"],"produces":["application/json","application/xml","application/gob"],"paths":{"/":{"get":{"tags":["Arnz"],"summary":"read Arnz","operationId":"Arnz#read","responses":{"200":{"description":"OK response.","schema":{"$ref":"#/definitions/ResponseBody","required":["action"]}}},"schemes":["http"]},"put":{"tags":["Arnz"],"summary":"update Arnz","operationId":"Arnz#update","responses":{"200":{"description":"OK response.","schema":{"$ref":"#/definitions/ResponseBody","required":["action"]}}},"schemes":["http"]},"post":{"tags":["Arnz"],"summary":"create Arnz","operationId":"Arnz#create","responses":{"200":{"description":"OK response.","schema":{"$ref":"#/definitions/ResponseBody","required":["action"]}}},"schemes":["http"]},"delete":{"tags":["Arnz"],"summary":"delete Arnz","operationId":"Arnz#delete","responses":{"200":{"description":"OK response.","schema":{"$ref":"#/definitions/ResponseBody","required":["action"]}}},"schemes":["http"]}},"/health":{"get":{"tags":["Arnz"],"summary":"health Arnz","operationId":"Arnz#health","responses":{"200":{"description":"OK response.","schema":{"$ref":"#/definitions/ResponseBody","required":["action"]}}},"schemes":["http"]}}},"definitions":{"ResponseBody":{"title":"ResponseBody","type":"object","properties":{"action":{"type":"string","example":"Autem eos aut quisquam."}},"example":{"action":"Autem eos aut quisquam."},"required":["action"]}}}
+{"swagger":"2.0","info":{"title":"","version":"0.0.1"},"host":"localhost:80","consumes":["application/json","application/xml","application/gob"],"produces":["application/json","application/xml","application/gob"],"paths":{"/":{"get":{"tags":["Arnz"],"summary":"read Arnz","operationId":"Arnz#read","responses":{"200":{"description":"OK response.","schema":{"$ref":"#/definitions/ResponseBody","required":["action"]}}},"schemes":["http"]},"put":{"tags":["Arnz"],"summary":"update Arnz","operationId":"Arnz#update","responses":{"200":{"description":"OK response.","schema":{"$ref":"#/definitions/ResponseBody","required":["action"]}}},"schemes":["http"]},"post":{"tags":["Arnz"],"summary":"create Arnz","operationId":"Arnz#create","responses":{"200":{"description":"OK response.","schema":{"$ref":"#/definitions/ResponseBody","required":["action"]}}},"schemes":["http"]},"delete":{"tags":["Arnz"],"summary":"delete Arnz","operationId":"Arnz#delete","responses":{"200":{"description":"OK response.","schema":{"$ref":"#/definitions/ResponseBody","required":["action"]}}},"schemes":["http"]}},"/health":{"get":{"tags":["Arnz"],"summary":"health Arnz","operationId":"Arnz#health","responses":{"200":{"description":"OK response.","schema":{"$ref":"#/definitions/ResponseBody","required":["action"]}}},"schemes":["http"]}}},"definitions":{"ResponseBody":{"title":"ResponseBody","type":"object","properties":{"action":{"type":"string","example":"Aut sit sit repellendus nesciunt minima."}},"example":{"action":"Aut sit sit repellendus nesciunt minima."},"required":["action"]}}}

arnz/example/gen/http/openapi.yaml

@@ -91,8 +91,8 @@ definitions:
         properties:
             action:
                 type: string
-                example: Autem eos aut quisquam.
+                example: Aut sit sit repellendus nesciunt minima.
         example:
-            action: Autem eos aut quisquam.
+            action: Aut sit sit repellendus nesciunt minima.
         required:
             - action

arnz/example/gen/http/openapi3.2.json

@@ -1 +1 @@
-{"openapi":"3.2.0","info":{"title":"Goa API","version":"0.0.1"},"servers":[{"url":"http://localhost:80","name":"Arnz","description":"Default server for Arnz"}],"paths":{"/":{"delete":{"tags":["Arnz"],"summary":"delete Arnz","operationId":"Arnz#delete","responses":{"200":{"description":"OK response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResponseBody"},"example":{"action":"Quaerat neque commodi cupiditate dignissimos voluptates sed."}}}}}},"get":{"tags":["Arnz"],"summary":"read Arnz","operationId":"Arnz#read","responses":{"200":{"description":"OK response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResponseBody"},"example":{"action":"Nulla dolores est sunt autem et est."}}}}}},"post":{"tags":["Arnz"],"summary":"create Arnz","operationId":"Arnz#create","responses":{"200":{"description":"OK response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResponseBody"},"example":{"action":"Autem eos aut quisquam."}}}}}},"put":{"tags":["Arnz"],"summary":"update Arnz","operationId":"Arnz#update","responses":{"200":{"description":"OK response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResponseBody"},"example":{"action":"Id impedit dolores."}}}}}}},"/health":{"get":{"tags":["Arnz"],"summary":"health Arnz","operationId":"Arnz#health","responses":{"200":{"description":"OK response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResponseBody"},"example":{"action":"Voluptatem impedit sunt aliquam."}}}}}}}},"components":{"schemas":{"ResponseBody":{"type":"object","properties":{"action":{"type":"string","example":"Autem eos aut quisquam."}},"example":{"action":"Autem eos aut quisquam."},"required":["action"]}}},"tags":[{"name":"Arnz"}]}
+{"openapi":"3.2.0","info":{"title":"Goa API","version":"0.0.1"},"servers":[{"url":"http://localhost:80","name":"Arnz","description":"Default server for Arnz"}],"paths":{"/":{"delete":{"tags":["Arnz"],"summary":"delete Arnz","operationId":"Arnz#delete","responses":{"200":{"description":"OK response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResponseBody"},"example":{"action":"Qui illo."}}}}}},"get":{"tags":["Arnz"],"summary":"read Arnz","operationId":"Arnz#read","responses":{"200":{"description":"OK response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResponseBody"},"example":{"action":"Accusantium est non molestiae."}}}}}},"post":{"tags":["Arnz"],"summary":"create Arnz","operationId":"Arnz#create","responses":{"200":{"description":"OK response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResponseBody"},"example":{"action":"Aut sit sit repellendus nesciunt minima."}}}}}},"put":{"tags":["Arnz"],"summary":"update Arnz","operationId":"Arnz#update","responses":{"200":{"description":"OK response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResponseBody"},"example":{"action":"Consectetur recusandae."}}}}}}},"/health":{"get":{"tags":["Arnz"],"summary":"health Arnz","operationId":"Arnz#health","responses":{"200":{"description":"OK response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResponseBody"},"example":{"action":"Culpa sed."}}}}}}}},"components":{"schemas":{"ResponseBody":{"type":"object","properties":{"action":{"type":"string","example":"Aut sit sit repellendus nesciunt minima."}},"example":{"action":"Aut sit sit repellendus nesciunt minima."},"required":["action"]}}},"tags":[{"name":"Arnz"}]}

arnz/example/gen/http/openapi3.2.yaml

@@ -21,7 +21,7 @@ paths:
                             schema:
                                 $ref: '#/components/schemas/ResponseBody'
                             example:
-                                action: Quaerat neque commodi cupiditate dignissimos voluptates sed.
+                                action: Qui illo.
         get:
             tags:
                 - Arnz
@@ -35,7 +35,7 @@ paths:
                             schema:
                                 $ref: '#/components/schemas/ResponseBody'
                             example:
-                                action: Nulla dolores est sunt autem et est.
+                                action: Accusantium est non molestiae.
         post:
             tags:
                 - Arnz
@@ -49,7 +49,7 @@ paths:
                             schema:
                                 $ref: '#/components/schemas/ResponseBody'
                             example:
-                                action: Autem eos aut quisquam.
+                                action: Aut sit sit repellendus nesciunt minima.
         put:
             tags:
                 - Arnz
@@ -63,7 +63,7 @@ paths:
                             schema:
                                 $ref: '#/components/schemas/ResponseBody'
                             example:
-                                action: Id impedit dolores.
+                                action: Consectetur recusandae.
     /health:
         get:
             tags:
@@ -78,17 +78,17 @@ paths:
                             schema:
                                 $ref: '#/components/schemas/ResponseBody'
                             example:
-                                action: Voluptatem impedit sunt aliquam.
+                                action: Culpa sed.
 components:
     schemas:
         ResponseBody:
             type: object
             properties:
                 action:
                     type: string
-                    example: Autem eos aut quisquam.
+                    example: Aut sit sit repellendus nesciunt minima.
             example:
-                action: Autem eos aut quisquam.
+                action: Aut sit sit repellendus nesciunt minima.
             required:
                 - action
 tags: