Provides common settings for Scala projects, as they are typically configured at Driver.

sbt-settings is a suite of sbt autoplugins that provide common settings for the scala compiler, testing, linting, formatting, release process, packaging and publication.

Adding the following snippet to project/plugins.sbt will make the plugins available:

addSbtPlugin("xyz.driver" % "sbt-settings" % "<latest_tag>")

The next section exlains what plugins are available and which ones are activated out-of-the-box.

source

• Includes configuration for scalafmt and scalastyle, modifies the test task to check for formatting and styling.
• Sets strict compiler flags and treats warnings as errors (with the exception of deprecations).

This plugin can get in the way of developer productivity. If that is the case, it can simply be disabled.

source

Common settings for libraries. Sets the project organization and reads version information from git. It also enables overriding the version by setting a VERSION environment variable (which may be useful to do from CI).

source

Packages an application as a docker image and provides a way to include internal TLS certificates.

It also includes some utility commands such as start and stop (based on sbt-revolver, to enable rapid local development cycles of applications.

source

Augments the packaging configuration of ServicePlugin, to include integration tests in deployed applications images.

source

Adds a dependsOn extension method to projects, that allows depending on both source and binary versions of a project. It is similar to sbt-sriracha and is intended to increase productivity in multi-project workflows.

sbt-settings provides many plugins, which may be used in various ways. Typically however, a project is either a Library or a Service, and as such, it will enable one of those plugins explicitly. The other plugins will provide general settings for common conventions and are always enabled.

The following provides a typical example for configuring a project as a service called "myservice":

lazy val myservice = project
  .in(file("."))
  .enablePlugin(ServicePlugin)
  .disablePlugins(IntegrationTestPackaging) // we don't need integration tests
  .disablePlugins(LintPlugin) // I don't need style check during development!
  // use published artifact by default, and ../domain-model if SBT_WORKSPACE
  // is defined as ..
  .dependsOn("xyz.driver" %% "domain-model" % "1.2.3", "domain-model")
  .settings( /* custom settings */)

This project is set up to auto-deploy on push. If an annotated tag in the form v<digit>.* is pushed, a new version of this project will be built and published to Maven Central.