gRPC

gRPC generators.yml reference

Configure how your gRPC specification is processed and transformed into SDKs and documentation using the generators.yml configuration file.

generators.yml
1api:
2  specs:
3    - proto:
4        root: "./proto"
5        target: "proto/service/v1/service.proto"
6        local-generation: true
root
stringRequired

Path to the .proto directory root (e.g., proto). Must be specified up to where the package starts. For example, if your package is package.test.v1 at the file path protos/package/test/v1/test_file.proto, the root should be protos/

target
string

Path to the target .proto file (e.g., proto/user/v1/user.proto). Omit to generate docs for the entire root folder.

overrides
string

Path to the overrides configuration file. Used for SDK generation only, not for documentation generation.

local-generation
booleanDefaults to false

Whether to compile .proto files locally. Defaults to remote generation (false).