Use protoc of a specific version #79

Open
opened 2025-02-05 11:44:40 +00:00 by a-savchuk · 3 comments
Member

I've encountered an error while regenerating the documentation:

$ protoc --version
libprotoc 3.21.12
$ make doc 2>&1 | head
⇒ Documentation for accounting
[libprotobuf WARNING google/protobuf/compiler/parser.cc:646] No syntax specified for the proto file: accounting/service.proto. Please use 'syntax = "proto2";' or 'syntax = "proto3";' to specify a syntax version. (Defaulted to proto2 syntax.)
accounting/service.proto:1:1: Expected top-level statement (e.g. "message").
accounting/service.proto:36:5: Expected "required", "optional", or "repeated".
accounting/service.proto:39:3: Expected "required", "optional", or "repeated".
accounting/service.proto:43:3: Expected "required", "optional", or "repeated".
accounting/service.proto:48:3: Expected "required", "optional", or "repeated".
accounting/service.proto:58:5: Expected "required", "optional", or "repeated".
accounting/service.proto:61:3: Expected "required", "optional", or "repeated".
accounting/service.proto:65:3: Expected "required", "optional", or "repeated".

It would be helpful to have a Makefile target for installing protoc of a specific version, similar to how it's done in frostfs/sdk-go.

I've encountered an error while regenerating the documentation: ```console $ protoc --version libprotoc 3.21.12 $ make doc 2>&1 | head ⇒ Documentation for accounting [libprotobuf WARNING google/protobuf/compiler/parser.cc:646] No syntax specified for the proto file: accounting/service.proto. Please use 'syntax = "proto2";' or 'syntax = "proto3";' to specify a syntax version. (Defaulted to proto2 syntax.) accounting/service.proto:1:1: Expected top-level statement (e.g. "message"). accounting/service.proto:36:5: Expected "required", "optional", or "repeated". accounting/service.proto:39:3: Expected "required", "optional", or "repeated". accounting/service.proto:43:3: Expected "required", "optional", or "repeated". accounting/service.proto:48:3: Expected "required", "optional", or "repeated". accounting/service.proto:58:5: Expected "required", "optional", or "repeated". accounting/service.proto:61:3: Expected "required", "optional", or "repeated". accounting/service.proto:65:3: Expected "required", "optional", or "repeated". ``` It would be helpful to have a Makefile target for installing `protoc` of a specific version, similar to how it's done in [frostfs/sdk-go](https://git.frostfs.info/TrueCloudLab/frostfs-sdk-go/src/commit/5a35fa4353c1584c7ea4770de41ba86c30ef990a/Makefile).
a-savchuk added the
good first issue
triage
internal
labels 2025-02-05 11:44:40 +00:00
fyrchik removed the
triage
label 2025-02-05 11:48:47 +00:00
a-savchuk was assigned by fyrchik 2025-02-05 11:48:52 +00:00
Owner

Broken by #74

Broken by #74
Author
Member

The protoc-gen-doc plugin still doesn't support editions😢

https://github.com/pseudomuto/protoc-gen-doc/issues/541

The `protoc-gen-doc` plugin still doesn't support editions😢 https://github.com/pseudomuto/protoc-gen-doc/issues/541
Author
Member

I looked at the plugin again and it's being developed very slowly. I can make a PR myself or search for an alternative plugin

I looked at the plugin again and it's being developed very slowly. I can make a PR myself or search for an alternative plugin
Sign in to join this conversation.
No milestone
No project
No assignees
2 participants
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference: TrueCloudLab/frostfs-api#79
No description provided.