Skip to content

Latest commit

 

History

History
 
 

grpc

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
eg/src
eg/src
 
 
gen/src/main/scala/io/buoyant/grpc/gen
gen/src/main/scala/io/buoyant/grpc/gen
 
 
interop
interop
 
 
runtime/src
runtime/src
 
 
README.md
README.md
 
 

README.md

io.buoyant.grpc

Protobuf3 & gRPC code generation for Finagle using io.buoyant:finagle-h2.

Status: Experimental; the runtime API may change.

io.buoyant:grpc-gen

The grpc-gen package assembles the protoc-gen-io.buoyant.grpc protoc plugin. This generator creates code that encodes/decodes idiomatic Scala case classes for proto3 data structures and generates gRPC server bindings using io.buoyant:finagle-h2.

A binary may be produced with the following command:

sbt> grpc-gen/assembly
...
[info] Packaging /.../l5d/grpc/gen/target/scala-2.11/protoc-gen-io.buoyant.grpc ...

SBT settings

The Grpc.grpcGenSettings SBT settings may be mixed into a project to automatically generate scala code from protobuf definitions. These settings ensure that the protoc-gen-io.buoyant.grpc binary is available so that the binary need not be manually installed.

io.buoyant:grpc-runtime

The grpc-runtime package provides de/serialization and communication primitives used by generated code.

Example: grpc-eg

The grpc-eg project contains only the proto definitions for an example gRPC service, along with a test that exercises this service.