diff options
Diffstat (limited to 'plugins')
3 files changed, 109 insertions, 0 deletions
diff --git a/plugins/javadoc/src/main/kotlin/org/jetbrains/dokka/javadoc/JavadocPlugin.kt b/plugins/javadoc/src/main/kotlin/org/jetbrains/dokka/javadoc/JavadocPlugin.kt index ae3281a1..560083e4 100644 --- a/plugins/javadoc/src/main/kotlin/org/jetbrains/dokka/javadoc/JavadocPlugin.kt +++ b/plugins/javadoc/src/main/kotlin/org/jetbrains/dokka/javadoc/JavadocPlugin.kt @@ -10,6 +10,7 @@ import org.jetbrains.dokka.base.renderers.RootCreator import org.jetbrains.dokka.base.resolvers.shared.RecognizedLinkFormat import org.jetbrains.dokka.javadoc.pages.* import org.jetbrains.dokka.javadoc.transformers.documentables.JavadocDocumentableJVMSourceSetFilter +import org.jetbrains.dokka.javadoc.validity.MultiplatformConfiguredChecker import org.jetbrains.dokka.kotlinAsJava.KotlinAsJavaPlugin import org.jetbrains.dokka.plugability.DokkaPlugin import org.jetbrains.dokka.plugability.querySingle @@ -28,6 +29,12 @@ class JavadocPlugin : DokkaPlugin() { override dokkaBasePlugin.htmlRenderer) } + val javadocMultiplatformCheck by extending { + CoreExtensions.preGenerationCheck providing { context -> + MultiplatformConfiguredChecker(context) + } + } + val pageTranslator by extending { CoreExtensions.documentableToPageTranslator providing { context -> JavadocDocumentableToPageTranslator( diff --git a/plugins/javadoc/src/main/kotlin/org/jetbrains/dokka/javadoc/validity/MultiplatformConfiguredChecker.kt b/plugins/javadoc/src/main/kotlin/org/jetbrains/dokka/javadoc/validity/MultiplatformConfiguredChecker.kt new file mode 100644 index 00000000..36d84a09 --- /dev/null +++ b/plugins/javadoc/src/main/kotlin/org/jetbrains/dokka/javadoc/validity/MultiplatformConfiguredChecker.kt @@ -0,0 +1,22 @@ +package org.jetbrains.dokka.javadoc.validity + +import org.jetbrains.dokka.Platform +import org.jetbrains.dokka.plugability.DokkaContext +import org.jetbrains.dokka.validity.PreGenerationChecker +import org.jetbrains.dokka.validity.PreGenerationCheckerOutput + +class MultiplatformConfiguredChecker(val context: DokkaContext) : PreGenerationChecker { + + override fun invoke(): PreGenerationCheckerOutput { + val isSinglePlatform = context.configuration.sourceSets.all { sourceSet -> + val platform = sourceSet.analysisPlatform + (platform == Platform.jvm || platform == Platform.common) + } + return PreGenerationCheckerOutput(isSinglePlatform, listOfNotNull(errorMessage.takeUnless { isSinglePlatform })) + } + + companion object { + const val errorMessage = + "Dokka Javadoc plugin currently does not support generating documentation for multiplatform project. Please, adjust your configuration" + } +}
\ No newline at end of file diff --git a/plugins/javadoc/src/test/kotlin/org/jetbrains/dokka/javadoc/validity/MultiplatformConfiguredCheckerTest.kt b/plugins/javadoc/src/test/kotlin/org/jetbrains/dokka/javadoc/validity/MultiplatformConfiguredCheckerTest.kt new file mode 100644 index 00000000..9d70f444 --- /dev/null +++ b/plugins/javadoc/src/test/kotlin/org/jetbrains/dokka/javadoc/validity/MultiplatformConfiguredCheckerTest.kt @@ -0,0 +1,80 @@ +package org.jetbrains.dokka.javadoc.validity + +import org.jetbrains.dokka.DokkaConfigurationImpl +import org.jetbrains.dokka.DokkaException +import org.jetbrains.dokka.ExternalDocumentationLink +import org.jetbrains.dokka.testApi.testRunner.AbstractCoreTest +import org.junit.jupiter.api.Test +import kotlin.test.assertFalse +import kotlin.test.assertTrue + +class MultiplatformConfiguredCheckerTest : AbstractCoreTest() { + + val mppConfig: DokkaConfigurationImpl = dokkaConfiguration { + format = "javadoc" + sourceSets { + sourceSet { + sourceRoots = listOf("src") + analysisPlatform = "jvm" + externalDocumentationLinks = listOf( + ExternalDocumentationLink("https://docs.oracle.com/javase/8/docs/api/"), + ExternalDocumentationLink("https://kotlinlang.org/api/latest/jvm/stdlib/") + ) + } + sourceSet { + sourceRoots = listOf("src") + analysisPlatform = "js" + externalDocumentationLinks = listOf( + ExternalDocumentationLink("https://docs.oracle.com/javase/8/docs/api/"), + ExternalDocumentationLink("https://kotlinlang.org/api/latest/jvm/stdlib/") + ) + } + } + } + + val sppConfig: DokkaConfigurationImpl = dokkaConfiguration { + format = "javadoc" + sourceSets { + sourceSet { + sourceRoots = listOf("src") + analysisPlatform = "jvm" + externalDocumentationLinks = listOf( + ExternalDocumentationLink("https://docs.oracle.com/javase/8/docs/api/"), + ExternalDocumentationLink("https://kotlinlang.org/api/latest/jvm/stdlib/") + ) + } + } + } + + @Test + fun `mpp config should fail for javadoc`() { + testInline("", mppConfig) { + verificationStage = { verification -> + var mppDetected = false + try { + verification() + } catch (e: DokkaException) { + mppDetected = + e.localizedMessage == "Pre-generation validity check failed: ${MultiplatformConfiguredChecker.errorMessage}" + } + assertTrue(mppDetected, "MPP configuration not detected") + } + } + } + + @Test + fun `spp config should not fail for javadoc`() { + testInline("", sppConfig) { + verificationStage = { verification -> + var mppDetected = false + try { + verification() + } catch (e: DokkaException) { + mppDetected = + e.localizedMessage == "Pre-generation validity check failed: ${MultiplatformConfiguredChecker.errorMessage}" + } + assertFalse(mppDetected, "SPP taken as multiplatform") + } + } + } +}
\ No newline at end of file |