Introduce wrapper over dokka tests

Author: Kordyjan

scala3doc/test/dotty/dokka/ScaladocTest.scala

@@ -0,0 +1,85 @@
+package dotty.dokka
+
+import org.jetbrains.dokka.plugability.DokkaContext
+import org.jetbrains.dokka.model.{DModule, WithChildren}
+import org.jetbrains.dokka.pages.RootPageNode
+import org.jetbrains.dokka.testApi.testRunner.{DokkaTestGenerator, TestMethods}
+import org.jetbrains.dokka.testApi.logger.TestLogger
+import org.jetbrains.dokka.utilities.DokkaConsoleLogger
+import org.jetbrains.dokka.DokkaConfiguration
+import scala.jdk.CollectionConverters.{ListHasAsScala, SeqHasAsJava}
+import org.junit.Test
+import org.junit.rules.TemporaryFolder
+import java.io.File
+
+abstract class ScaladocTest(val name: String):
+  def assertions: Seq[Assertion]
+
+  private def getTempDir() : TemporaryFolder =
+    val folder = new TemporaryFolder()
+    folder.create()
+    folder
+
+  private def args = Args(
+      name = "test",
+      tastyRoots = Nil ,
+      classpath =  System.getProperty("java.class.path"),
+      None,
+      output = getTempDir().getRoot,
+      projectVersion = "1.0",
+      projectTitle = None,
+      projectLogo = None,
+      defaultSyntax = None,
+      sourceLinks = Nil
+    )
+
+  private def tastyFiles = 
+    def collectFiles(dir: File): List[String] = dir.listFiles.toList.flatMap {
+        case f if f.isDirectory => collectFiles(f)
+        case f if f.getName endsWith ".tasty" => f.getAbsolutePath :: Nil
+        case _ => Nil
+      }
+    collectFiles(File(s"target/scala-0.27/classes/tests/$name"))
+
+  @Test
+  def executeTest = 
+    DokkaTestGenerator(
+      DottyDokkaConfig(DocConfiguration.Standalone(args, tastyFiles)),
+      TestLogger(DokkaConsoleLogger.INSTANCE),
+      assertions.asTestMethods,
+      Nil.asJava
+    ).generate()
+
+end ScaladocTest
+
+/**
+ * Those assertions map 1-1 to their dokka counterparts. Some of them may be irrelevant in scala3doc.
+ */
+enum Assertion:
+  case AfterPluginSetup(fn: DokkaContext => Unit)
+  case DuringValidation(fn: (() => Unit) => Unit)
+  case AfterDocumentablesCreation(fn: Seq[DModule] => Unit)
+  case AfterPreMergeDocumentablesTransformation(fn: Seq[DModule] => Unit)
+  case AfterDocumentablesMerge(fn: DModule => Unit)
+  case AfterDocumentablesTransformation(fn: DModule => Unit)
+  case AfterPagesGeneration(fn: RootPageNode => Unit)
+  case AfterPagesTransformation(fn: RootPageNode => Unit)
+  case AfterRendering(fn: (RootPageNode, DokkaContext) => Unit)
+
+extension (s: Seq[Assertion]):
+  def asTestMethods: TestMethods =
+    import Assertion._
+    TestMethods(
+      (context => s.collect { case AfterPluginSetup(fn) => fn(context) }.kUnit),
+      (validator => s.collect { case DuringValidation(fn) => fn(() => validator) }.kUnit),
+      (modules => s.collect { case AfterDocumentablesCreation(fn) => fn(modules.asScala.toSeq) }.kUnit),
+      (modules => s.collect { case AfterPreMergeDocumentablesTransformation(fn) => fn(modules.asScala.toSeq) }.kUnit),
+      (module => s.collect { case AfterDocumentablesMerge(fn) => fn(module)}.kUnit),
+      (module => s.collect { case AfterDocumentablesTransformation(fn) => fn(module) }.kUnit),
+      (root => s.collect { case AfterPagesGeneration(fn) => fn(root) }.kUnit),
+      (root => s.collect { case AfterPagesTransformation(fn) => fn(root) }.kUnit),
+      ((root, context) => s.collect { case AfterRendering(fn) => fn(root, context)}.kUnit)
+    )
+
+extension [T] (s: T):
+  private def kUnit = kotlin.Unit.INSTANCE