trillium grpc

Generate Rust modules from a .proto service definition. This is a build-time codegen tool, not a server — it turns protobuf service definitions into committed Rust source you wire into a trillium app.

Feature-gated

grpc is not in the default build. Install it with cargo install trillium-cli --features grpc, or run from a checkout with cargo run --features grpc -- grpc.

Usage

trillium grpc <PROTO> [OUT]

trillium grpc ./proto/echo.proto            # writes into ./src
trillium grpc ./proto/echo.proto ./src/gen  # writes into ./src/gen

grpc produces one .rs file per .proto package, written into the output directory (default ./src, created if missing). Each generated file contains:

• the prost-generated message types,
• the trillium-grpc service trait, and
• a Server<T> Handler you can mount into a trillium app.

Output is formatted with prettyplease and is intended to be committed to your repository (rather than regenerated in a build.rs).

Imports

The directory containing the .proto is added to the include path automatically. Add more include paths with -I / --include when your definitions import from elsewhere:

trillium grpc ./proto/api.proto -I ./proto/common -I ./vendor/googleapis

Full flag reference

trillium grpc [OPTIONS] <PROTO> [OUT]

Arguments:
  <PROTO>  Path to the .proto file to compile
  [OUT]    Output directory for generated .rs files  [default: ./src]

Options:
  -I, --include <INCLUDES>  Additional include path for resolving imports
  -h, --help