Introduce composite-build-logic sample

With two included builds for build logic:
- gradle/shared
- gradle/plugins

And a variety of dependencies including both the outer build and the
plugins included build using the shared included build

Signed-off-by: Paul Merlin <paul@gradle.com>

Author: eskatos

samples/composite-build-logic/README.md

@@ -0,0 +1,14 @@
+composite-build-logic
+=====================
+
+Demonstrates how to use [Composite Builds](https://docs.gradle.org/current/userguide/composite_builds.html)
+for build logic.
+
+The build in the [`build-logic`](./build-logic) directory publishes a Gradle Plugin.
+The build in this directory includes the `build-logic` build and uses the Gradle Plugin for its build logic.
+
+Run with:
+
+    ./gradlew sample
+
+See [settings.gradle.kts](./settings.gradle.kts) to see how to include builds and do dependency substitution.

samples/composite-build-logic/build.gradle.kts

@@ -0,0 +1,15 @@
+import shared.*
+
+plugins {
+    id("plugins.sample-plugin")
+}
+
+tasks {
+    sample {
+        message.set("Hello included build logic!")
+    }
+}
+
+dependencies {
+    implementation(DependencyVersions.javax.measure.ri.notation)
+}

samples/composite-build-logic/gradle/plugins/build.gradle.kts

@@ -0,0 +1,23 @@
+import shared.*
+
+plugins {
+    `kotlin-dsl`
+}
+
+buildscript {
+    dependencies {
+        classpath("composite-build-logic:shared:latest-integration")
+    }
+}
+
+group = "org.gradle.kotlin.dsl.samples.composite-build-logic"
+version = "1.0"
+
+repositories {
+    jcenter()
+}
+
+dependencies {
+    implementation(DependencyVersions.javax.measure.ri.notation)
+    implementation("composite-build-logic:shared:latest-integration")
+}

samples/composite-build-logic/gradle/plugins/settings.gradle.kts

@@ -0,0 +1,17 @@
+package plugins
+
+import org.gradle.api.*
+import org.gradle.api.tasks.*
+import org.gradle.kotlin.dsl.*
+
+
+open class SampleTask : DefaultTask() {
+
+    @Input
+    val message = project.objects.property<String>()
+
+    @TaskAction
+    fun sample() {
+        logger.lifecycle(message.get())
+    }
+}

samples/composite-build-logic/gradle/plugins/src/main/kotlin/plugins/SampleTask.kt

@@ -0,0 +1,19 @@
+package plugins
+
+import shared.*
+
+plugins {
+    `java-library`
+}
+
+dependencies {
+    "api"(DependencyVersions.javax.measure.api.notation)
+}
+
+repositories {
+    jcenter()
+}
+
+tasks.register<SampleTask>("sample") {
+    message.set("SampleTask executed!")
+}

samples/composite-build-logic/gradle/plugins/src/main/kotlin/plugins/sample-plugin.gradle.kts

@@ -0,0 +1,10 @@
+plugins {
+    `kotlin-dsl`
+}
+
+group = "org.gradle.kotlin.dsl.samples.composite-build-logic"
+version = "1.0"
+
+repositories {
+    jcenter()
+}

samples/composite-build-logic/gradle/shared/build.gradle.kts

@@ -0,0 +1,16 @@
+package shared
+
+object DependencyVersions {
+
+    object javax {
+        object measure {
+            val api = DependencyVersion("javax.measure", "unit-api", "1.0")
+            val ri = DependencyVersion("tec.units", "unit-ri", "1.0.3")
+        }
+    }
+}
+
+data class DependencyVersion(val group: String, val name: String, val version: String) {
+    val notation: String
+        get() = "$group:$name:$version"
+}