monix-grpc

A library to write grpc client and servers in Scala using Monix.

Design Goals

Support all unary and streaming flavors of grpc calls
Provide nimble and fast Monix building blocks on top of grpc-java
Implement efficient cancellation, buffering and back-pressure out-of-the-box
Embrace and extend grpc-java's' API safely and idiomatically instead of creating a new API

Installation

sbt

Add the following to your project/plugins.sbt:

addSbtPlugin("com.thesamet" % "sbt-protoc" % "1.0.4")

libraryDependencies +=
  "me.vican.jorge" %% "monix-grpc-codegen" % "0.0.0+46-e1776191"

Add the following to your build.sbt:

lazy val root = project
  .settings(
    Compile / PB.targets := Seq(
      scalapb.gen(grpc = false) -> (Compile / sourceManaged).value / "scalapb",
      monix.grpc.codegen.GrpcCodeGenerator -> (Compile / sourceManaged).value / "scalapb"
    ),

    libraryDependencies ++= Seq(
        "io.grpc" % "grpc-netty" % "1.39.0",
        "com.thesamet.scalapb" %% "scalapb-runtime-grpc" % scalapb.compiler.Version.scalapbVersion
    )
  )

Generator options

Options can be set like:

      monix.grpc.codegen.GrpcCodeGenerator(serviceSuffix = "MySuffix") -> (Compile / sourceManaged).value / "scalapb"

The current options are:

serviceSuffix: sets the suffix of the generated service name, the default is Api.

Example projects:

sbt project

Team

The current maintainers (people who can merge pull requests) are:

Jorge Vicente Cantero - @jvican
Boris Smidt - @borissmidt

Credits

Powered by ScalaPB and grpc/grpc-java.
Inspired by salesforce/reactive-grpc, typelevel/fs2-grpc and scalapb/zio-grpc among others.

monix / monix-grpc

readme