Struct tonic_build::Builder

pub struct Builder { /* fields omitted */ }

Service generator builder.

Implementations

impl Builder

pub fn build_client(self, enable: bool) -> Self

Enable or disable gRPC client code generation.

pub fn build_server(self, enable: bool) -> Self

Enable or disable gRPC server code generation.

pub fn format(self, run: bool) -> Self

Enable the output to be formated by rustfmt.

pub fn out_dir(self, out_dir: impl AsRef<Path>) -> Self

Set the output directory to generate code to.

Defaults to the OUT_DIR environment variable.

pub fn extern_path(
    self,
    proto_path: impl AsRef<str>,
    rust_path: impl AsRef<str>
) -> Self

Declare externally provided Protobuf package or type.

Passed directly to prost_build::Config.extern_path. Note that both the Protobuf path and the rust package paths should both be fully qualified. i.e. Protobuf paths should start with "." and rust paths should start with "::"

pub fn field_attribute<P: AsRef<str>, A: AsRef<str>>(
    self,
    path: P,
    attribute: A
) -> Self

Add additional attribute to matched messages, enums, and one-offs.

Passed directly to prost_build::Config.field_attribute.

pub fn type_attribute<P: AsRef<str>, A: AsRef<str>>(
    self,
    path: P,
    attribute: A
) -> Self

Add additional attribute to matched messages, enums, and one-offs.

Passed directly to prost_build::Config.type_attribute.

pub fn proto_path(self, proto_path: impl AsRef<str>) -> Self

Set the path to where tonic will search for the Request/Response proto structs live relative to the module where you call include_proto!.

This defaults to super since tonic will generate code in a module.

pub fn compile<P>(self, protos: &[P], includes: &[P]) -> Result<()> where
    P: AsRef<Path>, 

Compile the .proto files and execute code generation.

pub fn compile_with_config<P>(
    self,
    config: Config,
    protos: &[P],
    includes: &[P]
) -> Result<()> where
    P: AsRef<Path>, 

Compile the .proto files and execute code generation using a custom prost_build::Config.

Trait Implementations

impl Clone for Builder

fn clone(&self) -> Builder

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Builder

fn fmt(&self, f: &mut Formatter) -> Result

Formats the value using the given formatter.