Allow documenting community build projects

Author: abgruszecki

community-build/src/scala/dotty/communitybuild/Main.scala

@@ -1,13 +1,20 @@
 package dotty.communitybuild
 
 object Main {
-  /** Builds stdlib.
-   *
-   *  Output is available in build/pack/lib directory in stdlib project.
-   *
-   *  In the future, we allow building different projects based on arguments,
-   *  but for now stdlib is the only usecase.
-   */
+  /** Allows running various commands on community build projects. */
   def main(args: Array[String]): Unit =
-    projects.stdLib213.publish()
+    if args.length != 2 then
+      println("USAGE: <COMMAND> <PROJECT NAME>")
+      println("COMMAND is one of: publish doc")
+      println("Available projects are:")
+      projects.projectMap.keys.foreach { k =>
+        println(s"\t$k")
+      }
+      sys.exit(0)
+
+    val Array(cmd, proj) = args
+    cmd match {
+      case "doc" => projects(proj).doc()
+      case "publish" => projects(proj).publish()
+    }
 }

community-build/src/scala/dotty/communitybuild/projects.scala

@@ -45,23 +45,37 @@ sealed trait CommunityProject:
   val project: String
   val testCommand: String
   val publishCommand: String
+  val docCommand: String
   val dependencies: List[CommunityProject]
   val binaryName: String
   val runCommandsArgs: List[String] = Nil
 
   final val projectDir = communitybuildDir.resolve("community-projects").resolve(project)
 
+  final def publishDependencies(): Unit =
+    dependencies.foreach(_.publish())
+
   /** Publish this project to the local Maven repository */
   final def publish(): Unit =
     if !published then
-      dependencies.foreach(_.publish())
+      publishDependencies()
       log(s"Publishing $project")
       if publishCommand eq null then
         throw RuntimeException(s"Publish command is not specified for $project. Project details:\n$this")
       val exitCode = exec(projectDir, binaryName, (runCommandsArgs :+ publishCommand): _*)
       if exitCode != 0 then
         throw RuntimeException(s"Publish command exited with code $exitCode for project $project. Project details:\n$this")
       published = true
+
+  final def doc(): Unit =
+    publishDependencies()
+    log(s"Documenting $project")
+    if docCommand eq null then
+      throw RuntimeException(s"Doc command is not specified for $project. Project details:\n$this")
+    val exitCode = exec(projectDir, binaryName, (runCommandsArgs :+ docCommand): _*)
+    if exitCode != 0 then
+      throw RuntimeException(s"Doc command exited with code $exitCode for project $project. Project details:\n$this")
+
 end CommunityProject
 
 final case class MillCommunityProject(
@@ -71,14 +85,17 @@ final case class MillCommunityProject(
   override val binaryName: String = "./mill"
   override val testCommand = s"$baseCommand.test"
   override val publishCommand = s"$baseCommand.publishLocal"
+  override val docCommand = null
   override val runCommandsArgs = List("-i", "-D", s"dottyVersion=$compilerVersion")
 
 final case class SbtCommunityProject(
     project: String,
     sbtTestCommand: String,
     extraSbtArgs: List[String] = Nil,
     dependencies: List[CommunityProject] = Nil,
-    sbtPublishCommand: String = null) extends CommunityProject:
+    sbtPublishCommand: String = null,
+    sbtDocCommand: String = null
+  ) extends CommunityProject:
   override val binaryName: String = "sbt"
 
   // A project in the community build can depend on an arbitrary version of
@@ -105,7 +122,10 @@ final case class SbtCommunityProject(
     ++ s"++$compilerVersion!; "
 
   override val testCommand = s"$baseCommand$sbtTestCommand"
-  override val publishCommand = s"$baseCommand$sbtPublishCommand"
+  override val publishCommand = if sbtPublishCommand eq null then null else s"$baseCommand$sbtPublishCommand"
+  override val docCommand =
+    if sbtDocCommand eq null then null else
+      s"$baseCommand;set every useScala3doc := true $sbtDocCommand"
 
   override val runCommandsArgs: List[String] =
     // Run the sbt command with the compiler version and sbt plugin set in the build
@@ -119,6 +139,7 @@ final case class SbtCommunityProject(
     )
 
 object projects:
+
   lazy val utest = MillCommunityProject(
     project = "utest",
     baseCommand = s"utest.jvm[$compilerVersion]",
@@ -230,6 +251,7 @@ object projects:
   lazy val betterfiles = SbtCommunityProject(
     project       = "betterfiles",
     sbtTestCommand   = "dotty-community-build/compile",
+    sbtDocCommand   = ";core/doc ;akka/doc ;shapelessScanner/doc"
   )
 
   lazy val ScalaPB = SbtCommunityProject(
@@ -331,6 +353,7 @@ object projects:
   lazy val scalaz = SbtCommunityProject(
     project          = "scalaz",
     sbtTestCommand   = "rootJVM/test",
+    // has doc/sources set to Nil
     dependencies     = List(scalacheck)
   )
 
@@ -360,4 +383,49 @@ object projects:
     sbtTestCommand = "compat30/test",
   )
 
+  val projectMap = Map(
+    "utest" -> utest,
+    "sourcecode" -> sourcecode,
+    "oslib" -> oslib,
+    "oslibWatch" -> oslibWatch,
+    "ujson" -> ujson,
+    "upickle" -> upickle,
+    "upickleCore" -> upickleCore,
+    "geny" -> geny,
+    "fansi" -> fansi,
+    "pprint" -> pprint,
+    "requests" -> requests,
+    "scas" -> scas,
+    "intent" -> intent,
+    "algebra" -> algebra,
+    "scalacheck" -> scalacheck,
+    "scalatest" -> scalatest,
+    "scalatestplusScalacheck" -> scalatestplusScalacheck,
+    "scalaXml" -> scalaXml,
+    "scopt" -> scopt,
+    "scalap" -> scalap,
+    "squants" -> squants,
+    "betterfiles" -> betterfiles,
+    "ScalaPB" -> ScalaPB,
+    "minitest" -> minitest,
+    "fastparse" -> fastparse,
+    "stdLib213" -> stdLib213,
+    "shapeless" -> shapeless,
+    "xmlInterpolator" -> xmlInterpolator,
+    "effpi" -> effpi,
+    "sconfig" -> sconfig,
+    "zio" -> zio,
+    "munit" -> munit,
+    "scodecBits" -> scodecBits,
+    "scodec" -> scodec,
+    "scalaParserCombinators" -> scalaParserCombinators,
+    "dottyCpsAsync" -> dottyCpsAsync,
+    "scalaz" -> scalaz,
+    "endpoints4s" -> endpoints4s,
+    "catsEffect2" -> catsEffect2,
+    "catsEffect3" -> catsEffect3,
+    "scalaCollectionCompat" -> scalaCollectionCompat
+  )
+  def apply(key: String) = projectMap(key)
+
 end projects

project/Build.scala

@@ -1302,6 +1302,7 @@ object Build {
         (publishLocal in `tasty-core-bootstrapped`).value
         (publishLocal in `scala3-library-bootstrapped`).value
         (publishLocal in `scala3-doc-bootstrapped`).value
+        (publishLocal in `scala3doc`).value
         (publishLocal in `scala3-compiler-bootstrapped`).value
         (publishLocal in `sbt-dotty`).value
         (publishLocal in `scala3-bootstrapped`).value
@@ -1318,6 +1319,7 @@ object Build {
         TestFrameworks.JUnit,
         "--include-categories=dotty.communitybuild.TestCategory",
       ),
+      Compile/run := (Compile/run).dependsOn(prepareCommunityBuild).evaluated,
       (Test / testOnly) := ((Test / testOnly) dependsOn prepareCommunityBuild).evaluated,
       (Test / test    ) := ((Test / test    ) dependsOn prepareCommunityBuild).value,
       javaOptions ++= {