Scala3doc is configured in Build.scala

Author: romanowski

project/Build.scala

@@ -136,8 +136,6 @@ object Build {
 
   val fetchScalaJSSource = taskKey[File]("Fetch the sources of Scala.js")
 
-  val artifactsForScala3Documentation = taskKey[Seq[File]]("Artifacts to be documented by Scala3doc")
-
   lazy val SourceDeps = config("sourcedeps")
 
   // Settings shared by the build (scoped in ThisBuild). Used in build.sbt
@@ -1160,6 +1158,9 @@ object Build {
 
   val testcasesOutputDir = taskKey[String]("Root directory where tests classses are generated")
   val testcasesSourceRoot = taskKey[String]("Root directory where tests sources are generated")
+  val generateSelfDocumentation = inputKey[Unit]("Generate example documentation")
+  val generateScala3Documentation = taskKey[Unit]("Generate documentation for dotty lib")
+  val generateTestcasesDocumentation  = taskKey[Unit]("Generate documentation for testcases, usefull for debugging tests")
   lazy val `scala3doc` = project.in(file("scala3doc")).asScala3doc
   lazy val `scala3doc-testcases` = project.in(file("scala3doc-testcases")).asScala3docTestcases
 
@@ -1450,30 +1451,69 @@ object Build {
       settings(commonBenchmarkSettings).
       enablePlugins(JmhPlugin)
 
-    def asScala3doc: Project =
+    def asScala3doc: Project = {
+      def generateDocumentation(targets: String, name: String, outDir: String, params: String = "") = Def.taskDyn {
+          val sourceMapping = "=https://github.com/lampepfl/dotty/tree/master#L"
+          run.in(Compile).toTask(s""" -o output/$outDir -t $targets -n "$name" -s $sourceMapping $params""")
+      }
+
       project.settings(commonBootstrappedSettings).
         dependsOn(`scala3-compiler-bootstrapped`).
         dependsOn(`scala3-tasty-inspector`).
         settings(
           resolvers += Resolver.jcenterRepo,
           resolvers += Resolver.bintrayRepo("kotlin", "kotlin-dev"),
           resolvers += Resolver.bintrayRepo("virtuslab", "dokka"),
-          artifactsForScala3Documentation := Seq(
-            // All projects below will be used to generated documentation for Scala 3
-            classDirectory.in(`scala3-interfaces`).in(Compile).value,
-            classDirectory.in(`tasty-core`).in(Compile).value,
-            classDirectory.in(`scala3-library`).in(Compile).value,
-            // TODO this one fails to load using TASTY
-            // classDirectory.in(`stdlib-bootstrapped`).in(Compile).value,
+          libraryDependencies ++= Seq(
+            "org.scala-lang" %% "scala3-tasty-inspector" % scalaVersion.value,
+
+            "com.virtuslab.dokka" % "dokka-site" % "0.1.9",
+            "com.vladsch.flexmark" % "flexmark-all" % "0.42.12",
+            "nl.big-o" % "liqp" % "0.6.7",
+            "args4j" % "args4j" % "2.33",
+
+            "org.jetbrains.dokka" % "dokka-test-api" % "1.4.10.2" % "test",
+            "com.novocode" % "junit-interface" % "0.11" % "test",
           ),
-          test.in(Test) := {
-            // Test
-            compile.in(Compile).in(`scala3doc-testcases`).value
-            test.in(Test).value
-          },
+          test.in(Test) := test.in(Test).dependsOn(compile.in(Compile).in(`scala3doc-testcases`)).value,
           testcasesOutputDir.in(Test) := classDirectory.in(Compile).in(`scala3doc-testcases`).value.getAbsolutePath.toString,
-          testcasesSourceRoot.in(Test) := (baseDirectory.in(`scala3doc-testcases`).value / "src").getAbsolutePath.toString
+          testcasesSourceRoot.in(Test) := (baseDirectory.in(`scala3doc-testcases`).value / "src").getAbsolutePath.toString,
+          fork.in(run) := true,
+          Compile / mainClass := Some("dotty.dokka.Main"),
+          // There is a bug in dokka that prevents parallel tests withing the same jvm
+          fork.in(test) := true,
+          Test / parallelExecution := false,
+          generateSelfDocumentation := Def.inputTaskDyn {
+            generateDocumentation(classDirectory.in(Compile).value.getAbsolutePath, "scala3doc", "self", "-d documentation")
+          }.evaluated,
+          generateScala3Documentation := Def.taskDyn {
+            val dottyJars = Seq(
+              // All projects below will be used to generated documentation for Scala 3
+              classDirectory.in(`scala3-interfaces`).in(Compile).value,
+              classDirectory.in(`tasty-core`).in(Compile).value,
+              classDirectory.in(`scala3-library`).in(Compile).value,
+              // TODO this one fails to load using TASTY
+              // classDirectory.in(`stdlib-bootstrapped`).in(Compile).value,
+            )
+            val roots = dottyJars.map(_.toString).mkString(java.io.File.pathSeparator)
+
+            if (dottyJars.isEmpty) Def.task { streams.value.log.error("Dotty lib wasn't found") } 
+            else generateDocumentation(roots, "Scala 3", "stdLib", "-d dotty-docs/docs")
+          }.value,
+          generateTestcasesDocumentation := Def.taskDyn {
+            generateDocumentation(Build.testcasesOutputDir.in(Test).value, "Scala3doc testcases", "testcases")
+          }.value,
+          buildInfoKeys in Test := Seq[BuildInfoKey](
+            Build.testcasesOutputDir.in(Test),
+            Build.testcasesSourceRoot.in(Test),
+          ),
+          buildInfoPackage in Test := "dotty.dokka",
+          BuildInfoPlugin.buildInfoScopedSettings(Test),
+          BuildInfoPlugin.buildInfoDefaultSettings,
+          // Uncomment to debug dokka processing (require to run debug in listen mode on 5005 port)
+          // javaOptions.in(run) += "-agentlib:jdwp=transport=dt_socket,server=n,address=localhost:5005,suspend=y"
         )
+    }
 
     def asScala3docTestcases: Project =
       project.dependsOn(`scala3-compiler-bootstrapped`).settings(commonBootstrappedSettings)