Fix proto-gen after docs removal (#1196)

* add back proto docs template * ignore all third party packages from proto lint * generate missing proto docs/linting * update old branch name for proto-check-breaking * remove dependency changes from proto generation * remove no longer needed docs cmds from makefile * use v0.3 dev image w/ go 1.17; add go mod tidy back Co-authored-by: Nick DeLuca <nickdeluca08@gmail.com>
2024-12-24 15:25:18 +00:00 · 2022-03-25 15:15:02 +00:00 · 2022-03-25 15:15:02 +00:00 · 3b187011bb
commit 3b187011bb
parent f0fa2e1253
9 changed files with 5815 additions and 36 deletions
--- a/19
+++ b/19
@ -146,7 +146,7 @@ start:
 ###                                Protobuf                                 ###
 ###############################################################################

-protoVer=v0.2
+protoVer=v0.3
 protoImageName=tendermintdev/sdk-proto-gen:$(protoVer)
 containerProtoGen=$(PROJECT_NAME)-proto-gen-$(protoVer)
 containerProtoGenAny=$(PROJECT_NAME)-proto-gen-any-$(protoVer)
@ -174,7 +174,7 @@ proto-lint:
 	@$(DOCKER_BUF) lint --error-format=json

 proto-check-breaking:
-	@$(DOCKER_BUF) breaking --against $(HTTPS_GIT)#branch=upgrade-v44
+	@$(DOCKER_BUF) breaking --against $(HTTPS_GIT)#branch=master

 GOOGLE_PROTO_URL = https://raw.githubusercontent.com/googleapis/googleapis/master/google/api
 PROTOBUF_GOOGLE_URL = https://raw.githubusercontent.com/protocolbuffers/protobuf/master/src/google/protobuf
@ -265,18 +265,3 @@ start-remote-sims:
 		-—container-override environment=[{SIM_NAME=master-$(VERSION)}]

 .PHONY: all build-linux install clean build test test-cli test-all test-rest test-basic start-remote-sims
-
-########################################
-### Documentation
-
-# Start docs site at localhost:8080
-docs-develop:
-	@cd docs && \
-	npm install && \
-	npm run serve
-
-# Build the site into docs/.vuepress/dist
-docs-build:
-	@cd docs && \
-	npm install && \
-	npm run build
--- a/client/docs/swagger-ui/swagger.yaml
+++ b/client/docs/swagger-ui/swagger.yaml
@ -1099,7 +1099,9 @@ paths:
                properties:
                  max_auction_duration:
                    type: string
-                  bid_duration:
+                  forward_bid_duration:
+                    type: string
+                  reverse_bid_duration:
                    type: string
                  increment_surplus:
                    type: string
@ -50359,7 +50361,9 @@ definitions:
    properties:
      max_auction_duration:
        type: string
-      bid_duration:
+      forward_bid_duration:
+        type: string
+      reverse_bid_duration:
        type: string
      increment_surplus:
        type: string
@ -50745,7 +50749,9 @@ definitions:
        properties:
          max_auction_duration:
            type: string
-          bid_duration:
+          forward_bid_duration:
+            type: string
+          reverse_bid_duration:
            type: string
          increment_surplus:
            type: string
--- a/docs/core/proto-docs.md
+++ b/docs/core/proto-docs.md
--- a/docs/protodoc-markdown.tmpl
+++ b/docs/protodoc-markdown.tmpl
@ -0,0 +1,105 @@
+ <!-- This file is auto-generated. Please do not modify it yourself. -->
+# Protobuf Documentation
+<a name="top"></a>
+
+## Table of Contents
+{{range .Files}}
+{{$file_name := .Name}}- [{{.Name}}](#{{.Name}})
+  {{- if .Messages }}
+  {{range .Messages}}  - [{{.LongName}}](#{{.FullName}})
+  {{end}}
+  {{- end -}}
+  {{- if .Enums }}
+  {{range .Enums}}  - [{{.LongName}}](#{{.FullName}})
+  {{end}}
+  {{- end -}}
+  {{- if .Extensions }}
+  {{range .Extensions}}  - [File-level Extensions](#{{$file_name}}-extensions)
+  {{end}}
+  {{- end -}}
+  {{- if .Services }}
+  {{range .Services}}  - [{{.Name}}](#{{.FullName}})
+  {{end}}
+  {{- end -}}
+{{end}}
+- [Scalar Value Types](#scalar-value-types)
+
+{{range .Files}}
+{{$file_name := .Name}}
+<a name="{{.Name}}"></a>
+<p align="right"><a href="#top">Top</a></p>
+
+## {{.Name}}
+{{.Description}}
+
+{{range .Messages}}
+<a name="{{.FullName}}"></a>
+
+### {{.LongName}}
+{{.Description}}
+
+{{if .HasFields}}
+| Field | Type | Label | Description |
+| ----- | ---- | ----- | ----------- |
+{{range .Fields -}}
+  | `{{.Name}}` | [{{.LongType}}](#{{.FullType}}) | {{.Label}} | {{if (index .Options "deprecated"|default false)}}**Deprecated.** {{end}}{{nobr .Description}}{{if .DefaultValue}} Default: {{.DefaultValue}}{{end}} |
+{{end}}
+{{end}}
+
+{{if .HasExtensions}}
+| Extension | Type | Base | Number | Description |
+| --------- | ---- | ---- | ------ | ----------- |
+{{range .Extensions -}}
+  | `{{.Name}}` | {{.LongType}} | {{.ContainingLongType}} | {{.Number}} | {{nobr .Description}}{{if .DefaultValue}} Default: {{.DefaultValue}}{{end}} |
+{{end}}
+{{end}}
+
+{{end}} <!-- end messages -->
+
+{{range .Enums}}
+<a name="{{.FullName}}"></a>
+
+### {{.LongName}}
+{{.Description}}
+
+| Name | Number | Description |
+| ---- | ------ | ----------- |
+{{range .Values -}}
+  | {{.Name}} | {{.Number}} | {{nobr .Description}} |
+{{end}}
+
+{{end}} <!-- end enums -->
+
+{{if .HasExtensions}}
+<a name="{{$file_name}}-extensions"></a>
+
+### File-level Extensions
+| Extension | Type | Base | Number | Description |
+| --------- | ---- | ---- | ------ | ----------- |
+{{range .Extensions -}}
+  | `{{.Name}}` | {{.LongType}} | {{.ContainingLongType}} | {{.Number}} | {{nobr .Description}}{{if .DefaultValue}} Default: `{{.DefaultValue}}`{{end}} |
+{{end}}
+{{end}} <!-- end HasExtensions -->
+
+{{range .Services}}
+<a name="{{.FullName}}"></a>
+
+### {{.Name}}
+{{.Description}}
+
+| Method Name | Request Type | Response Type | Description | HTTP Verb | Endpoint |
+| ----------- | ------------ | ------------- | ------------| ------- | -------- |
+{{range .Methods -}}
+  | `{{.Name}}` | [{{.RequestLongType}}](#{{.RequestFullType}}){{if .RequestStreaming}} stream{{end}} | [{{.ResponseLongType}}](#{{.ResponseFullType}}){{if .ResponseStreaming}} stream{{end}} | {{nobr .Description}} | {{with (index .Options "google.api.http")}}{{range .Rules}}{{.Method}}|{{.Pattern}}{{end}}{{end}}|
+{{end}}
+{{end}} <!-- end services -->
+
+{{end}}
+
+## Scalar Value Types
+
+| .proto Type | Notes | C++ | Java | Python | Go | C# | PHP | Ruby |
+| ----------- | ----- | --- | ---- | ------ | -- | -- | --- | ---- |
+{{range .Scalars -}}
+  | <a name="{{.ProtoType}}" /> {{.ProtoType}} | {{.Notes}} | {{.CppType}} | {{.JavaType}} | {{.PythonType}} | {{.GoType}} | {{.CSharp}} | {{.PhpType}} | {{.RubyType}} |
+{{end}}
--- a/proto/kava/savings/v1beta1/query.proto
+++ b/proto/kava/savings/v1beta1/query.proto
@ -20,7 +20,6 @@ service Query {
  rpc Deposits(QueryDepositsRequest) returns (QueryDepositsResponse) {
    option (google.api.http).get = "/kava/savings/v1beta1/deposits";
  }
-
 }

 // QueryParamsRequest defines the request type for querying x/savings
--- a/third_party/proto/buf.yaml
+++ b/third_party/proto/buf.yaml
@ -6,4 +6,6 @@ lint:
    - cosmos_proto
    - gogoproto
    - google
+    - ibc
    - tendermint
+    - proofs.proto