v2.14.0

New features

This release contains two significant new OpenAPIv2 generator features, contributed by @krak3n:

1. A new option to disable rendering of 200 OK responses. This is useful if you define custom responses for your endpoints and you modify the return code a forward response writer. Note that this does not change the behavior of the gateway itself.
2. A new annotation for defining header parameters. This lets to define header parameters you want to be rendered in the swagger.json output in addition to those defined in your API messages. Note that this does not change the behavior of the gateway itself and must be coupled with custom header parsing in your application.

What's Changed

• release: Update release.yml with option to workaround SLSA generator failure by @asraa in #2987
• release: add a workflow_dispatch trigger for testing by @asraa in #2989
• Use io/os instread of ioutil and use suitable verb by @sashamelentyev in #2991
• runtime pkg cleanup by @sashamelentyev in #2993
• mux: fix path components mutation by @jonathaningram in #3001
• fix: set consumes definition per operation by @stomy13 in #2995
• protoc gen oas v2 cleanup by @sashamelentyev in #2996
• Use ReplaceAll instead of Replace with -1 pos by @sashamelentyev in #3003
• Errors cleanup by @sashamelentyev in #3004
• Cleanup by @sashamelentyev in #3012
• Support disabling default response rendering by @krak3n in #3006
• Support request header parameters by @krak3n in #3010

New Contributors

• @asraa made their first contribution in #2987
• @sashamelentyev made their first contribution in #2991
• @stomy13 made their first contribution in #2995
• @krak3n made their first contribution in #3006

Full Changelog: v2.13.0...v2.14.0

v2.13.0

What's Changed

• Updated gRPC code Cancelled replaced with HTTP code 499 by @tech-sumit in #2957
• fix: remove default service tag generation for methods by @kkolur in #2960
• Use tag instead of has pin for SLSA generator by @laurentsimon in #2969
• Add Conduit to adopters by @hariso in #2981
• feat(gen-openapiv2): support trailing comments by @ionling in #2965
• feat(gen-openapiv2): keep fields next to "$ref" fields by @gostajonasson in #2986

New Contributors

• @tech-sumit made their first contribution in #2957
• @hariso made their first contribution in #2981
• @ionling made their first contribution in #2965

Full Changelog: v2.12.0...v2.13.0

v2.12.0

What's Changed

• fix: support for oneof fields in request bodies by @isbang in #2867
• mux: calculate verb correctly for cases like DELETE /foo/bar:archive when user provided wrong method by @jonathaningram in #2870
• Update googleapis dependency by @johanbrandhorst in #2875
• protoc-gen-openapiv2: RPC visibility setting transitively applied to messages by @erademacher in #2880
• protoc-gen-openapiv2: Use json_name when generating required field names by @patrick246 in #2885
• fix: support service tags in OpenAPI config file (#2817) by @y-takuya in #2858
• feat: add option to disable rendering of service tags by @kkolur in #2928
• fix: required properties of message type are required in OpenAPI by @gostajonasson in #2904
• feat: add option to add description to tags by @same-id in #2939
• add extensions for Tag object by @kkolur in #2950
• Make registry load packages deterministically by @gonzaloserrano in #2945

New Contributors

• @erademacher made their first contribution in #2880
• @patrick246 made their first contribution in #2885
• @y-takuya made their first contribution in #2858
• @kkolur made their first contribution in #2928
• @gostajonasson made their first contribution in #2904
• @same-id made their first contribution in #2939
• @gonzaloserrano made their first contribution in #2945

Full Changelog: v2.11.3...v2.12.0

v2.11.3

This release adds signed release binaries with SLSA signatures. Please see the README for more information.

What's Changed

• fix: unnecessary -e arg for echo command in dockerfile by @MakDon in #2840
• Fix identifiers generated from snake-cased enums not matching pb.go definitions by @jbaxx in #2826
• switch ci build env version to 1.19 by @MakDon in #2845
• Signed release binaries with SLSA signatures by @laurentsimon in #2847
• protoc-gen-openapiv2 generating the wrong schema fixing the issue #2635 by @lakshkeswani in #2854

New Contributors

• @jbaxx made their first contribution in #2826
• @laurentsimon made their first contribution in #2847

Full Changelog: v2.11.2...v2.11.3

v2.11.2

This fixes an issue with the openapiv2 generator if there is a colon in the verb, and updates the minimum supported Go version to Go 1.17.

What's Changed

• Fix openapiv2 path parameter parsing when colon in verb by @johanbrandhorst in #2825
• Update minimum supported Go version to 1.17 by @renovate in #2831

Full Changelog: v2.11.1...v2.11.2

v2.11.1

This release fixes a crash in the grpc-gateway handling of requests containing invalid an Grpc-Timeout or Grpc-Metadata-Bin header (#2822). It is strongly recommended that users upgrade both the runtime and generator versions.

What's Changed

• Default allow_repeated_fields_in_body option to true and deprecate option by @armsnyder in #2813
• Fix timeout panic by @johanbrandhorst in #2823

New Contributors

• @armsnyder made their first contribution in #2813

Full Changelog: v2.11.0...v2.11.1

v2.11.0

What's Changed

• Set fetch depth for renovate actions by @johanbrandhorst in #2741
• openapiv2: Field options are properly rendered for repeated fields #2531 by @lakshkeswani in #2742
• Set version for gorelease by @johanbrandhorst in #2749
• Disable renovate on v1 by @johanbrandhorst in #2781
• feat: add support for oneof fields in request bodies by @aesadde in #2739
• Bugfix/issue 2681 by @olegvelikanov in #2773
• chore: Included githubactions in the dependabot config by @naveensrinivasan in #2673
• Change renovate branch trigger by @johanbrandhorst in #2791
• fix: extensions in YAML format [#2795] by @hedhyw in #2797
• fix: yaml indent [#2645] by @hedhyw in #2801
• Fix buf plugin's library version by @AlmogBaku in #2800

New Contributors

• @lakshkeswani made their first contribution in #2742
• @aesadde made their first contribution in #2739
• @olegvelikanov made their first contribution in #2773
• @AlmogBaku made their first contribution in #2800

Full Changelog: v2.10.3...v2.11.0

v2.10.3

What's Changed

• protoc-gen-openapiv2: Fix schema types for Value and Empty well-known types by @haines in #2719
• Use custom token secret for pushes by @johanbrandhorst in #2725
• chore: renovate bot setting to pin actions to a full length commit SHA by @naveensrinivasan in #2724
• protoc-gen-openapiv2: Support all HTTP methods supported in OpenAPI v2 by @mnito in #2726
• Fix overriding path parameter with custom verbs by @oyvindwe in #2727
• Update git push to use full username by @johanbrandhorst in #2732
• Lets try using the checkout token setting by @johanbrandhorst in #2733
• Add old style build tag by @johanbrandhorst in #2734
• Update gopkg.in/yaml.v3 by @sousandrei in #2729

New Contributors

• @haines made their first contribution in #2719
• @sousandrei made their first contribution in #2729

Full Changelog: v2.10.2...v2.10.3

v2.10.2

What's Changed

• Fix node tests by @johanbrandhorst in #2704
• Fix panic in parsing null time/duration in query by @johanbrandhorst in #2703
• Migrate to Github Actions by @johanbrandhorst in #2700
• Add protobuf and grpc runtime versions to buf plugins by @johanbrandhorst in #2702
• Fix readme display error by @lanlyhs in #2706
• openapiv2: fix comment by @kurochan in #2701

New Contributors

• @lanlyhs made their first contribution in #2706
• @kurochan made their first contribution in #2701

Full Changelog: v2.10.1...v2.10.2

v2.10.1

What's Changed

• protoc-gen-openapiv2: Use the canonical camelCase converter for protobuf by @oyvindwe in #2599
• Revert gazelle dependency to original repository by @johanbrandhorst in #2605
• Use Bytes from convert.go to unmarshal byte value by @HubertZhang in #2603
• correct generate field mask for google.protobuf.struct field by @marsianin in #2619
• Update golangci-lint to 1.45 for Go 1.18 support by @johanbrandhorst in #2631
• Turn on dependabot updates for documentation by @achew22 in #2604
• build(deps-dev): bump github-pages from 209 to 225 in /docs by @dependabot in #2633
• support google.protobuf.Value by @wclssdn in #2628
• fix: Correct typos in error messages from loading OpenAPI Configuration by @joonas in #2636
• Set permissions for GitHub actions by @naveensrinivasan in #2641
• Field and schema extensions by @james-o-johnstone in #2418
• chore(deps): update dependency com_github_bazelbuild_buildtools to v5.1.0 (master) by @renovate in #2645
• fix(deps): update google.golang.org/genproto digest to 2d67ff6 (master) by @renovate in #2646
• Format protobuf files with buf by @johanbrandhorst in #2650
• build(deps): bump nokogiri from 1.13.3 to 1.13.4 in /docs by @dependabot in #2638
• Add git blame ignore by @johanbrandhorst in #2652
• Export defaultQueryParser struct for custom query parsers by @mikesouza in #2651
• Fix typo in "uannotated" file links by @srowles in #2658
• fix: Content-Type and Grpc-Metadata-Content-Type headers with the health endpoint by @GreyXor in #2634
• protoc-gen-openapiv2: Remove path parameters from body when body is a snake_case field by @oyvindwe in #2600
• Fixed []byte unmarshaling for non proto structs by @gknw in #2693
• protoc-gen-openapiv2: Document and warn about path parameters containing "/" by @oyvindwe in #2697

New Contributors

• @HubertZhang made their first contribution in #2603
• @marsianin made their first contribution in #2619
• @wclssdn made their first contribution in #2628
• @joonas made their first contribution in #2636
• @naveensrinivasan made their first contribution in #2641
• @james-o-johnstone made their first contribution in #2418
• @mikesouza made their first contribution in #2651
• @srowles made their first contribution in #2658
• @GreyXor made their first contribution in #2634
• @gknw made their first contribution in #2693

Full Changelog: v2.10.0...v2.10.1