A collection of sbt plugins providing build integration for the rest.li REST framework.

The restli-tools-scala module contains a doc provider for rest.li resources written in Scala. It is included automatically when using sbt-restli, but you may depend on it directly if you are using the gradle pegasus plugin.

NOTE: sbt-restli is built and tested against pegasus v24.0.2. While it should be compatible with other versions, no guarantees can be made.

Install the plugins to your sbt project in project/plugins.sbt:

addSbtPlugin("com.linkedin.sbt-restli" % "sbt-restli" % "<version>")

Sbt-restli contains 4 individual plugins. A typical rest.li project might apply these plugins to 3 sbt subprojects:

1. An API project, applying the RestliSchemaPlugin and (optionally) the RestliAvroPlugin.
2. A server project, applying the RestliModelPlugin.
3. A client project, applying the RestliClientPlugin.

The rest.li schema plugin compiles pegasus data-schemas (*.pdsc files) into Java data-template classes.

Apply the plugin to your project in build.sbt and place data-schemas in the src/main/pegasus directory.

lazy val api = (project in file("api"))
  .enablePlugins(RestliSchemaPlugin)
  .settings(
    libraryDependencies ++= Seq(
      "com.linkedin.pegasus" % "data" % "24.0.2",
      "com.google.code.findbugs" % "jsr305" % "3.0.0"
    )
  )

The rest.li model plugin generates rest models (restspec & snapshot files) from your rest.li resource annotations, checks if they are compatible, and publishes them to your API project.

Apply the plugin to your project in build.sbt and set your API project using restliModelApi, then set your compatibility mode using restliModelCompat to one of OFF, IGNORE, BACKWARDS (default), or EQUIVALENT.

Publishing your changes using the restliModelPublish task will copy rest models into your API project if they are compatible according to the compatibility mode selected.

lazy val server = (project in file("server"))
  .enablePlugins(RestliModelPlugin)
  .dependsOn(api)
  .settings(
    restliModelApi := api,
    libraryDependencies += "com.linkedin.pegasus" % "restli-server" % "24.0.2"
  )

The rest.li client plugin generates Java client bindings from rest models.

Apply the plugin to your project in build.sbt and set your API project using restliClientApi.

lazy val client = (project in file("client"))
  .enablePlugins(RestliClientPlugin)
  .dependsOn(api)
  .settings(
    restliClientApi := api,
    libraryDependencies += "com.linkedin.pegasus" % "restli-client" % "24.0.2"
  )

The rest.li avro plugin generates avro data-schemas from pegasus data-schemas in src/main/pegasus.

Apply the plugin to your project in build.sbt and place data-schemas in the src/main/pegasus directory.

lazy val avro = (project in file("api"))
  .enablePlugins(RestliAvroPlugin)

The avro plugin may be used in conjunction with the schema plugin by applying them to the same project.

lazy val api = (project in file("api"))
  .enablePlugins(RestliSchemaPlugin, RestliAvroPlugin)
  .settings(
    libraryDependencies ++= Seq(
      "com.linkedin.pegasus" % "data" % "24.0.2",
      "com.google.code.findbugs" % "jsr305" % "3.0.0"
    )
  )