Kotlin · shanshin · Sep 3, 2024 · Sep 3, 2024
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,3 +1,33 @@
+0.9.0-RC / 2024-09-03
+===================
+## Kover Gradle Plugin
+### Features
+* [`#645`](https://github.com/Kotlin/kotlinx-kover/issues/660) Added ability to supplement coverage values from external binary reports
+* [`#673`](https://github.com/Kotlin/kotlinx-kover/issues/673) Implemented ability to specify instrumentation include filter
+### Bugfixes
+* [`#678`](https://github.com/Kotlin/kotlinx-kover/issues/678) Added USAGE attribute to all Kover configurations
+* [`#666`](https://github.com/Kotlin/kotlinx-kover/issues/666) Replaced JaCoCo ant-calls with programmatic calls of JaCoCo's classes
+
+## Kover Aggregation Plugin
+### Features
+* Made class KoverSettingsGradlePlugin from aggregated plugin public
+* Implemented verification in Kover Aggregated Plugin
+
+## Kover CLI
+### Features
+* [`#677`](https://github.com/Kotlin/kotlinx-kover/issues/677) Implemented merging of binary reports in Kover CLI and Kover Features
+
+## Kover JVM Agent
+### Bugfixes
+* Fixed JVM agent arguments parsing to support include filter
+
+### Documentation
+* [`#660`](https://github.com/Kotlin/kotlinx-kover/issues/660) Fixed mistake in JVM agent docs
+
+## Kover Maven Plugin
+### Documentation
+* [`#658`](https://github.com/Kotlin/kotlinx-kover/issues/658) Fixed documentation about Maven plugin
+
 0.8.3 / 2024-07-18
 ===================
 ## Kover Aggregation Plugin

diff --git a/README.md b/README.md
@@ -39,7 +39,7 @@ Add the following to your top-level build file:
 
 ```kotlin
 plugins {
-     id("org.jetbrains.kotlinx.kover") version "0.8.3"
+     id("org.jetbrains.kotlinx.kover") version "0.9.0-RC"
 }
 ```
 </details>
@@ -49,7 +49,7 @@ plugins {
 
 ```groovy
 plugins {
-    id 'org.jetbrains.kotlinx.kover' version '0.8.3'
+    id 'org.jetbrains.kotlinx.kover' version '0.9.0-RC'
 }
 ```
 </details>
@@ -74,7 +74,7 @@ buildscript {
     }
 
     dependencies {
-        classpath("org.jetbrains.kotlinx:kover-gradle-plugin:0.8.3")
+        classpath("org.jetbrains.kotlinx:kover-gradle-plugin:0.9.0-RC")
     }
 }
 
@@ -93,7 +93,7 @@ buildscript {
         mavenCentral()
     }
     dependencies {
-        classpath 'org.jetbrains.kotlinx:kover-gradle-plugin:0.8.3'
+        classpath 'org.jetbrains.kotlinx:kover-gradle-plugin:0.9.0-RC'
     }
 }
 
@@ -126,7 +126,7 @@ The Kover Maven Plugin can be applied by specifying build plugin
 <plugin>
     <groupId>org.jetbrains.kotlinx</groupId>
     <artifactId>kover-maven-plugin</artifactId>
-    <version>0.8.3</version>
+    <version>0.9.0-RC</version>
 </plugin>
 ```
 

diff --git a/gradle.properties b/gradle.properties
@@ -1,6 +1,6 @@
-version=0.8.4-SNAPSHOT
+version=0.9.0-SNAPSHOT
 group=org.jetbrains.kotlinx
 
 # version of the latest release
-kover.release.version=0.8.3
+kover.release.version=0.9.0-RC
 kotlin.code.style=official
diff --git a/kover-gradle-plugin/docs/aggregated.md b/kover-gradle-plugin/docs/aggregated.md
@@ -8,7 +8,7 @@ The main difference from the existing Kover Gradle Plugin is the reactive conten
 To use the plugin, just add into a `settings.gradle.kts` file 
 ```kotlin
 plugins {
-    id("org.jetbrains.kotlinx.kover.aggregation") version "0.8.3"
+    id("org.jetbrains.kotlinx.kover.aggregation") version "0.9.0-RC"
 }
 ```
 **There is no need to apply Kover plugin in other places, the `org.jetbrains.kotlinx.kover` plug-in should not be applied anywhere.**

diff --git a/kover-gradle-plugin/docs/index.md b/kover-gradle-plugin/docs/index.md
@@ -55,7 +55,7 @@ Add the following to your build file:
 
 ```kotlin
 plugins {
-     id("org.jetbrains.kotlinx.kover") version "0.8.3"
+     id("org.jetbrains.kotlinx.kover") version "0.9.0-RC"
 }
 ```
 For more information about application of the plugin, refer to the [relevant section](#apply-kover-gradle-plugin-in-project)
@@ -127,7 +127,7 @@ Add the following line to build file in each module of your Gradle build:
 
 ```kotlin
 plugins {
-     id("org.jetbrains.kotlinx.kover") version "0.8.3"
+     id("org.jetbrains.kotlinx.kover") version "0.9.0-RC"
 }
 ```
 It is recommended to apply the Kover Plugin in the root module, even if there is no source code or tests there.
@@ -225,7 +225,7 @@ Otherwise, the use of the plugin is identical to the use in the [multi-module Ko
 Add the following to the build file only in the `app` module of your Gradle build:
 ```kotlin
 plugins {
-     id("org.jetbrains.kotlinx.kover") version "0.8.3"
+     id("org.jetbrains.kotlinx.kover") version "0.9.0-RC"
 }
 ```
 
@@ -378,7 +378,7 @@ Add the following to build file in each module of your Gradle build:
 
 ```kotlin
 plugins {
-     id("org.jetbrains.kotlinx.kover") version "0.8.3"
+     id("org.jetbrains.kotlinx.kover") version "0.9.0-RC"
 }
 ```
 It is recommended to apply the Kover Plugin in the root module, even if there is no source code or tests there.
@@ -582,7 +582,7 @@ Add the following to build file in each module of your Gradle build:
 
 ```kotlin
 plugins {
-     id("org.jetbrains.kotlinx.kover") version "0.8.3"
+     id("org.jetbrains.kotlinx.kover") version "0.9.0-RC"
 }
 ```
 It is recommended to apply the Kover Plugin in the root module, even if there is no source code or tests there.
@@ -759,7 +759,7 @@ Add the following to your build file:
 
 ```kotlin
 plugins {
-     id("org.jetbrains.kotlinx.kover") version "0.8.3"
+     id("org.jetbrains.kotlinx.kover") version "0.9.0-RC"
 }
 ```
 
@@ -777,7 +777,7 @@ buildscript {
     }
 
     dependencies {
-        classpath("org.jetbrains.kotlinx:kover-gradle-plugin:0.8.3")
+        classpath("org.jetbrains.kotlinx:kover-gradle-plugin:0.9.0-RC")
     }
 }
 
@@ -793,7 +793,7 @@ buildscript {
         mavenCentral()
     }
     dependencies {
-        classpath 'org.jetbrains.kotlinx:kover-gradle-plugin:0.8.3'
+        classpath 'org.jetbrains.kotlinx:kover-gradle-plugin:0.9.0-RC'
     }
 }
 

diff --git a/kover-gradle-plugin/examples/android/dynamic/build.gradle.kts b/kover-gradle-plugin/examples/android/dynamic/build.gradle.kts
@@ -3,5 +3,5 @@ plugins {
     id("com.android.library") version "7.4.0" apply false
     id ("com.android.dynamic-feature") version "7.4.0" apply false
     id("org.jetbrains.kotlin.android") version "1.8.20" apply false
-    id("org.jetbrains.kotlinx.kover") version "0.8.3" apply false
+    id("org.jetbrains.kotlinx.kover") version "0.9.0-RC" apply false
 }
diff --git a/kover-gradle-plugin/examples/android/flavors/build.gradle.kts b/kover-gradle-plugin/examples/android/flavors/build.gradle.kts
@@ -2,5 +2,5 @@ plugins {
     id("com.android.application") version "7.4.0" apply false
     id("com.android.library") version "7.4.0" apply false
     id("org.jetbrains.kotlin.android") version "1.8.20" apply false
-    id("org.jetbrains.kotlinx.kover") version "0.8.3" apply false
+    id("org.jetbrains.kotlinx.kover") version "0.9.0-RC" apply false
 }
diff --git a/kover-gradle-plugin/examples/android/minimal_groovy/build.gradle b/kover-gradle-plugin/examples/android/minimal_groovy/build.gradle
@@ -2,5 +2,5 @@ plugins {
     id 'com.android.application' version '7.4.0' apply false
     id 'com.android.library' version '7.4.0' apply false
     id 'org.jetbrains.kotlin.android' version '1.8.20' apply false
-    id 'org.jetbrains.kotlinx.kover' version '0.8.3' apply false
+    id 'org.jetbrains.kotlinx.kover' version '0.9.0-RC' apply false
 }
diff --git a/kover-gradle-plugin/examples/android/minimal_kts/build.gradle.kts b/kover-gradle-plugin/examples/android/minimal_kts/build.gradle.kts
@@ -2,5 +2,5 @@ plugins {
     id("com.android.application") version "7.4.0" apply false
     id("com.android.library") version "7.4.0" apply false
     id("org.jetbrains.kotlin.android") version "1.8.20" apply false
-    id("org.jetbrains.kotlinx.kover") version "0.8.3" apply false
+    id("org.jetbrains.kotlinx.kover") version "0.9.0-RC" apply false
 }
diff --git a/kover-gradle-plugin/examples/android/multiplatform/build.gradle.kts b/kover-gradle-plugin/examples/android/multiplatform/build.gradle.kts
@@ -2,7 +2,7 @@ plugins {
     id("com.android.application") version "7.4.0" apply false
     id("com.android.library") version "7.4.0" apply false
     kotlin("multiplatform") version ("1.8.20") apply false
-    id("org.jetbrains.kotlinx.kover") version "0.8.3"
+    id("org.jetbrains.kotlinx.kover") version "0.9.0-RC"
 }
 
 dependencies {

diff --git a/kover-gradle-plugin/examples/android/multiproject-custom/build.gradle.kts b/kover-gradle-plugin/examples/android/multiproject-custom/build.gradle.kts
@@ -2,7 +2,7 @@ plugins {
     id("com.android.application") version "7.4.0" apply false
     id("com.android.library") version "7.4.0" apply false
     id("org.jetbrains.kotlin.android") version "1.8.20" apply false
-    id("org.jetbrains.kotlinx.kover") version "0.8.3"
+    id("org.jetbrains.kotlinx.kover") version "0.9.0-RC"
 }
 
 dependencies {

diff --git a/kover-gradle-plugin/examples/android/multiproject/build.gradle.kts b/kover-gradle-plugin/examples/android/multiproject/build.gradle.kts
@@ -2,5 +2,5 @@ plugins {
     id("com.android.application") version "7.4.0" apply false
     id("com.android.library") version "7.4.0" apply false
     id("org.jetbrains.kotlin.android") version "1.8.20" apply false
-    id("org.jetbrains.kotlinx.kover") version "0.8.3" apply false
+    id("org.jetbrains.kotlinx.kover") version "0.9.0-RC" apply false
 }
diff --git a/kover-gradle-plugin/examples/android/variantUsage/build.gradle.kts b/kover-gradle-plugin/examples/android/variantUsage/build.gradle.kts
@@ -2,5 +2,5 @@ plugins {
     id("com.android.application") version "7.4.0" apply false
     id("com.android.library") version "7.4.0" apply false
     id("org.jetbrains.kotlin.android") version "1.8.20" apply false
-    id("org.jetbrains.kotlinx.kover") version "0.8.3" apply false
+    id("org.jetbrains.kotlinx.kover") version "0.9.0-RC" apply false
 }
diff --git a/kover-gradle-plugin/examples/android/with-jvm/build.gradle.kts b/kover-gradle-plugin/examples/android/with-jvm/build.gradle.kts
@@ -3,7 +3,7 @@ plugins {
     id("com.android.library") version "7.4.0" apply false
     kotlin("android") version "1.8.20" apply false
     kotlin("jvm") version "1.8.20" apply false
-    id("org.jetbrains.kotlinx.kover") version "0.8.3"
+    id("org.jetbrains.kotlinx.kover") version "0.9.0-RC"
 }
 
 dependencies {

diff --git a/kover-gradle-plugin/examples/jvm/copy-variant/build.gradle.kts b/kover-gradle-plugin/examples/jvm/copy-variant/build.gradle.kts
@@ -1,6 +1,6 @@
 plugins {
     kotlin("jvm") version "1.7.10"
-    id("org.jetbrains.kotlinx.kover") version "0.8.3"
+    id("org.jetbrains.kotlinx.kover") version "0.9.0-RC"
 }
 
 dependencies {

diff --git a/kover-gradle-plugin/examples/jvm/merged/build.gradle.kts b/kover-gradle-plugin/examples/jvm/merged/build.gradle.kts
@@ -1,6 +1,6 @@
 plugins {
     kotlin("jvm") version "1.7.10"
-    id("org.jetbrains.kotlinx.kover") version "0.8.3"
+    id("org.jetbrains.kotlinx.kover") version "0.9.0-RC"
 }
 
 dependencies {

diff --git a/kover-gradle-plugin/examples/jvm/single-kmp/build.gradle.kts b/kover-gradle-plugin/examples/jvm/single-kmp/build.gradle.kts
@@ -1,6 +1,6 @@
 plugins {
     kotlin("multiplatform") version "1.9.20"
-    id("org.jetbrains.kotlinx.kover") version "0.8.3"
+    id("org.jetbrains.kotlinx.kover") version "0.9.0-RC"
 }
 
 kotlin {

diff --git a/kover-gradle-plugin/examples/jvm/single/build.gradle.kts b/kover-gradle-plugin/examples/jvm/single/build.gradle.kts
@@ -1,6 +1,6 @@
 plugins {
     kotlin("jvm") version "1.7.10"
-    id("org.jetbrains.kotlinx.kover") version "0.8.3"
+    id("org.jetbrains.kotlinx.kover") version "0.9.0-RC"
 }
 
 dependencies {

diff --git a/kover-jvm-agent/docs/index.md b/kover-jvm-agent/docs/index.md
@@ -16,7 +16,7 @@ To get a readable coverage report, you need to:
 2. Put JVM agent jar file in a local directory (Important! renaming a jar file is not allowed).
 3. Create a file with agent arguments, [learn more about the arguments](#kover-jvm-arguments-file).
 4. Add an argument to the java application startup command `-javaagent:<path_to_agent_jar>=file:<path_to_settings_file>`.
-   Example of an application launch command `java -javaagent:/opt/kover-jvm-agent-0.8.3.jar=file:/tmp/agent.args -jar application.jar`.
+   Example of an application launch command `java -javaagent:/opt/kover-jvm-agent-0.9.0-RC.jar=file:/tmp/agent.args -jar application.jar`.
 
 ## Kover JVM arguments file
 The arguments file is a set of settings, each of which is written on a new line.

diff --git a/kover-maven-plugin/docs/index.md b/kover-maven-plugin/docs/index.md
@@ -22,7 +22,7 @@ Maven plugin to measure test coverage and generate human-readable reports with c
 - simultaneous use of several instrumentation agents can lead to unpredictable consequences and unstable operation
 
 ## Quickstart
-To use Kover coverage measurement it is necessary to add plugin `org.jetbrains.kotlinx:kover-maven-plugin:0.8.3` to build configuration in `pom.xml` and create executions for used goals.
+To use Kover coverage measurement it is necessary to add plugin `org.jetbrains.kotlinx:kover-maven-plugin:0.9.0-RC` to build configuration in `pom.xml` and create executions for used goals.
 
 With the following configuration HTML and XML reports will be generated, and verification rules will be checked on `verify` phase:
 ```xml
@@ -35,7 +35,7 @@ With the following configuration HTML and XML reports will be generated, and ver
             <plugin>
                 <groupId>org.jetbrains.kotlinx</groupId>
                 <artifactId>kover-maven-plugin</artifactId>
-                <version>0.8.3</version>
+                <version>0.9.0-RC</version>
                 <executions>
                     <!-- instrument test tasks -->
                     <execution>
@@ -104,7 +104,7 @@ All available configuration options are shown below:
 <plugin>
     <groupId>org.jetbrains.kotlinx</groupId>
     <artifactId>kover-maven-plugin</artifactId>
-    <version>0.8.3</version>
+    <version>0.9.0-RC</version>
     <executions>
         <!-- instrument test tasks -->
         <execution>

diff --git a/kover-offline-runtime/docs/index.md b/kover-offline-runtime/docs/index.md
@@ -20,7 +20,7 @@ must be passed to Kover CLI as arguments, see [Kover CLI](../cli#offline-instrum
 #### Instrumentation by Kover Features
 Kover Features is a library that provides capabilities similar to Kover CLI and Kover Gradle plugin.
 
-You can declare a dependency on Kover Features using following coordinates: `org.jetbrains.kotlinx:kover-features-jvm:0.8.3`.
+You can declare a dependency on Kover Features using following coordinates: `org.jetbrains.kotlinx:kover-features-jvm:0.9.0-RC`.
 
 Then you can use the Kover Features classes to instrument the bytecode of each class:
 ```kotlin
@@ -113,8 +113,8 @@ configurations.register("koverCli") {
 }
 
 dependencies {
-    runtimeOnly("org.jetbrains.kotlinx:kover-offline-runtime:0.8.3")
-    add("koverCli", "org.jetbrains.kotlinx:kover-cli:0.8.3")
+    runtimeOnly("org.jetbrains.kotlinx:kover-offline-runtime:0.9.0-RC")
+    add("koverCli", "org.jetbrains.kotlinx:kover-cli:0.9.0-RC")
 
     testImplementation(kotlin("test"))
 }

diff --git a/kover-offline-runtime/examples/runtime-api/build.gradle.kts b/kover-offline-runtime/examples/runtime-api/build.gradle.kts
@@ -16,9 +16,9 @@ configurations.register("koverCli") {
 }
 
 dependencies {
-    add("koverCli", "org.jetbrains.kotlinx:kover-cli:0.8.3")
+    add("koverCli", "org.jetbrains.kotlinx:kover-cli:0.9.0-RC")
 
-    implementation("org.jetbrains.kotlinx:kover-offline-runtime:0.8.3")
+    implementation("org.jetbrains.kotlinx:kover-offline-runtime:0.9.0-RC")
 
     testImplementation(kotlin("test"))
 }