Expand description
REST→gRPC transcoding layer.
Reads google.api.http annotations from proto service descriptors
and builds axum routes that proxy JSON/form requests to gRPC upstream.
The upstream decides the HTTP answer beyond the JSON body where it needs
to: its response metadata becomes response headers, x-http-code sets the
status of a successful unary call, and google.api.HttpBody carries a raw
body in either direction.
Generic: works with ANY proto descriptor set. No product-specific code.
Modules§
- body
- Request body parsing.
- codec
- Dynamic gRPC codec for
prost-reflect::DynamicMessage. - error
- gRPC → HTTP error mapping.
- metadata
- HTTP → gRPC metadata, trace-context, and deadline propagation.
- request
- Request message construction for REST→gRPC transcoding.
Structs§
- Transcode
Options - How
routes_with_optionsbuilds the transcoded routes.
Traits§
- Transcode
State - Trait for state types that support REST→gRPC transcoding.
Functions§
- proto_
path_ to_ axum - Convert a
google.api.httppath template to axum 0.8 path syntax. - route_
paths - The axum paths
routeswould register for this pool and aliases. - routes
- Build transcoded REST→gRPC routes from a descriptor pool.
- routes_
with_ options routes, built asoptionsdescribe.