blob: aa0b16ca457b6304c864ae458af221f48951a21f (
plain)
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 transformers
import org.jetbrains.dokka.base.transformers.documentables.ModuleAndPackageDocumentationReader
import org.jetbrains.dokka.plugability.DokkaContext
import org.jetbrains.dokka.utilities.DokkaConsoleLogger
import org.jetbrains.dokka.utilities.LoggingLevel
import org.junit.jupiter.api.BeforeEach
import org.junit.jupiter.api.Test
import testApi.testRunner.TestDokkaConfigurationBuilder
import testApi.testRunner.dModule
import kotlin.test.assertEquals
import kotlin.test.assertTrue
class InvalidContentModuleAndPackageDocumentationReaderTest : AbstractContextModuleAndPackageDocumentationReaderTest() {
private val includeA by lazy { temporaryDirectory.resolve("includeA.md").toFile() }
private val includeB by lazy { temporaryDirectory.resolve("includeB.md").toFile() }
@BeforeEach
fun materializeInclude() {
includeA.writeText(
"""
Invalid random stuff
# Module moduleA
Simple stuff
""".trimIndent()
)
includeB.writeText(
"""
# Module moduleB
###
""".trimIndent()
)
}
private val configurationBuilderA = TestDokkaConfigurationBuilder().apply {
moduleName = "moduleA"
}
private val configurationBuilderB = TestDokkaConfigurationBuilder().apply {
moduleName = "moduleB"
}
private val sourceSetA by configurationBuilderA.sourceSet {
includes = listOf(includeA.canonicalPath)
}
private val sourceSetB by configurationBuilderB.sourceSet {
includes = listOf(includeB.canonicalPath)
}
private val contextA by lazy {
DokkaContext.create(
configuration = configurationBuilderA.build(),
logger = DokkaConsoleLogger(LoggingLevel.DEBUG),
pluginOverrides = emptyList()
)
}
private val contextB by lazy {
DokkaContext.create(
configuration = configurationBuilderB.build(),
logger = DokkaConsoleLogger(LoggingLevel.DEBUG),
pluginOverrides = emptyList()
)
}
private val readerA by lazy { ModuleAndPackageDocumentationReader(contextA) }
private val readerB by lazy { ModuleAndPackageDocumentationReader(contextB) }
@Test
fun `parsing should fail with a message when documentation is in not proper format`() {
val exception =
runCatching { readerA[dModule(name = "moduleA", sourceSets = setOf(sourceSetA))] }.exceptionOrNull()
assertEquals(
"Unexpected classifier: \"Invalid\", expected either \"Module\" or \"Package\". \n" +
"For more information consult the specification: https://kotlinlang.org/docs/reference/dokka-module-and-package-docs.html",
exception?.message
)
}
@Test
fun `parsing should fail with a message where it encountered error and why`() {
val exception =
runCatching { readerB[dModule(name = "moduleB", sourceSets = setOf(sourceSetB))] }.exceptionOrNull()?.message!!
//I don't want to assert whole message since it contains a path to a temporary folder
assertTrue(exception.contains("Wrong AST Tree. Header does not contain expected content in "))
assertTrue(exception.contains("includeB.md"))
assertTrue(exception.contains("element starts from offset 0 and ends 3: ###"))
}
}
|
