Merge branch 'develop'

Author: fzhinkin

.gitignore

@@ -1,6 +1,6 @@
 build
 bin
-.idea
+.idea/*
 *.iml
 .gradle
 *.swp

.idea/codeStyles/Project.xml

@@ -48,5 +48,5 @@ to Gradle (in Preferences -> Build, Execution, Deployment -> Build Tools -> Grad
 ### Updating the public API dump
 
 * Use the [Binary Compatibility Validator](https://github.com/Kotlin/binary-compatibility-validator/blob/master/README.md) for updates to public API:
-    * Run `./gradlew apiDump` to update API index files.
+    * Run `./gradlew updateLegacyAbi` to update API index files.
     * Commit the updated API indexes together with other changes.

.idea/codeStyles/codeStyleConfig.xml

@@ -1,5 +1,5 @@
 /*
- * Copyright 2017-2023 JetBrains s.r.o. and respective authors and developers.
+ * Copyright 2017-2025 JetBrains s.r.o. and respective authors and developers.
  * Use of this source code is governed by the Apache 2.0 license that can be found in the LICENCE file.
  */
 
@@ -13,6 +13,7 @@ repositories {
 
 dependencies {
     implementation(libs.kotlin.gradle.plugin)
+    implementation(libs.power.assert.plugin)
     implementation(libs.dokka.gradle.plugin)
     implementation(libs.animalsniffer.gradle.plugin)
 }

CONTRIBUTING.md

@@ -0,0 +1,21 @@
+/*
+ * Copyright 2010-2025 JetBrains s.r.o. and respective authors and developers.
+ * Use of this source code is governed by the Apache 2.0 license that can be found in the LICENCE file.
+ */
+
+import org.jetbrains.kotlin.gradle.dsl.abi.ExperimentalAbiValidation
+
+plugins {
+    kotlin("multiplatform")
+}
+
+kotlin {
+    @OptIn(ExperimentalAbiValidation::class)
+    abiValidation {
+        enabled = true
+    }
+}
+
+tasks.check {
+    dependsOn(tasks.checkLegacyAbi)
+}

build-logic/build.gradle.kts

@@ -1,5 +1,5 @@
 /*
- * Copyright 2017-2024 JetBrains s.r.o. and respective authors and developers.
+ * Copyright 2017-2025 JetBrains s.r.o. and respective authors and developers.
  * Use of this source code is governed by the Apache 2.0 license that can be found in the LICENCE file.
  */
 
@@ -13,6 +13,7 @@ import kotlin.jvm.optionals.getOrNull
 
 plugins {
     kotlin("multiplatform")
+    kotlin("plugin.power-assert")
     id("kotlinx-io-clean")
 }
 
@@ -125,6 +126,24 @@ kotlin {
     }
 }
 
+@OptIn(ExperimentalKotlinGradlePluginApi::class)
+powerAssert {
+    // assertFails* are not included as p-a does not help with them yet
+    val kotlinTestFunctions = listOf(
+        "assertTrue", "assertFalse",
+        "assertNull", "assertNotNull",
+        "assertSame", "assertNotSame",
+        "assertEquals", "assertNotEquals",
+        "assertIs", "assertIsNot",
+        "assertIsOfType", "assertIsNotOfType",
+        "assertContains",
+        "assertContentEquals",
+        "expect"
+    ).map { "kotlin.test.$it"}
+
+    functions.addAll(kotlinTestFunctions)
+}
+
 fun KotlinSourceSet.configureSourceSet() {
     val srcDir = if (name.endsWith("Main")) "src" else "test"
     val platform = name.dropLast(4)

build-logic/src/main/kotlin/kotlinx/io/conventions/kotlinx-io-compatibility.gradle.kts

@@ -55,35 +55,16 @@ fun MavenPom.configureMavenCentralMetadata(project: Project) {
     }
 }
 
-fun MavenPublication.mavenCentralArtifacts(project: Project, sources: SourceDirectorySet) {
-    val sourcesJar by project.tasks.creating(Jar::class) {
-        archiveClassifier = "sources"
-        from(sources)
-    }
-    val javadocJar by project.tasks.creating(Jar::class) {
-        archiveClassifier = "javadoc"
-        // contents are deliberately left empty
-    }
-    artifact(sourcesJar)
-    artifact(javadocJar)
-}
 
-
-fun mavenRepositoryUri(): URI {
-    val repositoryId: String? = System.getenv("libs.repository.id")
-    return if (repositoryId == null) {
-        URI("https://oss.sonatype.org/service/local/staging/deploy/maven2/")
-    } else {
-        URI("https://oss.sonatype.org/service/local/staging/deployByRepositoryId/$repositoryId")
-    }
-}
-
-fun RepositoryHandler.configureMavenPublication( project: Project) {
-    maven {
-        url = mavenRepositoryUri()
-        credentials {
-            username = project.getSensitiveProperty("libs.sonatype.user")
-            password = project.getSensitiveProperty("libs.sonatype.password")
+fun RepositoryHandler.configureMavenPublication(project: Project) {
+    val repositoryUrl = project.getSensitiveProperty("libs.repo.url")
+    if (!repositoryUrl.isNullOrBlank()) {
+        maven {
+            url = uri(repositoryUrl)
+            credentials {
+                username = project.getSensitiveProperty("libs.repo.user")
+                password = project.getSensitiveProperty("libs.repo.password")
+            }
         }
     }
 

build-logic/src/main/kotlin/kotlinx/io/conventions/kotlinx-io-multiplatform.gradle.kts

@@ -4,14 +4,11 @@
  */
 
 import kotlinx.kover.gradle.plugin.dsl.CoverageUnit
-import kotlinx.validation.ExperimentalBCVApi
 
 plugins {
     id("kotlinx-io-publish") apply false
     id("kotlinx-io-dokka")
-
     alias(libs.plugins.kover)
-    alias(libs.plugins.bcv)
 }
 
 allprojects {
@@ -21,15 +18,6 @@ allprojects {
     }
 }
 
-@OptIn(ExperimentalBCVApi::class)
-apiValidation {
-    ignoredProjects.addAll(listOf(
-        "kotlinx-io-benchmarks",
-        "kotlinx-io-smoke-tests"
-    ))
-    klib.enabled = true
-}
-
 dependencies {
     kover(project(":kotlinx-io-core"))
     kover(project(":kotlinx-io-bytestring"))

build-logic/src/main/kotlin/kotlinx/io/conventions/kotlinx-io-publish.gradle.kts

@@ -3,6 +3,7 @@ plugins {
     id("kotlinx-io-publish")
     id("kotlinx-io-dokka")
     id("kotlinx-io-android-compat")
+    id("kotlinx-io-compatibility")
     alias(libs.plugins.kover)
 }