readying examples and docs for Beta3

Jolanrensen · Jolanrensen · commit 114ea7197d8b · 2025-09-12T12:22:36.000+02:00
diff --git a/README.md b/README.md
@@ -54,7 +54,7 @@ You could find the following articles there:
 
 ### What's new
 
-1.0.0-Beta2: [Release notes](https://github.com/Kotlin/dataframe/releases/tag/v1.0.0-Beta2)
+1.0.0-Beta3: [Release notes](https://github.com/Kotlin/dataframe/releases/tag/v1.0.0-Beta3)
 
 Check out this [notebook with new features](examples/notebooks/feature_overviews/0.15/new_features.ipynb) in v0.15.
 
@@ -100,7 +100,7 @@ Add dependencies in the build.gradle.kts script:
 
 ```kotlin
 dependencies {
-    implementation("org.jetbrains.kotlinx:dataframe:1.0.0-Beta2")
+    implementation("org.jetbrains.kotlinx:dataframe:1.0.0-Beta3")
 }
 ```
 
@@ -124,7 +124,7 @@ for Groovy, and for configurations specific to Android projects.
 This example of Kotlin DataFrame code with
 the [Compiler Plugin](https://kotlin.github.io/dataframe/compiler-plugin.html) enabled.
 See [the full project](https://github.com/Kotlin/dataframe/tree/master/examples/kotlin-dataframe-plugin-example).
-See also 
+See also
 [this example in Kotlin Notebook](https://github.com/Kotlin/dataframe/tree/master/examples/notebooks/readme_example.ipynb).
 
 ```kotlin
@@ -175,18 +175,19 @@ for your dataframes.
 
 This table shows the mapping between main library component versions and minimum supported Java versions.
 
-| Kotlin DataFrame Version | Minimum Java Version | Kotlin Version | Kotlin Jupyter Version | Apache Arrow version |
-|--------------------------|----------------------|----------------|------------------------|----------------------|
-| 0.10.0                   | 8                    | 1.8.20         | 0.11.0-358             | 11.0.0               |
-| 0.10.1                   | 8                    | 1.8.20         | 0.11.0-358             | 11.0.0               |
-| 0.11.0                   | 8                    | 1.8.20         | 0.11.0-358             | 11.0.0               |
-| 0.11.1                   | 8                    | 1.8.20         | 0.11.0-358             | 11.0.0               |
-| 0.12.0                   | 8                    | 1.9.0          | 0.11.0-358             | 11.0.0               |
-| 0.12.1                   | 8                    | 1.9.0          | 0.11.0-358             | 11.0.0               |
-| 0.13.1                   | 8                    | 1.9.22         | 0.12.0-139             | 15.0.0               |
-| 0.14.1                   | 8                    | 2.0.20         | 0.12.0-139             | 17.0.0               |
-| 0.15.0                   | 8                    | 2.0.20         | 0.12.0-139             | 18.1.0               |
-| 1.0.0-Beta2              | 8 / 11               | 2.0.20         | 0.12.0-383             | 18.1.0               |
+| Kotlin DataFrame Version | Minimum Java Version | Kotlin Version | Kotlin Jupyter Version | Apache Arrow Version | Compiler Plugin Version | Compatible Kandy version |
+|--------------------------|----------------------|----------------|------------------------|----------------------|-------------------------|--------------------------|
+| 0.10.0                   | 8                    | 1.8.20         | 0.11.0-358             | 11.0.0               |                         |                          |
+| 0.10.1                   | 8                    | 1.8.20         | 0.11.0-358             | 11.0.0               |                         |                          |
+| 0.11.0                   | 8                    | 1.8.20         | 0.11.0-358             | 11.0.0               |                         |                          |
+| 0.11.1                   | 8                    | 1.8.20         | 0.11.0-358             | 11.0.0               |                         |                          |
+| 0.12.0                   | 8                    | 1.9.0          | 0.11.0-358             | 11.0.0               |                         |                          |
+| 0.12.1                   | 8                    | 1.9.0          | 0.11.0-358             | 11.0.0               |                         |                          |
+| 0.13.1                   | 8                    | 1.9.22         | 0.12.0-139             | 15.0.0               |                         |                          |
+| 0.14.1                   | 8                    | 2.0.20         | 0.12.0-139             | 17.0.0               |                         |                          |
+| 0.15.0                   | 8                    | 2.0.20         | 0.12.0-139             | 18.1.0               |                         | 0.8.0                    |
+| 1.0.0-Beta2              | 8 / 11               | 2.0.20         | 0.12.0-383             | 18.1.0               | 2.2.20-dev-3524         | 0.8.1-dev                |
+| 1.0.0-Beta3              | 8 / 11               | 2.2.20         | 0.15.0-587             | 18.3.0               | 2.2.20                  | TODO                     |
 
 ## Code of Conduct
 
diff --git a/docs/StardustDocs/resources/guides/quickstart.ipynb b/docs/StardustDocs/resources/guides/quickstart.ipynb
@@ -50,7 +50,7 @@
    },
    "cell_type": "code",
    "source": [
-    "val df = DataFrame.readCSV(\n",
+    "val df = DataFrame.readCsv(\n",
     "    \"https://raw.githubusercontent.com/Kotlin/dataframe/master/data/jetbrains_repositories.csv\"\n",
     ")"
    ],
diff --git a/docs/StardustDocs/topics/setup/Modules.md b/docs/StardustDocs/topics/setup/Modules.md
@@ -512,7 +512,7 @@ To enable the plugin in your Gradle project, add it to the `plugins` section:
 
 ```kotlin
 plugins {
-    kotlin("plugin.dataframe") version "2.2.20-Beta1"
+    kotlin("plugin.dataframe") version "%compilerPluginKotlinVersion%"
 }
 ```
 
@@ -522,7 +522,7 @@ plugins {
 
 ```groovy
 plugins {
-    id 'org.jetbrains.kotlin.plugin.dataframe' version '2.2.20-Beta1'
+    id 'org.jetbrains.kotlin.plugin.dataframe' version '%compilerPluginKotlinVersion%'
 }
 ```
 
diff --git a/docs/StardustDocs/topics/setup/SetupAndroid.md b/docs/StardustDocs/topics/setup/SetupAndroid.md
@@ -109,7 +109,7 @@ To enable the plugin in your Gradle project, add it to the `plugins` section:
 
 ```kotlin
 plugins {
-    kotlin("plugin.dataframe") version "2.2.20-Beta1"
+    kotlin("plugin.dataframe") version "%compilerPluginKotlinVersion%"
 }
 ```
 
@@ -119,7 +119,7 @@ plugins {
 
 ```groovy
 plugins {
-    id 'org.jetbrains.kotlin.plugin.dataframe' version '2.2.20-Beta1'
+    id 'org.jetbrains.kotlin.plugin.dataframe' version '%compilerPluginKotlinVersion%'
 }
 ```
 
diff --git a/docs/StardustDocs/topics/setup/SetupGradle.md b/docs/StardustDocs/topics/setup/SetupGradle.md
@@ -103,7 +103,7 @@ To enable the plugin in your Gradle project, add it to the `plugins` section:
 
 ```kotlin
 plugins {
-    kotlin("plugin.dataframe") version "2.2.20-Beta1"
+    kotlin("plugin.dataframe") version "%compilerPluginKotlinVersion%"
 }
 ```
 
@@ -113,7 +113,7 @@ plugins {
 
 ```groovy
 plugins {
-    id 'org.jetbrains.kotlin.plugin.dataframe' version '2.2.20-Beta1'
+    id 'org.jetbrains.kotlin.plugin.dataframe' version '%compilerPluginKotlinVersion%'
 }
 ```
 
diff --git a/docs/StardustDocs/topics/setup/SetupKotlinNotebook.md b/docs/StardustDocs/topics/setup/SetupKotlinNotebook.md
@@ -71,6 +71,13 @@ You can explicitly define the version you want:
 Or use the latest stable version of Kotlin DataFrame
 (specified in [Kotlin Jupyter descriptors](https://github.com/Kotlin/kotlin-jupyter-libraries)):
 
+<warning>
+For version `1.0.0-Beta3`, in notebooks use version `1.0.0-Beta3n` instead.
+This uses the patch of [#1435](https://github.com/Kotlin/dataframe/pull/1435) for issue 
+[#1116](https://github.com/Kotlin/dataframe/issues/1116), avoiding `DefinitelyNotNullable` errors.
+
+When using `%use dataframe` this version is applied automatically.
+</warning>
 
 ```
 %useLatestDescriptors
diff --git a/docs/StardustDocs/v.list b/docs/StardustDocs/v.list
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!DOCTYPE vars SYSTEM "https://resources.jetbrains.com/writerside/1.0/vars.dtd">
 <vars>
-    <var name="dataFrameVersion" value="1.0.0-Beta2" type="string"/>
-    <var name="compilerPluginKotlinVersion" value="2.2.20-Beta1" type="string"/>
+    <var name="dataFrameVersion" value="1.0.0-Beta3" type="string"/>
+    <var name="compilerPluginKotlinVersion" value="2.2.20" type="string"/>
 </vars>
diff --git a/examples/android-example/app/build.gradle.kts b/examples/android-example/app/build.gradle.kts
@@ -4,7 +4,9 @@ plugins {
     alias(libs.plugins.android.application)
     alias(libs.plugins.kotlin.android)
     alias(libs.plugins.kotlin.compose)
-    kotlin("plugin.dataframe") version "2.2.20-Beta2"
+
+    // DataFrame Compiler plugin, matching the Kotlin version
+    alias(libs.plugins.dataframe)
 }
 
 android {
@@ -66,9 +68,9 @@ dependencies {
     // Core Kotlin DataFrame API, JSON and CSV IO.
     // See custom Gradle setup:
     // https://kotlin.github.io/dataframe/setupcustomgradle.html
-    implementation("org.jetbrains.kotlinx:dataframe-core:1.0.0-dev-8314")
-    implementation("org.jetbrains.kotlinx:dataframe-json:1.0.0-dev-8314")
-    implementation("org.jetbrains.kotlinx:dataframe-csv:1.0.0-dev-8314")
+    implementation("org.jetbrains.kotlinx:dataframe-core:1.0.0-Beta3")
+    implementation("org.jetbrains.kotlinx:dataframe-json:1.0.0-Beta3")
+    implementation("org.jetbrains.kotlinx:dataframe-csv:1.0.0-Beta3")
     // You can add any additional IO modules you like, except for 'dataframe-arrow'.
     // Apache Arrow is not supported well on Android.
 }
diff --git a/examples/android-example/gradle/libs.versions.toml b/examples/android-example/gradle/libs.versions.toml
@@ -1,6 +1,6 @@
 [versions]
 agp = "8.11.1"
-kotlin = "2.2.20-Beta2"
+kotlin = "2.2.20"
 coreKtx = "1.10.1"
 junit = "4.13.2"
 junitVersion = "1.1.5"
@@ -29,4 +29,5 @@ androidx-material3 = { group = "androidx.compose.material3", name = "material3"
 android-application = { id = "com.android.application", version.ref = "agp" }
 kotlin-android = { id = "org.jetbrains.kotlin.android", version.ref = "kotlin" }
 kotlin-compose = { id = "org.jetbrains.kotlin.plugin.compose", version.ref = "kotlin" }
+dataframe = { id = "org.jetbrains.kotlin.plugin.dataframe", version.ref = "kotlin" }
 
diff --git a/examples/kotlin-dataframe-plugin-example/build.gradle.kts b/examples/kotlin-dataframe-plugin-example/build.gradle.kts
@@ -2,8 +2,10 @@ import org.jlleitschuh.gradle.ktlint.KtlintExtension
 
 plugins {
     id("org.jlleitschuh.gradle.ktlint") version "12.3.0"
-    kotlin("jvm") version "2.2.20-Beta2"
-    kotlin("plugin.dataframe") version "2.2.20-Beta2"
+
+    val kotlinVersion = "2.2.20"
+    kotlin("jvm") version kotlinVersion
+    kotlin("plugin.dataframe") version kotlinVersion
 }
 
 group = "org.example"
@@ -15,7 +17,7 @@ repositories {
 }
 
 dependencies {
-    implementation("org.jetbrains.kotlinx:dataframe:1.0.0-Beta2")
+    implementation("org.jetbrains.kotlinx:dataframe:1.0.0-Beta3")
     testImplementation(kotlin("test"))
 }
 

Original file line number	Diff line number	Diff line change
@@ -512,7 +512,7 @@ To enable the plugin in your Gradle project, add it to the `plugins` section:
`512`	`512`
`513`	`513`	```kotlin
`514`	`514`	`plugins {`
`515`		`- kotlin("plugin.dataframe") version "2.2.20-Beta1"`
	`515`	`+ kotlin("plugin.dataframe") version "%compilerPluginKotlinVersion%"`
`516`	`516`	`}`
`517`	`517`	```
`518`	`518`
`@@ -522,7 +522,7 @@ plugins {`
`522`	`522`
`523`	`523`	```groovy
`524`	`524`	`plugins {`
`525`		`- id 'org.jetbrains.kotlin.plugin.dataframe' version '2.2.20-Beta1'`
	`525`	`+ id 'org.jetbrains.kotlin.plugin.dataframe' version '%compilerPluginKotlinVersion%'`
`526`	`526`	`}`
`527`	`527`	```
`528`	`528`
Original file line number	Diff line number	Diff line change
@@ -109,7 +109,7 @@ To enable the plugin in your Gradle project, add it to the `plugins` section:
`109`	`109`
`110`	`110`	```kotlin
`111`	`111`	`plugins {`
`112`		`- kotlin("plugin.dataframe") version "2.2.20-Beta1"`
	`112`	`+ kotlin("plugin.dataframe") version "%compilerPluginKotlinVersion%"`
`113`	`113`	`}`
`114`	`114`	```
`115`	`115`
`@@ -119,7 +119,7 @@ plugins {`
`119`	`119`
`120`	`120`	```groovy
`121`	`121`	`plugins {`
`122`		`- id 'org.jetbrains.kotlin.plugin.dataframe' version '2.2.20-Beta1'`
	`122`	`+ id 'org.jetbrains.kotlin.plugin.dataframe' version '%compilerPluginKotlinVersion%'`
`123`	`123`	`}`
`124`	`124`	```
`125`	`125`
Original file line number	Diff line number	Diff line change
@@ -103,7 +103,7 @@ To enable the plugin in your Gradle project, add it to the `plugins` section:
`103`	`103`
`104`	`104`	```kotlin
`105`	`105`	`plugins {`
`106`		`- kotlin("plugin.dataframe") version "2.2.20-Beta1"`
	`106`	`+ kotlin("plugin.dataframe") version "%compilerPluginKotlinVersion%"`
`107`	`107`	`}`
`108`	`108`	```
`109`	`109`
`@@ -113,7 +113,7 @@ plugins {`
`113`	`113`
`114`	`114`	```groovy
`115`	`115`	`plugins {`
`116`		`- id 'org.jetbrains.kotlin.plugin.dataframe' version '2.2.20-Beta1'`
	`116`	`+ id 'org.jetbrains.kotlin.plugin.dataframe' version '%compilerPluginKotlinVersion%'`
`117`	`117`	`}`
`118`	`118`	```
`119`	`119`
Original file line number	Diff line number	Diff line change
`@@ -2,8 +2,10 @@ import org.jlleitschuh.gradle.ktlint.KtlintExtension`
`2`	`2`
`3`	`3`	`plugins {`
`4`	`4`	`id("org.jlleitschuh.gradle.ktlint") version "12.3.0"`
`5`		`- kotlin("jvm") version "2.2.20-Beta2"`
`6`		`- kotlin("plugin.dataframe") version "2.2.20-Beta2"`
	`5`	`+`
	`6`	`+ val kotlinVersion = "2.2.20"`
	`7`	`+ kotlin("jvm") version kotlinVersion`
	`8`	`+ kotlin("plugin.dataframe") version kotlinVersion`
`7`	`9`	`}`
`8`	`10`
`9`	`11`	`group = "org.example"`
`@@ -15,7 +17,7 @@ repositories {`
`15`	`17`	`}`
`16`	`18`
`17`	`19`	`dependencies {`
`18`		`- implementation("org.jetbrains.kotlinx:dataframe:1.0.0-Beta2")`
	`20`	`+ implementation("org.jetbrains.kotlinx:dataframe:1.0.0-Beta3")`
`19`	`21`	`testImplementation(kotlin("test"))`
`20`	`22`	`}`
`21`	`23`