1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
|
package org.jetbrains.dokka.allModulesPage
import org.jetbrains.dokka.CoreExtensions
import org.jetbrains.dokka.DokkaConfiguration
import org.jetbrains.dokka.DokkaGenerator
import org.jetbrains.dokka.pages.RootPageNode
import org.jetbrains.dokka.plugability.DokkaContext
import org.jetbrains.dokka.plugability.DokkaPlugin
import org.jetbrains.dokka.testApi.logger.TestLogger
import org.jetbrains.dokka.testApi.testRunner.AbstractTest
import org.jetbrains.dokka.testApi.testRunner.DokkaTestGenerator
import org.jetbrains.dokka.testApi.testRunner.TestBuilder
import org.jetbrains.dokka.testApi.testRunner.TestMethods
import org.jetbrains.dokka.utilities.DokkaConsoleLogger
import org.jetbrains.dokka.utilities.DokkaLogger
import org.jetbrains.dokka.utilities.LoggingLevel
class MultiModuleDokkaTestGenerator(
configuration: DokkaConfiguration,
logger: DokkaLogger,
testMethods: MultiModuleTestMethods,
additionalPlugins: List<DokkaPlugin> = emptyList()
) : DokkaTestGenerator<MultiModuleTestMethods>(
configuration,
logger,
testMethods,
additionalPlugins + AllModulesPagePlugin()
) {
override fun generate() = with(testMethods) {
val dokkaGenerator = DokkaGenerator(configuration, logger)
val context =
dokkaGenerator.initializePlugins(configuration, logger, additionalPlugins + AllModulesPagePlugin())
pluginsSetupStage(context)
val generation = context.single(CoreExtensions.generation) as AllModulesPageGeneration
val generationContext = generation.processSubmodules()
submoduleProcessingStage(context)
val allModulesPage = generation.createAllModulesPage(generationContext)
allModulesPageCreationStage(allModulesPage)
val transformedPages = generation.transformAllModulesPage(allModulesPage)
pagesTransformationStage(transformedPages)
generation.render(transformedPages)
renderingStage(transformedPages, context)
generation.processMultiModule(transformedPages)
processMultiModule(transformedPages)
generation.finishProcessingSubmodules()
finishProcessingSubmodules(context)
}
}
open class MultiModuleTestMethods(
open val pluginsSetupStage: (DokkaContext) -> Unit,
open val allModulesPageCreationStage: (RootPageNode) -> Unit,
open val pagesTransformationStage: (RootPageNode) -> Unit,
open val renderingStage: (RootPageNode, DokkaContext) -> Unit,
open val submoduleProcessingStage: (DokkaContext) -> Unit,
open val processMultiModule: (RootPageNode) -> Unit,
open val finishProcessingSubmodules: (DokkaContext) -> Unit,
) : TestMethods
class MultiModuleTestBuilder : TestBuilder<MultiModuleTestMethods>() {
var pluginsSetupStage: (DokkaContext) -> Unit = {}
var allModulesPageCreationStage: (RootPageNode) -> Unit = {}
var pagesTransformationStage: (RootPageNode) -> Unit = {}
var renderingStage: (RootPageNode, DokkaContext) -> Unit = { _, _ -> }
var submoduleProcessingStage: (DokkaContext) -> Unit = {}
var processMultiModule: (RootPageNode) -> Unit = {}
var finishProcessingSubmodules: (DokkaContext) -> Unit = {}
override fun build() = MultiModuleTestMethods(
pluginsSetupStage,
allModulesPageCreationStage,
pagesTransformationStage,
renderingStage,
submoduleProcessingStage,
processMultiModule,
finishProcessingSubmodules
)
}
abstract class MultiModuleAbstractTest(logger: TestLogger = TestLogger(DokkaConsoleLogger(LoggingLevel.DEBUG))) :
AbstractTest<MultiModuleTestMethods, MultiModuleTestBuilder, MultiModuleDokkaTestGenerator>(
::MultiModuleTestBuilder,
::MultiModuleDokkaTestGenerator,
logger,
)
|