Merge pull request #315 from Kotlin/refactor-build

Refactor build, fix #306

- Use version catalogs
- Use typesafe project accessors
- Move common logic to the build plugin
- Expose configurable options as extensions
- Reduce the number of project options
- Use only lazy task configuration (register instead of create)
- Get rid of libraries submodule, load libraries on demand

Author: ileasile

.gitignore

@@ -14,11 +14,16 @@
 # Folders with build files
 out/
 /build/
-/*jupyter*/build/
+/build-plugin/**/.idea/
+/build-plugin/**/build/
+!/build-plugin/**/src/build/
 /*jupyter*/*/build/
 /api-examples/*/build/
 /teamcity-artifacts/
 
+# Folder with library descriptors
+libraries/
+
 # Gradle caches and internal files
 .gradle/
 

.gitmodules

@@ -9,19 +9,15 @@ kotlinJupyter {
     addScannerDependency()
 }
 
-project.version = rootProject.version
-
 dependencies {
-    implementation(kotlin("stdlib"))
-    implementation(kotlin("reflect"))
+    implementation(libs.kotlin.stable.stdlib)
+    implementation(libs.kotlin.stable.reflect)
 }
 
 kotlinPublications {
     publication {
-        publicationName = "example-getting-started"
-        artifactId = "kotlin-jupyter-example-getting-started"
-        description = "Basic API usage example"
-        packageName = artifactId
-        publishToSonatype = false
+        publicationName.set("example-getting-started")
+        description.set("Basic API usage example")
+        publishToSonatype.set(false)
     }
 }

api-examples/getting-started/build.gradle.kts

@@ -0,0 +1,41 @@
+import org.jetbrains.kotlin.gradle.tasks.KotlinCompile
+
+plugins {
+    id("build.plugins.versions")
+    `kotlin-dsl`
+}
+
+repositories {
+    mavenCentral()
+    gradlePluginPortal()
+}
+
+dependencies {
+    implementation(projects.commonDependencies)
+    api(libs.bundles.allGradlePlugins)
+}
+
+sourceSets {
+    main {
+        java.setSrcDirs(listOf("src"))
+    }
+    test {
+        allJava.setSrcDirs(emptyList<String>())
+        resources.setSrcDirs(emptyList<String>())
+    }
+}
+
+tasks.withType<KotlinCompile> {
+    kotlinOptions {
+        freeCompilerArgs = freeCompilerArgs + listOf("-Xopt-in=kotlin.RequiresOptIn")
+    }
+}
+
+gradlePlugin {
+    plugins {
+        create("dependencies") {
+            id = "build.plugins.main"
+            implementationClass = "build.KernelBuildPlugin"
+        }
+    }
+}

build-plugin/build.gradle.kts

@@ -0,0 +1,45 @@
+plugins {
+    id("ru.ileasile.kotlin.publisher")
+    kotlin("jvm")
+}
+
+repositories {
+    mavenCentral()
+}
+
+dependencies {
+    implementation(libs.kotlin.gradle.stdlib)
+
+    // HTTP4K for resolving remote library dependencies
+    api(libs.bundles.http4k)
+
+    // Serialization implementation for kernel code
+    api(libs.serialization.json)
+}
+
+sourceSets {
+    main {
+        java.setSrcDirs(listOf("src"))
+    }
+    test {
+        allJava.setSrcDirs(emptyList<String>())
+        resources.setSrcDirs(emptyList<String>())
+    }
+}
+
+tasks.withType<org.jetbrains.kotlin.gradle.tasks.KotlinCompile> {
+    kotlinOptions {
+        apiVersion = "1.4"
+        languageVersion = "1.4"
+
+        @Suppress("SuspiciousCollectionReassignment")
+        freeCompilerArgs += listOf("-Xopt-in=kotlin.RequiresOptIn")
+    }
+}
+
+kotlinPublications {
+    publication {
+        publicationName.set("common-dependencies")
+        description.set("Notebook API entities used for building kernel documentation")
+    }
+}