/
Parser.kt
101 lines (89 loc) · 3.82 KB
/
Parser.kt
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
95
96
97
98
99
100
101
package org.jetbrains.dokka.base.parsers
import org.jetbrains.dokka.model.doc.*
import org.jetbrains.dokka.model.doc.Deprecated
import org.jetbrains.dokka.model.doc.Suppress
abstract class Parser {
abstract fun parseStringToDocNode(extractedString: String): DocTag
abstract fun preparse(text: String): String
open fun parse(text: String): DocumentationNode =
DocumentationNode(jkdocToListOfPairs(preparse(text)).map { (tag, content) -> parseTagWithBody(tag, content) })
open fun parseTagWithBody(tagName: String, content: String): TagWrapper =
when (tagName) {
"description" -> Description(parseStringToDocNode(content))
"author" -> Author(parseStringToDocNode(content))
"version" -> Version(parseStringToDocNode(content))
"since" -> Since(parseStringToDocNode(content))
"see" -> See(
parseStringToDocNode(content.substringAfter(' ')),
content.substringBefore(' '),
null
)
"param" -> Param(
parseStringToDocNode(content.substringAfter(' ')),
content.substringBefore(' ')
)
"property" -> Property(
parseStringToDocNode(content.substringAfter(' ')),
content.substringBefore(' ')
)
"return" -> Return(parseStringToDocNode(content))
"constructor" -> Constructor(parseStringToDocNode(content))
"receiver" -> Receiver(parseStringToDocNode(content))
"throws", "exception" -> Throws(
parseStringToDocNode(content.substringAfter(' ')),
content.substringBefore(' '),
null
)
"deprecated" -> Deprecated(parseStringToDocNode(content))
"sample" -> Sample(
parseStringToDocNode(content.substringAfter(' ')),
content.substringBefore(' ')
)
"suppress" -> Suppress(parseStringToDocNode(content))
else -> CustomTagWrapper(parseStringToDocNode(content), tagName)
}
private fun jkdocToListOfPairs(javadoc: String): List<Pair<String, String>> =
"description $javadoc"
.splitIgnoredInsideBackticks("\n@")
.map { content ->
val contentWithEscapedAts = content.replace("\\@", "@")
val (tag, body) = contentWithEscapedAts.split(" ", limit = 2)
tag to body
}
private fun CharSequence.splitIgnoredInsideBackticks(delimiter: String): List<String> {
var countOfBackticks = 0
var countOfBackticksInOpeningFence = 0
var isInCode = false
val result = mutableListOf<String>()
var startRange = 0
var endRange = 0
var currentOffset = 0
while (currentOffset < length) {
if (get(currentOffset) == '`') {
countOfBackticks++
} else {
if (isInCode) {
// The closing code fence must be at least as long as the opening fence
isInCode = countOfBackticks < countOfBackticksInOpeningFence
} else {
if (countOfBackticks > 0) {
isInCode = true
countOfBackticksInOpeningFence = countOfBackticks
}
}
countOfBackticks = 0
}
if (!isInCode && startsWith(delimiter, currentOffset)) {
result.add(substring(startRange, endRange))
currentOffset += delimiter.length
startRange = currentOffset
endRange = currentOffset
continue
}
++endRange
++currentOffset
}
result.add(substring(startRange, endRange))
return result
}
}