Merge pull request #783 from scalacenter/release/1.2.1

Prepare for 1.2.1 release

docs/tools/homebrew/usage.md

@@ -20,4 +20,8 @@ To learn more about `bloop server` and managing the server lifecycle automatical
 
 ### Command-line completions
 
-The installation script will automatically install completions for bash, zsh and fish.
+The installation script automatically installs completions for bash, zsh and fish.
+
+To use them you **need to** set up your shell to source Homebrew-installed completions by following
+the [Homebrew Shell Completion](https://docs.brew.sh/Shell-Completion) guide. If you've already
+set them up for previous Homebrew packages you can skip the guide.

notes/v1.2.1.md

@@ -0,0 +1,57 @@
+# bloop `v1.2.1` :surfer:
+
+## Upgrade guide :electric_plug:
+
+This section describes the upgrade steps. If you don't have bloop installed, please read
+the [installation instructions][] instead.
+
+If you're on macOS, **upgrade** to the latest version with:
+
+```sh
+$ brew upgrade scalacenter/bloop/bloop
+$ brew services restart bloop
+```
+
+If you're on Windows using `scoop`, **upgrade** to the latest version with:
+
+```sh
+$ scoop upgrade bloop
+$ bloop ng-stop
+$ // Start the server as you usually do (via systemd, manually, desktop services)
+```
+
+Otherwise, run:
+
+```
+$ curl -L https://github.com/scalacenter/bloop/releases/download/v1.2.1/install.py | python
+$ bloop ng-stop
+$ // Start the server as you usually do (via systemd, manually, desktop services)
+```
+
+Read the complete installation instructions in our [Installation page][installation instructions].
+
+## Highlights :books:
+
+`v1.2.1` is mostly a bugfix release.
+
+### Clear bsp diagnostics earlier ([#782](https://github.com/scalacenter/bloop/pull/782))
+
+Bloop's build server now clears diagnostics incrementally at the end of every incremental compiler cycle.
+
+### Document shell completion setup and use in macOS ([#781](https://github.com/scalacenter/bloop/issues/781))
+
+If shell completions don't work for your macOS system, follow the Homebrew installation instructions
+and jump to the completions section that links to the [Homebrew guide to set up Homebrew-installed
+completions](https://docs.brew.sh/Shell-Completion).
+
+## Fixes :bug: :hammer:
+
+1. [Use of transactional class file manager by default](https://github.com/scalacenter/bloop/pull/779)
+1. [Make the launcher work for `v1.2.0` and not only `v1.1.2`](https://github.com/scalacenter/bloop/pull/780)
+
+## Contributors :busts_in_silhouette:
+
+According to `git shortlog -sn --no-merges v1.2.0..v1.2.1`, 1 people contributed to this `v1.2.1`
+release: Jorge Vicente Cantero.
+
+[installation instructions]: https://scalacenter.github.io/bloop/setup

project/ReleaseUtils.scala

@@ -94,6 +94,7 @@ object ReleaseUtils {
        |  sha256 "$installSha"
        |  bottle :unneeded
        |
+       |  depends_on "bash-completion"
        |  depends_on "python3"
        |  depends_on :java => "1.8+"
        |
@@ -167,7 +168,7 @@ object ReleaseUtils {
     }
   }
 
-  def generateScoopFormulaContents(version: String, origin: FormulaOrigin): String = {
+  def generateScoopFormulaContents(version: String, sha: String, origin: FormulaOrigin): String = {
     val url = {
       origin match {
         case Left(f) => s"""${f.toPath.toUri.toString.replace("\\", "\\\\")}"""
@@ -178,6 +179,7 @@ object ReleaseUtils {
     s"""{
        |  "version": "$version",
        |  "url": "$url",
+       |  "hash": "sha256:$sha",
        |  "depends": "python",
        |  "bin": "bloop.cmd",
        |  "env_add_path": "$$dir",
@@ -197,10 +199,11 @@ object ReleaseUtils {
     val version = Keys.version.value
     val versionDir = Keys.target.value / version
     val installScript = versionedInstallScript.value
+    val installSha = sha256(installScript)
 
     val formulaFileName = "bloop.json"
     val targetLocalFormula = versionDir / formulaFileName
-    val contents = generateScoopFormulaContents(version, Left(installScript))
+    val contents = generateScoopFormulaContents(version, installSha, Left(installScript))
 
     if (!versionDir.exists()) IO.createDirectory(versionDir)
     IO.write(targetLocalFormula, contents)