simple scripts to run non-bootstrapped compiler after 'sbt buildQuick'

Author: lrytz

.gitignore

@@ -64,6 +64,8 @@ testlogs/
 local/
 compiler/test/debug/Gen.jar
 
+/bin/.cp
+
 before-pickling.txt
 after-pickling.txt
 bench/compile.txt

bin/commonQ

@@ -0,0 +1,6 @@
+cp=$(cat $ROOT/bin/.cp) 2> /dev/null
+
+if [[ "$cp" == "" ]]; then
+  echo "run 'sbt buildQuick' first"
+  exit 1
+fi

bin/scalaQ

@@ -0,0 +1,6 @@
+#!/usr/bin/env bash
+
+ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")" >& /dev/null && pwd)/.."
+. $ROOT/bin/commonQ
+
+java -cp $cp dotty.tools.MainGenericRunner -usejavacp "$@"

bin/scalacQ

@@ -0,0 +1,6 @@
+#!/usr/bin/env bash
+
+ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")" >& /dev/null && pwd)/.."
+. $ROOT/bin/commonQ
+
+java -cp $cp dotty.tools.dotc.Main -usejavacp "$@"

bin/scaladocQ

@@ -0,0 +1,6 @@
+#!/usr/bin/env bash
+
+ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")" >& /dev/null && pwd)/.."
+. $ROOT/bin/commonQ
+
+java -cp $cp dotty.tools.scaladoc.Main -usejavacp "$@"

docs/_docs/contributing/getting-started.md

@@ -81,6 +81,13 @@ $ scalac tests/pos/HelloWorld.scala
 $ scala HelloWorld
 ```
 
+Note that the `scalac` and `scala` scripts have slow roundtrip times when working on the compiler codebase: whenever
+any source file changes they invoke `sbt dist/pack` first.
+
+As an alternative, run the `buildQuick` task in sbt and then use the `scalacQ`, `scalaQ` and `scaladocQ` scripts
+in the `bin/` folder. These scripts invoke the compiler using the classfiles from the `out/` directory which are
+updated incrementally when working on the compiler.
+
 ## Starting a REPL
 
 ```bash

project/Build.scala

@@ -202,6 +202,8 @@ object Build {
 
   val repl = taskKey[Unit]("spawns a repl with the correct classpath")
 
+  val buildQuick = taskKey[Unit]("builds the compiler and enables bin/scalaQ, bin/scalacQ, bin/scaladocQ")
+
   // Compiles the documentation and static site
   val genDocs = inputKey[Unit]("run scaladoc to generate static documentation site")
 
@@ -2140,6 +2142,10 @@ object Build {
         // default.
         addCommandAlias("publishLocal", "scala3-bootstrapped/publishLocal"),
         repl := (`scala3-compiler-bootstrapped` / repl).value,
+        buildQuick := {
+          val cp = (LocalProject("scaladoc") / Compile / fullClasspath).value.map(_.data.getAbsolutePath).mkString(":")
+          IO.write(baseDirectory.value / "bin" / ".cp", cp)
+        },
         (Compile / console) := (Compile / console).dependsOn(Def.task {
           import _root_.scala.io.AnsiColor._
           val msg = "`console` uses the reference Scala version. Use `repl` instead."