aboutsummaryrefslogtreecommitdiff
path: root/plugins/kotlin-as-java/src/main/kotlin/transformers/JvmNameDocumentableTransformer.kt
blob: 3fb26034bf265a22f2d1edef3b3099f0178e737f (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
95
96
package org.jetbrains.dokka.kotlinAsJava.transformers

import org.jetbrains.dokka.model.*
import org.jetbrains.dokka.plugability.DokkaContext
import org.jetbrains.dokka.transformers.documentation.DocumentableTransformer

class JvmNameDocumentableTransformer : DocumentableTransformer {
    private val jvmNameProvider = JvmNameProvider()
    private lateinit var context: DokkaContext

    override fun invoke(original: DModule, context: DokkaContext): DModule {
        this.context = context
        return original.copy(packages = original.packages.map { transform(it) })
    }

    private fun <T : Documentable> transform(documentable: T): T =
        with(documentable) {
            when (this) {
                is DPackage -> copy(
                    functions = functions.map { transform(it) },
                    properties = properties.map { transform(it) },
                    classlikes = classlikes.map { transform(it) },
                )
                is DFunction -> {
                    val name = jvmNameProvider.nameFor(this)
                    copy(
                        dri = documentable.dri.withCallableName(name),
                        name = name
                    )
                }
                is DProperty -> transformGetterAndSetter(this)
                is DClasslike -> transformClassLike(this)
                is DEnumEntry -> copy(
                    functions = functions.map { transform(it) },
                    properties = properties.map { transform(it) },
                    classlikes = classlikes.map { transform(it) },
                )
                else -> {
                    context.logger.warn("Failed to translate a JvmName for ${this.javaClass.canonicalName}")
                    this
                }
            }
        } as T

    private fun transformClassLike(documentable: DClasslike): DClasslike =
        with(documentable) {
            when (this) {
                is DClass -> copy(
                    functions = functions.map { transform(it) },
                    properties = properties.map { transform(it) },
                    classlikes = classlikes.map { transform(it) },
                )
                is DAnnotation -> copy(
                    functions = functions.map { transform(it) },
                    properties = properties.map { transform(it) },
                    classlikes = classlikes.map { transform(it) },
                )
                is DObject -> copy(
                    functions = functions.map { transform(it) },
                    properties = properties.map { transform(it) },
                    classlikes = classlikes.map { transform(it) },
                )
                is DEnum -> copy(
                    functions = functions.map { transform(it) },
                    properties = properties.map { transform(it) },
                    classlikes = classlikes.map { transform(it) },
                )
                is DInterface -> copy(
                    functions = functions.map { transform(it) },
                    properties = properties.map { transform(it) },
                    classlikes = classlikes.map { transform(it) },
                )
            }
        }

    private fun transformGetterAndSetter(entry: DProperty): DProperty =
        with(entry) {
            copy(
                setter = jvmNameProvider.nameForSetter(this)?.let { setterName ->
                    setter?.let { setter ->
                        setter.copy(
                            dri = setter.dri.withCallableName(setterName),
                            name = setterName
                        )
                    }
                },
                getter = jvmNameProvider.nameForGetter(this)?.let { getterName ->
                    getter?.let { getter ->
                        getter.copy(
                            dri = getter.dri.withCallableName(getterName),
                            name = getterName
                        )
                    }
                })
        }
}