Merge pull request sbt#116 from sbt/wip/0.8.0

0.8.0

README.markdown

@@ -8,15 +8,16 @@ sbt-buildinfo generates Scala source from your build definitions.
 Latest Stable
 -------------
 
-For sbt 0.13.6+ and sbt 1.x add sbt-buildinfo as a dependency in `project/buildinfo.sbt`:
+For sbt 1.x add sbt-buildinfo as a dependency in `project/plugins.sbt`:
 
 ![Bintray version](https://img.shields.io/bintray/v/eed3si9n/sbt-plugins/sbt-buildinfo.svg)
 
 ```scala
 addSbtPlugin("com.eed3si9n" % "sbt-buildinfo" % "x.y.z")
 ```
 
-For sbt 0.13.(x < 6), see [0.3.2](https://github.com/sbt/sbt-buildinfo/tree/0.3.2).
+- For sbt 0.13.(x >= 6), see [0.7.0](https://github.com/sbt/sbt-buildinfo/tree/v0.7.0).
+- For sbt 0.13.(x < 6), see [0.3.2](https://github.com/sbt/sbt-buildinfo/tree/0.3.2).
 
 Usage
 -----
@@ -27,7 +28,7 @@ Add the following in your `build.sbt`:
 lazy val root = (project in file(".")).
   enablePlugins(BuildInfoPlugin).
   settings(
-    buildInfoKeys := Seq[BuildInfoKey](name, version, scalaVersion, sbtVersion),
+    buildInfoKeys := BuildInfoKey.ofN(name, version, scalaVersion, sbtVersion),
     buildInfoPackage := "hello"
   )
 ```

build.sbt

@@ -1,5 +1,5 @@
 lazy val commonSettings: Seq[Setting[_]] = Seq(
-  git.baseVersion in ThisBuild := "0.7.0",
+  git.baseVersion in ThisBuild := "0.8.0",
   organization in ThisBuild := "com.eed3si9n"
 )
 

notes/0.8.0.markdown

@@ -0,0 +1,32 @@
+sbt-buildinfo 0.8.0 is published for sbt 1.
+
+### BuildInfoKey.of(...) and BuildInfoKey.ofN(...)
+
+Prior to 0.8.0 when sbt-buildinfo generated the `BuildInfo` object using tasks, it was executing the tasks out-of-graph.
+This would occasionally cause race conditions when used with side-effecty tasks.
+
+To workaround this issue sbt-buildinfo introduces a new `BuildInfokey.of(...)` and `BuildInfoKey.ofN(...)` macro that will safely execute the tasks within the control of the task engine.
+
+#### Before 0.8.0
+
+```scala
+lazy val root = (project in file("."))
+  .enablePlugins(BuildInfoPlugin)
+  .settings(
+    buildInfoKeys := Seq[BuildInfoKey](name, version, someTask),
+    buildInfoPackage := "hello"
+  )
+```
+
+#### After 0.8.0
+
+```scala
+lazy val root = (project in file("."))
+  .enablePlugins(BuildInfoPlugin)
+  .settings(
+    buildInfoKeys := BuildInfoKey.ofN(name, version, someTask),
+    buildInfoPackage := "hello"
+  )
+```
+
+This feature was contributed by @dwijnand as #114

project/build.properties

@@ -1 +1 @@
-sbt.version=1.1.0
+sbt.version=1.1.1