aboutsummaryrefslogtreecommitdiff
path: root/core/src/main/kotlin/plugability
diff options
context:
space:
mode:
authorAndrzej Ratajczak <andrzej.ratajczak98@gmail.com>2020-04-01 17:02:18 +0200
committerPaweł Marks <Kordyjan@users.noreply.github.com>2020-04-30 12:37:30 +0200
commit7f9d595f604e269fb918dc69cf2f80c19aef58c2 (patch)
tree132d84a71c3aae87894ecce9a618ca9df12f2dc7 /core/src/main/kotlin/plugability
parentbadb811e6de55c460301ae3f911f3d7c0dc9e39e (diff)
downloaddokka-7f9d595f604e269fb918dc69cf2f80c19aef58c2.tar.gz
dokka-7f9d595f604e269fb918dc69cf2f80c19aef58c2.tar.bz2
dokka-7f9d595f604e269fb918dc69cf2f80c19aef58c2.zip
Adds possibility to configure plugins
Diffstat (limited to 'core/src/main/kotlin/plugability')
-rw-r--r--core/src/main/kotlin/plugability/DokkaPlugin.kt26
1 files changed, 26 insertions, 0 deletions
diff --git a/core/src/main/kotlin/plugability/DokkaPlugin.kt b/core/src/main/kotlin/plugability/DokkaPlugin.kt
index d8fb7892..24f417d8 100644
--- a/core/src/main/kotlin/plugability/DokkaPlugin.kt
+++ b/core/src/main/kotlin/plugability/DokkaPlugin.kt
@@ -1,9 +1,12 @@
package org.jetbrains.dokka.plugability
+import com.google.gson.Gson
import org.jetbrains.dokka.DokkaConfiguration
+import org.jetbrains.kotlin.utils.addToStdlib.cast
import kotlin.properties.ReadOnlyProperty
import kotlin.reflect.KProperty
import kotlin.reflect.KProperty1
+import kotlin.reflect.full.createInstance
private typealias ExtensionDelegate<T> = ReadOnlyProperty<DokkaPlugin, Extension<T>>
@@ -49,6 +52,18 @@ abstract class DokkaPlugin {
}
}
+interface Configurable {
+ val pluginsConfiguration: Map<String, String>
+}
+
+interface ConfigurableBlock
+
+inline fun <reified P : DokkaPlugin, reified T : ConfigurableBlock> Configurable.pluginConfiguration(block: T.() -> Unit) {
+ val instance = T::class.createInstance().apply(block)
+ pluginsConfiguration.cast<MutableMap<String, String>>()[P::class.qualifiedName!!] =
+ Gson().toJson(instance, T::class.java)
+}
+
inline fun <reified P : DokkaPlugin, reified E : Any> P.query(extension: P.() -> ExtensionPoint<E>): List<E> =
context?.let { it[extension()] } ?: throwIllegalQuery()
@@ -57,3 +72,14 @@ inline fun <reified P : DokkaPlugin, reified E : Any> P.querySingle(extension: P
fun throwIllegalQuery(): Nothing =
throw IllegalStateException("Querying about plugins is only possible with dokka context initialised")
+
+inline fun <reified T : DokkaPlugin, reified R : ConfigurableBlock> configuration(context: DokkaContext): ReadOnlyProperty<Any?, R> {
+ return object : ReadOnlyProperty<Any?, R> {
+ override fun getValue(thisRef: Any?, property: KProperty<*>): R {
+ return context.configuration.pluginsConfiguration.get(T::class.qualifiedName
+ ?: throw AssertionError("Plugin must be named class")).let {
+ Gson().fromJson(it, R::class.java)
+ }
+ }
+ }
+} \ No newline at end of file