docs build: allow to specify custom dokka repository

ilya-g · ilya-g · commit 0389c3526299 · 2023-04-27T15:54:58.000+02:00
- centralize repository management in settings.gradle.kts
- allow to specify dokka repository with a gradle property
- automatically add mavenLocal for -local dokka versions
- specify kotlin version for building plugins in one place
diff --git a/libraries/tools/kotlin-stdlib-docs/build.gradle.kts b/libraries/tools/kotlin-stdlib-docs/build.gradle.kts
@@ -50,11 +50,6 @@ val prepare by tasks.registering {
     dependsOn(":kotlin_big:extractLibs")
 }
 
-repositories {
-    mavenCentral()
-    maven(url = "https://maven.pkg.jetbrains.space/kotlin/p/dokka/dev")
-}
-
 dependencies {
     dokkaPlugin(project(":plugins:dokka-samples-transformer-plugin"))
     dokkaPlugin(project(":plugins:dokka-stdlib-configuration-plugin"))
diff --git a/libraries/tools/kotlin-stdlib-docs/plugins/build.gradle.kts b/libraries/tools/kotlin-stdlib-docs/plugins/build.gradle.kts
@@ -0,0 +1,3 @@
+plugins {
+    id("org.jetbrains.kotlin.jvm") version "1.8.0" apply false
+}
diff --git a/libraries/tools/kotlin-stdlib-docs/plugins/dokka-samples-transformer-plugin/build.gradle b/libraries/tools/kotlin-stdlib-docs/plugins/dokka-samples-transformer-plugin/build.gradle
@@ -1,25 +1,17 @@
 plugins {
-    id 'org.jetbrains.kotlin.jvm' version '1.8.0'
+    id 'org.jetbrains.kotlin.jvm'
 }
 description "Dokka Plugin to transform the samples from stdlib"
 
-repositories {
-    mavenCentral()
-    maven {
-        url 'https://maven.pkg.jetbrains.space/kotlin/p/dokka/dev'
-    }
-    mavenLocal()
-}
-
-final String dokka_version = findProperty("dokka_version")
+final String dokka_version = property("dokka_version")
 
 dependencies {
     implementation "org.jetbrains.dokka:dokka-base:$dokka_version"
     compileOnly "org.jetbrains.dokka:dokka-core:$dokka_version"
     compileOnly "org.jetbrains.dokka:dokka-analysis:$dokka_version"
 }
 
-tasks.withType(org.jetbrains.kotlin.gradle.tasks.KotlinCompile) {
-    kotlinOptions.jvmTarget = "1.8"
+kotlin {
+    jvmToolchain(8)
 }
 
diff --git a/libraries/tools/kotlin-stdlib-docs/plugins/dokka-stdlib-configuration-plugin/build.gradle b/libraries/tools/kotlin-stdlib-docs/plugins/dokka-stdlib-configuration-plugin/build.gradle
@@ -1,25 +1,17 @@
 plugins {
-    id 'org.jetbrains.kotlin.jvm' version '1.8.0'
+    id 'org.jetbrains.kotlin.jvm'
 }
 description "Dokka Plugin to configure Dokka for stdlib"
 
-repositories {
-    mavenCentral()
-    maven {
-        url 'https://maven.pkg.jetbrains.space/kotlin/p/dokka/dev'
-    }
-    mavenLocal()
-}
-
-final String dokka_version = findProperty("dokka_version")
+final String dokka_version = property("dokka_version")
 
 dependencies {
     implementation "org.jetbrains.dokka:dokka-base:$dokka_version"
     compileOnly "org.jetbrains.dokka:dokka-core:$dokka_version"
     compileOnly "org.jetbrains.dokka:dokka-analysis:$dokka_version"
 }
 
-tasks.withType(org.jetbrains.kotlin.gradle.tasks.KotlinCompile) {
-    kotlinOptions.jvmTarget = "1.8"
+kotlin {
+    jvmToolchain(8)
 }
 
diff --git a/libraries/tools/kotlin-stdlib-docs/plugins/dokka-version-filter-plugin/build.gradle b/libraries/tools/kotlin-stdlib-docs/plugins/dokka-version-filter-plugin/build.gradle
@@ -1,26 +1,18 @@
 plugins {
-    id 'org.jetbrains.kotlin.jvm' version '1.8.0'
+    id 'org.jetbrains.kotlin.jvm'
 }
 description "Dokka Plugin to filter version for stdlib"
 
-repositories {
-    mavenCentral()
-    maven {
-        url 'https://maven.pkg.jetbrains.space/kotlin/p/dokka/dev'
-    }
-    mavenLocal()
-}
-
-final String dokka_version = findProperty("dokka_version")
+final String dokka_version = property("dokka_version")
 
 dependencies {
     implementation "org.jetbrains.dokka:dokka-base:$dokka_version"
     compileOnly "org.jetbrains.dokka:dokka-core:$dokka_version"
     compileOnly "org.jetbrains.dokka:dokka-analysis:$dokka_version"
     testImplementation 'org.jetbrains.kotlin:kotlin-test'}
 
-tasks.withType(org.jetbrains.kotlin.gradle.tasks.KotlinCompile) {
-    kotlinOptions.jvmTarget = "1.8"
+kotlin {
+    jvmToolchain(8)
 }
 test {
     useJUnitPlatform()
diff --git a/libraries/tools/kotlin-stdlib-docs/settings.gradle b/libraries/tools/kotlin-stdlib-docs/settings.gradle
diff --git a/libraries/tools/kotlin-stdlib-docs/settings.gradle.kts b/libraries/tools/kotlin-stdlib-docs/settings.gradle.kts
@@ -0,0 +1,35 @@
+pluginManagement {
+    val dokkaVersion = providers.gradleProperty("dokka_version").get()
+    val dokkaRepository = providers.gradleProperty("dokka_repository").getOrElse("https://maven.pkg.jetbrains.space/kotlin/p/dokka/dev")
+    plugins {
+        id("org.jetbrains.dokka") version(dokkaVersion)
+    }
+
+    repositories {
+        gradlePluginPortal()
+        maven(url = dokkaRepository)
+        if ("-local" in dokkaVersion) {
+            mavenLocal()
+        }
+    }
+}
+dependencyResolutionManagement {
+    repositoriesMode.set(RepositoriesMode.PREFER_PROJECT)
+    val dokkaVersion = providers.gradleProperty("dokka_version").get()
+    val dokkaRepository = providers.gradleProperty("dokka_repository").getOrElse("https://maven.pkg.jetbrains.space/kotlin/p/dokka/dev")
+    repositories {
+        mavenCentral()
+        maven(url = dokkaRepository)
+        if ("-local" in dokkaVersion) {
+            mavenLocal()
+        }
+    }
+}
+
+rootProject.name = "kotlin-stdlib-docs"
+
+include("kotlin_big")
+include("plugins")
+include("plugins:dokka-samples-transformer-plugin")
+include("plugins:dokka-stdlib-configuration-plugin")
+include("plugins:dokka-version-filter-plugin")

Original file line number	Diff line number	Diff line change
`@@ -0,0 +1,3 @@`
	`1`	`+plugins {`
	`2`	`+ id("org.jetbrains.kotlin.jvm") version "1.8.0" apply false`
	`3`	`+}`