From 70185af2334b1e4c1bb31b422d807bf6bc8708e9 Mon Sep 17 00:00:00 2001 From: aSemy <897017+aSemy@users.noreply.github.com> Date: Sun, 17 Jul 2022 12:57:16 +0200 Subject: [PATCH] Continuous development (#20) * add vararg stream for StreamsBuilder * fix stream-table join so it's not recursive, and the lambda param is last * use expression bodies * new `stream.to()` extension - for better generic support * add test for StreamsBuilder.stream(...) * use gradle task config avoidance configureEach * fix kotlinx ser version in buildSrc * try implementing Maven Central publishing... (signing still doesn't work) * try implementing Maven Central publishing... (signing still doesn't work) * split up StreamsBuilder.stream() so vararg works a bit better * bump to Kotlin 1.7, add java-platform subproject * - improve KStream.to() - fixes after Kotlin 1.7 update * try to fix jitpack * only sign javadoc jar if publishing to sonatype * kotest bump, Gradle bump, and a bit of build config tweaking * bump Gradle & Kotlin * rm sonatype snapshots from maven repos * rm commented out buildSrc config * disable signing plugin --- build.gradle.kts | 6 +- buildSrc/build.gradle.kts | 12 +- buildSrc/repositories.settings.gradle.kts | 1 + buildSrc/settings.gradle.kts | 2 + .../kotka/convention/kotlin-jvm.gradle.kts | 20 +-- .../kotka/convention/maven-publish.gradle.kts | 130 +++++++++++++++--- buildSrc/src/main/kotlin/kotka/ext/gradle.kt | 20 +++ .../src/main/kotlin/kotka/ext/publishing.kt | 55 ++++++++ gradle/libs.versions.toml | 90 ++++++++++-- gradle/wrapper/gradle-wrapper.jar | Bin 59821 -> 60756 bytes gradle/wrapper/gradle-wrapper.properties | 2 +- gradlew | 6 + gradlew.bat | 14 +- jitpack.yml | 2 +- .../kotka-streams-extensions/build.gradle.kts | 2 + .../kotka/extensions/streams/KStream.kt | 48 ++++--- .../extensions/streams/topicNameExtractor.kt | 19 +++ .../adamko/kotka/extensions/streamsBuilder.kt | 19 +++ .../kotka/extensions/StreamsBuilderTests.kt | 90 ++++++++++++ .../kotka-streams-framework/build.gradle.kts | 2 + .../build.gradle.kts | 9 +- modules/versions-platform/build.gradle.kts | 25 ++++ settings.gradle.kts | 1 + 23 files changed, 491 insertions(+), 84 deletions(-) create mode 100644 buildSrc/src/main/kotlin/kotka/ext/gradle.kt create mode 100644 buildSrc/src/main/kotlin/kotka/ext/publishing.kt create mode 100644 modules/kotka-streams-extensions/src/main/kotlin/dev/adamko/kotka/extensions/streams/topicNameExtractor.kt create mode 100644 modules/kotka-streams-extensions/src/main/kotlin/dev/adamko/kotka/extensions/streamsBuilder.kt create mode 100644 modules/kotka-streams-extensions/src/test/kotlin/dev/adamko/kotka/extensions/StreamsBuilderTests.kt create mode 100644 modules/versions-platform/build.gradle.kts diff --git a/build.gradle.kts b/build.gradle.kts index 13501c7..398d7e8 100644 --- a/build.gradle.kts +++ b/build.gradle.kts @@ -2,7 +2,7 @@ plugins { kotka.convention.`kotlin-jvm` kotka.convention.`maven-publish` - id("me.qoomon.git-versioning") + me.qoomon.`git-versioning` `project-report` `build-dashboard` @@ -21,12 +21,14 @@ gitVersioning.apply { } dependencies { + implementation(platform(projects.modules.versionsPlatform)) + api(projects.modules.kotkaStreamsExtensions) api(projects.modules.kotkaStreamsFramework) api(projects.modules.kotkaStreamsKotlinxSerialization) } tasks.wrapper { - gradleVersion = "7.4.2" + gradleVersion = "7.5" distributionType = Wrapper.DistributionType.ALL } diff --git a/buildSrc/build.gradle.kts b/buildSrc/build.gradle.kts index 578d031..462511f 100644 --- a/buildSrc/build.gradle.kts +++ b/buildSrc/build.gradle.kts @@ -7,17 +7,13 @@ plugins { dependencies { - val kotlinVersion = libs.versions.kotlin.get() - implementation(enforcedPlatform("org.jetbrains.kotlin:kotlin-bom:$kotlinVersion")) + implementation(enforcedPlatform(libs.kotlin.bom)) implementation("org.jetbrains.kotlin:kotlin-serialization") implementation("org.jetbrains.kotlin:kotlin-reflect") - implementation("org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlinVersion") - val kotlinXSerializationVersion = "1.3.2" - implementation(enforcedPlatform("org.jetbrains.kotlinx:kotlinx-serialization-bom:$kotlinXSerializationVersion")) + implementation(libs.kotlin.gradlePlugin) - val gitVersioningPluginVersion = "5.2.0" - implementation("me.qoomon:gradle-git-versioning-plugin:$gitVersioningPluginVersion") + implementation(libs.gitVersioningPlugin) } val gradleJvmTarget = "1.8" @@ -36,8 +32,6 @@ tasks.withType().configureEach { "-opt-in=kotlin.RequiresOptIn", "-opt-in=kotlin.ExperimentalStdlibApi", "-opt-in=kotlin.time.ExperimentalTime", -// "-opt-in=kotlinx.coroutines.ExperimentalCoroutinesApi", -// "-opt-in=kotlinx.serialization.ExperimentalSerializationApi", ) } diff --git a/buildSrc/repositories.settings.gradle.kts b/buildSrc/repositories.settings.gradle.kts index 81a6114..2591a58 100644 --- a/buildSrc/repositories.settings.gradle.kts +++ b/buildSrc/repositories.settings.gradle.kts @@ -17,6 +17,7 @@ dependencyResolutionManagement { } + fun RepositoryHandler.jitpack() { maven("https://jitpack.io") } diff --git a/buildSrc/settings.gradle.kts b/buildSrc/settings.gradle.kts index eb552c7..be9ce4f 100644 --- a/buildSrc/settings.gradle.kts +++ b/buildSrc/settings.gradle.kts @@ -1,3 +1,5 @@ +rootProject.name = "buildSrc" + apply(from = "./repositories.settings.gradle.kts") dependencyResolutionManagement { diff --git a/buildSrc/src/main/kotlin/kotka/convention/kotlin-jvm.gradle.kts b/buildSrc/src/main/kotlin/kotka/convention/kotlin-jvm.gradle.kts index c120bef..f551536 100644 --- a/buildSrc/src/main/kotlin/kotka/convention/kotlin-jvm.gradle.kts +++ b/buildSrc/src/main/kotlin/kotka/convention/kotlin-jvm.gradle.kts @@ -7,38 +7,35 @@ plugins { kotlin("jvm") `java-library` } -dependencies { - implementation(platform("org.jetbrains.kotlin:kotlin-bom")) - val junitVersion = "5.8.2" - testImplementation(platform("org.junit:junit-bom:$junitVersion")) +dependencies { testImplementation("org.junit.jupiter:junit-jupiter") testRuntimeOnly("org.junit.platform:junit-platform-launcher") { because("Only needed to run tests in a version of IntelliJ IDEA that bundles older versions") } - val kotestVersion = "5.2.3" - testImplementation(platform("io.kotest:kotest-bom:$kotestVersion")) testImplementation("io.kotest:kotest-runner-junit5") testImplementation("io.kotest:kotest-assertions-core") testImplementation("io.kotest:kotest-property") testImplementation("io.kotest:kotest-assertions-json") - testImplementation("io.mockk:mockk:1.12.3") - + testImplementation("io.mockk:mockk") } + val projectJvmTarget = "1.8" val projectJvmVersion = "8" val projectKotlinTarget = "1.6" + kotlin { jvmToolchain { - (this as JavaToolchainSpec).languageVersion.set(JavaLanguageVersion.of(projectJvmVersion)) + languageVersion.set(JavaLanguageVersion.of(projectJvmVersion)) } } + tasks.withType().configureEach { kotlinOptions { @@ -56,14 +53,17 @@ tasks.withType().configureEach { ) } + tasks.compileTestKotlin { kotlinOptions.freeCompilerArgs += "-opt-in=io.kotest.common.ExperimentalKotest" } -tasks.withType { + +tasks.withType().configureEach { useJUnitPlatform() } + java { withJavadocJar() withSourcesJar() diff --git a/buildSrc/src/main/kotlin/kotka/convention/maven-publish.gradle.kts b/buildSrc/src/main/kotlin/kotka/convention/maven-publish.gradle.kts index 6e75f34..0eadd00 100644 --- a/buildSrc/src/main/kotlin/kotka/convention/maven-publish.gradle.kts +++ b/buildSrc/src/main/kotlin/kotka/convention/maven-publish.gradle.kts @@ -1,30 +1,122 @@ package kotka.convention +import kotka.ext.createKotkaStreamsPom +import kotka.ext.credentialsAction +import kotka.ext.publishing +import kotka.ext.signing + + plugins { `maven-publish` +// signing } -plugins.withType(JavaPlugin::class.java) { - publishing { - publications { - create("mavenJava") { - from(components["java"]) - } - } - repositories { - maven { - name = "GitHubPackages" - url = uri("https://maven.pkg.github.com/adamko-dev/kotka-streams") - credentials(PasswordCredentials::class) - } - } + +val sonatypeRepositoryCredentials: Provider> = + providers.credentialsAction("sonatypeRepository") + +val gitHubPackagesCredentials: Provider> = + providers.credentialsAction("GitHubPackages") + + +val sonatypeRepositoryReleaseUrl: Provider = provider { + if (version.toString().endsWith("SNAPSHOT")) { + "https://s01.oss.sonatype.org/content/repositories/snapshots/" + } else { + "https://s01.oss.sonatype.org/service/local/staging/deploy/maven2/" + } +} + + +val signingKeyId: Provider = + providers.gradleProperty("signing.keyId") +val signingKey: Provider = + providers.gradleProperty("signing.key") +val signingPassword: Provider = + providers.gradleProperty("signing.password") +val signingSecretKeyRingFile: Provider = + providers.gradleProperty("signing.secretKeyRingFile") + + +tasks.withType().configureEach { + // Gradle warns about some signing tasks using publishing task outputs without explicit + // dependencies. I'm not going to go through them all and fix them, so here's a quick fix. + dependsOn(tasks.withType()) + + doLast { + logger.lifecycle("[${this.name}] ${project.group}:${project.name}:${project.version}") } } -tasks - .matching { it.name in listOf("publish", "publishToMavenLocal") } - .configureEach { - doLast { - logger.lifecycle("[${this.name}] ${project.group}:${project.name}:${project.version}") + +//signing { +// if (sonatypeRepositoryCredentials.isPresent) { +// if (signingKeyId.isPresent && signingKey.isPresent && signingPassword.isPresent) { +// useInMemoryPgpKeys(signingKeyId.get(), signingKey.get(), signingPassword.get()) +// } else { +// useGpgCmd() +// } +// +// // sign all publications +// sign(publishing.publications) +// } +//} + + +publishing { + repositories { + // publish to local dir, for testing + maven(rootProject.layout.buildDirectory.dir("maven-internal")) { + name = "maven-internal" } + +// if (sonatypeRepositoryCredentials.isPresent) { +// maven(sonatypeRepositoryReleaseUrl) { +// name = "sonatype" +// credentials(sonatypeRepositoryCredentials.get()) +// } +// } +// +// if (gitHubPackagesCredentials.isPresent) { +// maven("https://maven.pkg.github.com/adamko-dev/kotka-streams") { +// name = "GitHubPackages" +// credentials(gitHubPackagesCredentials.get()) +// } +// } + } + + publications.withType().configureEach { + createKotkaStreamsPom() + } +} + + +plugins.withType().configureEach { + publishing.publications.create("mavenJava") { + from(components["java"]) +// artifact(tasks["sourcesJar"]) + } +} + + +plugins.withType().configureEach { + + val javadocJarStub by tasks.registering(Jar::class) { + group = JavaBasePlugin.DOCUMENTATION_GROUP + description = "Stub javadoc.jar artifact (required by Maven Central)" + archiveClassifier.set("javadoc") + } + + tasks.withType().configureEach { + dependsOn(javadocJarStub) } + +// if (sonatypeRepositoryCredentials.isPresent) { +// signing.sign(javadocJarStub.get()) +// } + + publishing.publications.create("mavenJavaPlatform") { + from(components["javaPlatform"]) + artifact(javadocJarStub) + } +} diff --git a/buildSrc/src/main/kotlin/kotka/ext/gradle.kt b/buildSrc/src/main/kotlin/kotka/ext/gradle.kt new file mode 100644 index 0000000..67ff09d --- /dev/null +++ b/buildSrc/src/main/kotlin/kotka/ext/gradle.kt @@ -0,0 +1,20 @@ +package kotka.ext + +import org.gradle.api.Action +import org.gradle.api.artifacts.repositories.PasswordCredentials +import org.gradle.api.provider.Provider +import org.gradle.api.provider.ProviderFactory + + +// https://github.com/gradle/gradle/issues/20925 +fun ProviderFactory.credentialsAction( + repositoryName: String +): Provider> = zip( + gradleProperty("${repositoryName}Username"), + gradleProperty("${repositoryName}Password"), +) { user, pass -> + Action { + username = user + password = pass + } +} diff --git a/buildSrc/src/main/kotlin/kotka/ext/publishing.kt b/buildSrc/src/main/kotlin/kotka/ext/publishing.kt new file mode 100644 index 0000000..46310b9 --- /dev/null +++ b/buildSrc/src/main/kotlin/kotka/ext/publishing.kt @@ -0,0 +1,55 @@ +package kotka.ext + +import org.gradle.api.Project +import org.gradle.api.publish.PublishingExtension +import org.gradle.api.publish.maven.MavenPublication +import org.gradle.kotlin.dsl.configure +import org.gradle.kotlin.dsl.getByType +import org.gradle.plugins.signing.SigningExtension + + +fun MavenPublication.createKotkaStreamsPom(): Unit = pom { + name.set("Kotka Streams - Kotlin for Kafka Streams") + description.set("Using Kotka means a more pleasant experience while using Kafka Streams") + url.set("https://github.com/adamko-dev/kotka-streams") + + licenses { + license { + name.set("The Apache License, Version 2.0") + url.set("https://www.apache.org/licenses/LICENSE-2.0.txt") + } + } + + developers { + developer { + email.set("adam@adamko.dev") + } + } + + scm { + connection.set("scm:git:git://github.com/adamko-dev/kotka-streams.git") + developerConnection.set("scm:git:ssh://github.com:adamko-dev/kotka-streams.git") + url.set("https://github.com/adamko-dev/kotka-streams") + } +} + + +// hacks because IntelliJ still doesn't properly load DSL accessors for buildSrc + + +/** Configure [PublishingExtension] */ +fun Project.publishing(configure: PublishingExtension.() -> Unit): Unit = + extensions.configure(configure) + + +val Project.publishing: PublishingExtension + get() = extensions.getByType() + + +/** Configure [SigningExtension] */ +fun Project.signing(configure: SigningExtension.() -> Unit): Unit = + extensions.configure(configure) + + +val Project.signing: SigningExtension + get() = extensions.getByType() diff --git a/gradle/libs.versions.toml b/gradle/libs.versions.toml index a431153..b9ad944 100644 --- a/gradle/libs.versions.toml +++ b/gradle/libs.versions.toml @@ -1,13 +1,27 @@ -# @formatter:off - [versions] -kotlin = "1.6.21" -jvm = "11" +## Compilation + +kotlin = "1.7.10" # https://github.com/JetBrains/kotlin/releases +jvm = "11" + +## Libs + +kafka = "3.2.0" # https://kafka.apache.org/downloads +kotlinx-serialization = "1.3.3" # https://github.com/Kotlin/kotlinx.serialization/releases/tag/v1.3.3 +kotlinx-knit = "0.5.1" # https://github.com/Kotlin/kotlinx-knit/releases + +## Test libs + +kotest = "5.3.1" # https://github.com/kotest/kotest/releases -kafka = "3.2.0" +mockk = "1.12.4" # https://search.maven.org/artifact/io.mockk/mockk +junit = "5.8.2" # https://github.com/junit-team/junit5/releases + +## Plugins +gitVersioningPlugin = "6.1.4" # https://github.com/qoomon/gradle-git-versioning-plugin/releases +binaryCompatValidator = "0.10.0" # https://search.maven.org/artifact/org.jetbrains.kotlinx/binary-compatibility-validator -kotlinx-serialization = "1.3.3" ########### [libraries] @@ -17,9 +31,61 @@ kotlin-bom = { group = "org.jetbrains.kotlin", name = "kotlin-bom", version.ref kafka-streams = { group = "org.apache.kafka", name = "kafka-streams", version.ref = "kafka" } -kotlinx-serialization-bom = { group = "org.jetbrains.kotlinx", name = "kotlinx-serialization-bom", version.ref = "kotlinx-serialization" } -kotlinx-serialization-core = { group = "org.jetbrains.kotlinx", name = "kotlinx-serialization-core" } -kotlinx-serialization-json = { group = "org.jetbrains.kotlinx", name = "kotlinx-serialization-json" } -kotlinx-serialization-protobuf = { group = "org.jetbrains.kotlinx", name = "kotlinx-serialization-protobuf" } -kotlinx-serialization-cbor = { group = "org.jetbrains.kotlinx", name = "kotlinx-serialization-cbor" } -kotlinx-serialization-properties = { group = "org.jetbrains.kotlinx", name = "kotlinx-serialization-properties" } +kotlinxSerialization-bom = { group = "org.jetbrains.kotlinx", name = "kotlinx-serialization-bom", version.ref = "kotlinx-serialization" } +kotlinxSerialization-core = { group = "org.jetbrains.kotlinx", name = "kotlinx-serialization-core" } +kotlinxSerialization-json = { group = "org.jetbrains.kotlinx", name = "kotlinx-serialization-json" } +kotlinxSerialization-protobuf = { group = "org.jetbrains.kotlinx", name = "kotlinx-serialization-protobuf" } +kotlinxSerialization-cbor = { group = "org.jetbrains.kotlinx", name = "kotlinx-serialization-cbor" } +kotlinxSerialization-properties = { group = "org.jetbrains.kotlinx", name = "kotlinx-serialization-properties" } + +### Test libs ## + +# Kotest +kotest-bom = { group = "io.kotest", name = "kotest-bom", version.ref = "kotest" } +kotest-assertionsCore = { group = "io.kotest", name = "kotest-assertions-core" } +kotest-assertionsJson = { group = "io.kotest", name = "kotest-assertions-json" } +kotest-property = { group = "io.kotest", name = "kotest-property" } +kotest-frameworkEngine = { group = "io.kotest", name = "kotest-framework-engine" } +kotest-frameworkDatatest = { group = "io.kotest", name = "kotest-framework-datatest" } +kotest-runnerJUnit5 = { group = "io.kotest", name = "kotest-runner-junit5" } + + +# Knit +kotlinx-knit = { group = "org.jetbrains.kotlinx", name = "kotlinx-knit", version.ref = "kotlinx-knit" } +kotlinx-knitTest = { group = "org.jetbrains.kotlinx", name = "kotlinx-knit-test", version.ref = "kotlinx-knit" } + + +# JUnit +junit-bom = { group = "org.junit", name = "junit-bom", version.ref = "junit" } + +# Mockk +mockk = { group = "io.mockk", name = "mockk", version.ref = "mockk" } + +### Gradle Plugins ### + +gitVersioningPlugin = { group = "me.qoomon", name = "gradle-git-versioning-plugin", version.ref = "gitVersioningPlugin" } +kotlin-gradlePlugin = { group = "org.jetbrains.kotlin", name = "kotlin-gradle-plugin", version.ref = "kotlin" } +kotlinx-knitGradlePlugin = { group = "org.jetbrains.kotlinx", name = "kotlinx-knit", version.ref = "kotlinx-knit" } +kotlinx-binaryCompatValidator = { group = "org.jetbrains.kotlinx", name = "binary-compatibility-validator", version.ref = "kotlin" } + + +kotest-gradlePlugin = { group = "io.kotest", name = "kotest-framework-multiplatform-plugin-gradle", version.ref = "kotest" } + + +######### +[plugins] +######### + + +######### +[bundles] +######### + +kotest = [ + "kotest-assertionsCore", + "kotest-assertionsJson", + "kotest-property", + "kotest-frameworkEngine", + "kotest-frameworkDatatest", + "kotest-runnerJUnit5", +] diff --git a/gradle/wrapper/gradle-wrapper.jar b/gradle/wrapper/gradle-wrapper.jar index 41d9927a4d4fb3f96a785543079b8df6723c946b..249e5832f090a2944b7473328c07c9755baa3196 100644 GIT binary patch delta 10197 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 diff --git a/gradle/wrapper/gradle-wrapper.properties b/gradle/wrapper/gradle-wrapper.properties index 92f06b5..2ec77e5 100644 --- a/gradle/wrapper/gradle-wrapper.properties +++ b/gradle/wrapper/gradle-wrapper.properties @@ -1,5 +1,5 @@ distributionBase=GRADLE_USER_HOME distributionPath=wrapper/dists -distributionUrl=https\://services.gradle.org/distributions/gradle-7.4.2-all.zip +distributionUrl=https\://services.gradle.org/distributions/gradle-7.5-all.zip zipStoreBase=GRADLE_USER_HOME zipStorePath=wrapper/dists diff --git a/gradlew b/gradlew index 1b6c787..a69d9cb 100644 --- a/gradlew +++ b/gradlew @@ -205,6 +205,12 @@ set -- \ org.gradle.wrapper.GradleWrapperMain \ "$@" +# Stop when "xargs" is not available. +if ! command -v xargs >/dev/null 2>&1 +then + die "xargs is not available" +fi + # Use "xargs" to parse quoted args. # # With -n1 it outputs one arg per line, with the quotes and backslashes removed. diff --git a/gradlew.bat b/gradlew.bat index 107acd3..f127cfd 100644 --- a/gradlew.bat +++ b/gradlew.bat @@ -14,7 +14,7 @@ @rem limitations under the License. @rem -@if "%DEBUG%" == "" @echo off +@if "%DEBUG%"=="" @echo off @rem ########################################################################## @rem @rem Gradle startup script for Windows @@ -25,7 +25,7 @@ if "%OS%"=="Windows_NT" setlocal set DIRNAME=%~dp0 -if "%DIRNAME%" == "" set DIRNAME=. +if "%DIRNAME%"=="" set DIRNAME=. set APP_BASE_NAME=%~n0 set APP_HOME=%DIRNAME% @@ -40,7 +40,7 @@ if defined JAVA_HOME goto findJavaFromJavaHome set JAVA_EXE=java.exe %JAVA_EXE% -version >NUL 2>&1 -if "%ERRORLEVEL%" == "0" goto execute +if %ERRORLEVEL% equ 0 goto execute echo. echo ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH. @@ -75,13 +75,15 @@ set CLASSPATH=%APP_HOME%\gradle\wrapper\gradle-wrapper.jar :end @rem End local scope for the variables with windows NT shell -if "%ERRORLEVEL%"=="0" goto mainEnd +if %ERRORLEVEL% equ 0 goto mainEnd :fail rem Set variable GRADLE_EXIT_CONSOLE if you need the _script_ return code instead of rem the _cmd.exe /c_ return code! -if not "" == "%GRADLE_EXIT_CONSOLE%" exit 1 -exit /b 1 +set EXIT_CODE=%ERRORLEVEL% +if %EXIT_CODE% equ 0 set EXIT_CODE=1 +if not ""=="%GRADLE_EXIT_CONSOLE%" exit %EXIT_CODE% +exit /b %EXIT_CODE% :mainEnd if "%OS%"=="Windows_NT" endlocal diff --git a/jitpack.yml b/jitpack.yml index 8136a0c..a5396c1 100644 --- a/jitpack.yml +++ b/jitpack.yml @@ -2,4 +2,4 @@ # https://jitpack.io/docs/BUILDING/#java-version jdk: - - openjdk8 + - openjdk11 diff --git a/modules/kotka-streams-extensions/build.gradle.kts b/modules/kotka-streams-extensions/build.gradle.kts index a08b1c3..6cecab7 100644 --- a/modules/kotka-streams-extensions/build.gradle.kts +++ b/modules/kotka-streams-extensions/build.gradle.kts @@ -4,5 +4,7 @@ plugins { } dependencies { + implementation(platform(projects.modules.versionsPlatform)) + implementation(libs.kafka.streams) } diff --git a/modules/kotka-streams-extensions/src/main/kotlin/dev/adamko/kotka/extensions/streams/KStream.kt b/modules/kotka-streams-extensions/src/main/kotlin/dev/adamko/kotka/extensions/streams/KStream.kt index a565400..4c19b25 100644 --- a/modules/kotka-streams-extensions/src/main/kotlin/dev/adamko/kotka/extensions/streams/KStream.kt +++ b/modules/kotka-streams-extensions/src/main/kotlin/dev/adamko/kotka/extensions/streams/KStream.kt @@ -3,6 +3,7 @@ package dev.adamko.kotka.extensions.streams import dev.adamko.kotka.extensions.namedAs import dev.adamko.kotka.extensions.toKeyValue import org.apache.kafka.common.utils.Bytes +import org.apache.kafka.streams.KeyValue import org.apache.kafka.streams.kstream.BranchedKStream import org.apache.kafka.streams.kstream.ForeachAction import org.apache.kafka.streams.kstream.GlobalKTable @@ -66,9 +67,20 @@ fun KStream.groupBy( fun KStream.to( - produced: Produced, - topicNameExtractor: TopicNameExtractor, -) = to(topicNameExtractor, produced) + produced: Produced? = null, + topicNameExtractor: TopicNameExtractorKt, +) { + val extractor = TopicNameExtractor { key, value, recordContext -> + with(topicNameExtractor) { + TopicNameExtractorContextInternal(recordContext).extract(KeyValue(key, value)) + } + } + + return when (produced) { + null -> to(extractor) + else -> to(extractor, produced) + } +} fun KStream.filter( @@ -111,17 +123,15 @@ fun KStream.split( } -fun KStream.join( - table: KTable, - valueJoiner: ValueJoinerWithKey, - joined: Joined, -): KStream { - return join( - table, - valueJoiner, - joined, - ) -} +fun KStream.join( + table: KTable, + joined: Joined, + valueJoiner: ValueJoinerWithKey, +): KStream = join( + table, + valueJoiner, + joined, +) fun KStream.join( @@ -129,14 +139,13 @@ fun KStream.join( globalTable: GlobalKTable, keySelector: KeyValueMapper, valueJoiner: ValueJoinerWithKey, -): KStream { - return join( +): KStream = + join( globalTable, keySelector, valueJoiner, namedAs(name), ) -} fun KStream.leftJoin( @@ -144,14 +153,13 @@ fun KStream.leftJoin( globalTable: GlobalKTable, keySelector: KeyValueMapper, valueJoiner: ValueJoinerWithKey, -): KStream { - return leftJoin( +): KStream = + leftJoin( globalTable, keySelector, valueJoiner, namedAs(name), ) -} /** @see KStream.foreach */ diff --git a/modules/kotka-streams-extensions/src/main/kotlin/dev/adamko/kotka/extensions/streams/topicNameExtractor.kt b/modules/kotka-streams-extensions/src/main/kotlin/dev/adamko/kotka/extensions/streams/topicNameExtractor.kt new file mode 100644 index 0000000..33dab4e --- /dev/null +++ b/modules/kotka-streams-extensions/src/main/kotlin/dev/adamko/kotka/extensions/streams/topicNameExtractor.kt @@ -0,0 +1,19 @@ +package dev.adamko.kotka.extensions.streams + +import org.apache.kafka.streams.KeyValue +import org.apache.kafka.streams.processor.RecordContext + + +fun interface TopicNameExtractorKt { + fun Context.extract(keyValue: KeyValue): String + + interface Context { + val recordContext: RecordContext + } +} + + +@JvmInline +internal value class TopicNameExtractorContextInternal( + override val recordContext: RecordContext +) : TopicNameExtractorKt.Context diff --git a/modules/kotka-streams-extensions/src/main/kotlin/dev/adamko/kotka/extensions/streamsBuilder.kt b/modules/kotka-streams-extensions/src/main/kotlin/dev/adamko/kotka/extensions/streamsBuilder.kt new file mode 100644 index 0000000..409d179 --- /dev/null +++ b/modules/kotka-streams-extensions/src/main/kotlin/dev/adamko/kotka/extensions/streamsBuilder.kt @@ -0,0 +1,19 @@ +package dev.adamko.kotka.extensions + +import org.apache.kafka.streams.StreamsBuilder +import org.apache.kafka.streams.kstream.Consumed +import org.apache.kafka.streams.kstream.KStream + + +fun StreamsBuilder.stream( + consumed: Consumed? = null, + vararg topics: String, +): KStream = when (consumed) { + null -> stream(topics.toList()) + else -> stream(topics.toList(), consumed) +} + + +fun StreamsBuilder.stream( + vararg topics: String, +): KStream = stream(topics.toList()) diff --git a/modules/kotka-streams-extensions/src/test/kotlin/dev/adamko/kotka/extensions/StreamsBuilderTests.kt b/modules/kotka-streams-extensions/src/test/kotlin/dev/adamko/kotka/extensions/StreamsBuilderTests.kt new file mode 100644 index 0000000..3e8d8e5 --- /dev/null +++ b/modules/kotka-streams-extensions/src/test/kotlin/dev/adamko/kotka/extensions/StreamsBuilderTests.kt @@ -0,0 +1,90 @@ +package dev.adamko.kotka.extensions + +import io.kotest.core.spec.style.FunSpec +import io.kotest.property.Arb +import io.kotest.property.arbitrary.list +import io.kotest.property.arbitrary.string +import io.kotest.property.checkAll +import io.mockk.confirmVerified +import io.mockk.every +import io.mockk.mockk +import io.mockk.verify +import org.apache.kafka.streams.StreamsBuilder +import org.apache.kafka.streams.kstream.Consumed + +class StreamsBuilderTests : FunSpec({ + + context("verify StreamBuilder.stream() with vararg topics calls stream() with List<>") { + val topicsArb = Arb.list(Arb.string()) + + + test("single topic") { + val builderMock: StreamsBuilder = mockk { + every { stream(any>()) } returns mockk() + } + + builderMock.stream(consumed = null, "test-topic") + + verify(exactly = 1) { + builderMock.stream(listOf("test-topic")) + } + confirmVerified(builderMock) + } + + + test("multiple topics") { + val builderMock: StreamsBuilder = mockk { + every { stream(any>()) } returns mockk() + } + + builderMock.stream( + "test-topic-1", + "test-topic-2", + "test-topic-3", + ) + + verify(exactly = 1) { + builderMock.stream( + listOf( + "test-topic-1", + "test-topic-2", + "test-topic-3", + ) + ) + } + confirmVerified(builderMock) + } + + + test("typed array, without Consumed") { + checkAll(topicsArb) { topics -> + val builderMock: StreamsBuilder = mockk { + every { stream(any>()) } returns mockk() + } + + builderMock.stream(topics = topics.toTypedArray()) + + verify(exactly = 1) { builderMock.stream(topics) } + confirmVerified(builderMock) + } + } + + + test("typed array, with Consumed") { + checkAll(topicsArb) { topics -> + val builderMock: StreamsBuilder = mockk { + every { + stream(any>(), any>()) + } returns mockk() + } + val consumed: Consumed = mockk() + + builderMock.stream(topics = topics.toTypedArray(), consumed = consumed) + + verify(exactly = 1) { builderMock.stream(topics, consumed) } + confirmVerified(builderMock) + } + } + } + +}) diff --git a/modules/kotka-streams-framework/build.gradle.kts b/modules/kotka-streams-framework/build.gradle.kts index 0c70b16..dcd52f3 100644 --- a/modules/kotka-streams-framework/build.gradle.kts +++ b/modules/kotka-streams-framework/build.gradle.kts @@ -4,6 +4,8 @@ plugins { } dependencies { + implementation(platform(projects.modules.versionsPlatform)) + api(projects.modules.kotkaStreamsExtensions) implementation(libs.kafka.streams) diff --git a/modules/kotka-streams-kotlinx-serialization/build.gradle.kts b/modules/kotka-streams-kotlinx-serialization/build.gradle.kts index 33f45cc..9014d1d 100644 --- a/modules/kotka-streams-kotlinx-serialization/build.gradle.kts +++ b/modules/kotka-streams-kotlinx-serialization/build.gradle.kts @@ -6,16 +6,17 @@ plugins { @Suppress("UnstableApiUsage") // version catalogs + platform() is incubating dependencies { + implementation(platform(projects.modules.versionsPlatform)) + api(projects.modules.kotkaStreamsExtensions) api(projects.modules.kotkaStreamsFramework) implementation(libs.kafka.streams) - implementation(platform(libs.kotlinx.serialization.bom)) - implementation(libs.kotlinx.serialization.core) + implementation(libs.kotlinxSerialization.core) - testImplementation(libs.kotlinx.serialization.cbor) - testImplementation(libs.kotlinx.serialization.json) + testImplementation(libs.kotlinxSerialization.cbor) + testImplementation(libs.kotlinxSerialization.json) } diff --git a/modules/versions-platform/build.gradle.kts b/modules/versions-platform/build.gradle.kts new file mode 100644 index 0000000..19812de --- /dev/null +++ b/modules/versions-platform/build.gradle.kts @@ -0,0 +1,25 @@ +plugins { + kotka.convention.subproject + kotka.convention.`maven-publish` + + `java-platform` +} + +javaPlatform { + allowDependencies() +} + +dependencies { + + api(platform(libs.kotlin.bom)) + api(platform(libs.kotlinxSerialization.bom)) + + api(platform(libs.kotest.bom)) + api(platform(libs.junit.bom)) + + constraints { + api(libs.kafka.streams) + api(libs.kotlinx.knitTest) + api(libs.mockk) + } +} diff --git a/settings.gradle.kts b/settings.gradle.kts index d46b765..7cfd8f1 100644 --- a/settings.gradle.kts +++ b/settings.gradle.kts @@ -5,6 +5,7 @@ include( ":modules:kotka-streams-extensions", ":modules:kotka-streams-framework", ":modules:kotka-streams-kotlinx-serialization", + ":modules:versions-platform", ) enableFeaturePreview("TYPESAFE_PROJECT_ACCESSORS")