A protoc/buf plugin to generate compatible OpenAPI version 3.0.0 YAML files from protobuf HTTP API declarations.
This plugin provides an easy way of generating OpeAPI specification of an HTTP service API directly from its protobuf file. It uses protobuf annotation options to allow the user define details about the service and its endpoints.
It can be used alone or together with the protoc-gen-mikros-extensions plugin for messages and field names.
In order to compile and install the plugin locally you'll need to follow the steps:
- Install the go compiler;
- Execute the commands:
go generatego build && go install
The following links present details about available options to be used from a protobuf file.
For more details or a complete example, use the examples directory.