Common sbt settings
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
addSbtPlugin("xyz.driver" % "sbt-settings" % "<latest_tag>")
The next section exlains what plugins are available and which ones are activated out-of-the-box.
|IntegrationTestPackaging||automatic, if ServicePlugin is enabled|
- Includes configuration for scalafmt and scalastyle, modifies the
testtask 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.
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
Packages an application as a docker image and provides a way to include internal TLS certificates.
It also includes some utility commands such as
(based on sbt-revolver, to
enable rapid local development cycles of applications.
Integration Test Packaging
Augments the packaging configuration of ServicePlugin, to include integration tests in deployed applications images.
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
Canonical Use Case
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 */)
Developing this Plugin
This project is set up to auto-deploy on push. If an annotated tag in
v<digit>.* is pushed, a new version of this project will be
built and published to Maven Central.