malcolmgreaves / sbt-dev-settings   0.6.2

Apache License 2.0 GitHub

An sbt plugin that helps one manage project settings.

Scala versions: 2.10
sbt plugins: 0.13


Build Status Codacy Badge Join the chat at Stories in Ready Maven Central

What is this?

sbt-dev-settings is a plugin that lets you standardize build settings across many Scala projects.

Why use this?

By depending on this plugin, you have access to a standard set of methods that declaritively modify sbt SettingsKey instances. You don't have to copy-paste settings and worry about making sure about keeping our build configurations in sync across all libraries. Highlights of this plugin include standardization for:

  • scalarifomSettings: Code formatting rules through Scalarifom
  • scalacOptions and javacOptions: Bringing-in lots of useful compilier options
  • javaOptions: Configuring the Java runtime, bringing optimal options on a per-JVM version basis
  • publishTo: Tired of messing up your POM and getting rejected from Sonatype? makes publish configurations a whole lot simpler!
  • And more for docker, sbt-git, and common logging and testing dependencies!

Do I have to learn new sbt commands?

No! (yay!)

This plugin only configures common sbt SettkingsKey values. So you can continue using compile, test, publish in sbt just as you used to.


So how do I use this?

Here's an example for configuring a build.sbt file:

// inclues sbt-dev-settings plugin objects and types
// * Publish, PublishHelpers
// * CompileScalaJava
// * JvmRuntime
// Pulls in helper types for publishing internally. This includes
// * SemanticVersion
// * Repository
// * ArtifactInfo
// * License
import PublishHelpers._   

// // GAV coordinates // //

lazy val pName = "YOUR_PROJECT_NAME"
lazy val semver = SemanticVersion(MAJOR, MINOR, PATCH, isSnapshot = {true, false})
organization := "YOUR_GROUP_ID"
name := pName
version := semver.toString

// // scala & java settings // //

// There's a lot of room to configure scala, java compilation options.
// Including incremental compilation options for scala. See `CompileScalaJava.scala`
// for details.
// This default configuration does not change incremental compilation options,
// uses Java 8, has fatal warnings, emits optimized bytecode for Scala, and
// enables many language features (e.g. macros, higher kinded types, implicits, etc.).
val devConfig = Config.default

// Use `devConfig` to set the scalacOptions, javacOptions, and incOptions settings.
scalaVersion := "2.11.7"
// `librarySettings` sets up cross compilation for 2.11.7 and 2.10.6.
// If doing plugin development, use `CompileScalaJava.pluginSettings`,
// which ensures that we're using only 2.10 and not cross compiling.

// Set the Java runtime options from the same config.
javaOptions := JvmRuntime.settings(devConfig.jvmVer)

// // Publish Settings // //

// set publishTo with XML generated from this method
  repo = Repository(
   group         = "YOUR_REPO_GROUP_NAME", 
   name          = pName,
   sourceControl = "URL_TO_HOSTED"
  // if using Github, consider the simplier method: Repository.github(group,name)
  developers =
       id    = "YOUR_USER_ID",
       name  = "YOUR_NAME",
       email = "YOUR_EMAIL_ADDRESS",
       url   = "URL_TO_YOU"
  art = // Where you'll be publishing your repo. E.g. sonatype
  lic = // The license for your code. E.g. Apache 2.0


Add the following to your project/plugins.sbt file:

addSbtPlugin("com.gonitro" % "sbt-dev-settings" % "X.Y.Z")

Where X.Y.Z is the most recent one from sonatype.

Deeper Dive: Build Settings

Scala version & compiler settings

Docker publishing settings.

sbt-git versioning settings.

Publishing to your own Artifactory, Nexus, or other Maven-compatiable jar storage. Depends on types defined in PublishHelpers.

Settings for the Java runtime. Includes Java version 6, 7, and 8.

Code formatting settings using scalarifom.

Common dependencies for fundamental things, e.g. logging and testing.

How Do I Contribute?

We welcome all pull requests! We <3 this software; we want it to be used and be useful. Please submit a PR for any changes to kick-off a code review to reach consensus.


Copyright 2015- Malcolm Greaves

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.