v1.0.0-Beta4 · Kotlin dataframe · Discussion #1623 · GitHub

AndreiKingsley
Dec 8, 2025
Maintainer

Yes, this is another Beta release that brings us closer to the upcoming 1.0 version!
Many bugs have been fixed, a large amount of documentation has been added, and several quality-of-life improvements have been introduced.

We invite you to try this release:

Use the 1.0.0-Beta4 version in your projects.
- We also recommend trying the compiler plugin, which has received important updates.
Use the special 1.0.0-Beta4n version in Kotlin Notebook.
- The regular version still does not work with statistical functions. The n version includes a patch that resolves this issue.
- You can specify the version in the descriptor or use %useLatestDescriptors.
  If you want to include kandy, list it after dataframe:
```
%useLatestDescriptors
%use dataframe, kandy
// or
%use dataframe(1.0.0-Beta4n), kandy(0.8.3)
```
- New dataframe and kandy versions are not supported in older versions of Kotlin Jupyter kernel.
  Please use kernel version 0.16.0-736 or newer.

📚 See the Kotlin DataFrame documentation

See below for a complete list of changes in this release grouped by category.

Features

Added Map<String, Any?>.toDataRow() function by @CarloMariaProietti in adding from_map_to_data_row function #1433
Added independent FrameColumn formatting by @Jolanrensen in Independent framecol formatting #1443
Added Implicit Char to String v2 by @Jolanrensen in Implicit char to string v2 #1420
Added .none {} to DataFrame by @CarloMariaProietti in adding .none {} to DataFrame #1462
Added formatHeader by @AndreiKingsley in Format header #1459
Added move.before by @CarloMariaProietti in Add move before #1474
Added dataframe creation from rows by @CarloMariaProietti in From rows to data frame #1463
Improved duplicateRows error message by @koperagen in Improve duplicateRows error message #1494
Improved rendering of ColumnGroup by @Allex-Nik in Improve rendering of ColumnGroup #1460
Improved list.chunked() + List<List<T>>.toDataFrame for parsing .srt and similar text files by @koperagen in Improve list.chunked() + List<List<T>>.toDataFrame for parsing .srt and similar text files #1486
Refactored DataFrame JDBC API plus DataSource handling by @zaleslaw in Refactored DataFrame JDBC API plus DataSource handling #1487
Added move.toStart() keeping inside group by @CarloMariaProietti in Move to(Start) keeping inside group #1489
Added insert.before { } by @CarloMariaProietti in Add insert.before { } #1517
Added Path overloads by @AndreiKingsley in Path overloads #1563
Migrated jvm-default, fix Migrate -Xjvm-default to -jvm-default #1466 by @koperagen in Migrate jvm-default, fix #1466 #1583
Added better H2 support by @zaleslaw in The KING of Reverts #1598

Removals and Deprecations

Refactored rename, add overloads to addAll and deprecate old versions by @jetbrains-junie[bot] in [Junie]: refactor: rename add overloads to addAll and deprecate old versions #1418
Candidates for removal deprecation by @AndreiKingsley in Candidates for removal deprecation #1473
Removed unused zero/zeroOrNull by @koperagen in Remove unused zero/zeroOrNull #1550
Merged KeyValueProperty and NameValuePair by @Jolanrensen in NameValueProperty #1545

Fixes

Fixed NPE in GeoDataFrame rendering by @ileasile in Fix NPE in GeoDataFrame rendering #1446
Added loading dataframe-jupyter from core in notebooks by @Jolanrensen in Load dataframe-jupyter from core in notebooks #1415
Fixed linter by @zaleslaw in Fixing linter #1453
Fixed cumSum by @Jolanrensen in Cum sum fixes #1467
Fixed quantile by @Jolanrensen in Tiny quantile-fix #1482
Fixed .toDataFrame by @koperagen in .toDataFrame fixes #1475
Fixed DataFrameSchema.equals() including order and CompareResult.Matches by @Jolanrensen in DataFrameSchema.equals() including order and CompareResult.Matches #1505
Fixed Nothing cols by @Jolanrensen in Nothing cols fixes #1551
Removed redundant type parameter from transpose by @koperagen in Remove redundant type parameter from transpose #1553
Fixed pivot shortcuts to use PivotDsl by @Jolanrensen in Fixes pivot shortcuts to use PivotDsl #1572
Fixed bug with extracting metadata for many columns by @zaleslaw in Fixing bug with extracting metadata for many columns #1573
Added Optin experimental Instant in codegen if this type is used by @koperagen in Optin experimental Instant in codegen if this type is used #1601

Documentation and Examples

Added join docs by @AndreiKingsley in Join docs #1437
Updated dynamic XML badge in README.md by @Jolanrensen in Update dynamic XML badge in README.md #1438
Added examples and docs for Beta3 by @Jolanrensen in readying examples and docs for Beta3 #1441
Added Parquet documentation by @zaleslaw in Add Parquet documentation #1448
Enabled Compiler plugin for :samples by @Jolanrensen in Enables Compiler plugin for :samples #1456
Removed deprecated get from examples & update obsolete dataFrameOf example by @koperagen in Remove deprecated get from examples & update obsolete dataFrameOf example #1481
Updated documentation of append by @koperagen in Update documentation of append #1483
Fixed inline column/columnOf usages in split.md by @koperagen in Inline column/columnOf usages in split.md #1503
Added documentation for increasing the heap size for Kotlin Notebook by @tp-andygo in Document increasing the heap size for Kotlin Notebook #1518
Added config for https://context7.com/kotlin/dataframe by @koperagen in Add config for https://context7.com/kotlin/dataframe #1515
Added groupBy Kdocs by @AndreiKingsley in groupBy Kdocs #1533
Updated createDataFrame.md with compiler-plugin friendly examples by @koperagen in Update createDataFrame.md with compiler-plugin friendly examples #1519
Added tests for the DataSource parameter by @zaleslaw in Added tests for the DataSource parameter #1562
Added Pivot kdocs by @AndreiKingsley in Pivot kdocs #1554
Updated SetupGradle.md by @koperagen in Update SetupGradle.md #1577
Updated info about arrow module with Parquet support by @koperagen in Update info about arrow module with Parquet support #1581
Added join kdocs by @AndreiKingsley in Join kdocs #1574
Updated Guide-for-backend-SQL-developers.md by @koperagen in Update Guide-for-backend-SQL-developers.md #1580
Updated Compiler-Plugin.md by @koperagen in Update Compiler-Plugin.md #1576
Added documentation and tests for the last and lastOrNull functions by @Allex-Nik in Add documentation and tests for the last and lastOrNull functions #1561
Added documentation and tests for the first and firstOrNull functions by @Allex-Nik in Documentation and tests for the first and firstOrNull functions #1547

Compiler Plugin

Development of the compiler plugin happens in Kotlin repository: https://github.com/JetBrains/kotlin/tree/master/plugins/kotlin-dataframe. Change log only includes relevant changes in the library.

Annotated functions for df.select { extension.col("myCol") } and operation.into { "str" } syntax by @koperagen in Annotate functions for df.select { extension.col("myCol") } and operation.into { "str" } syntax #1444
Annotated missed convert functions for compiler plugin support by @koperagen in Annotate missed convert functions for compiler plugin support #1447
Added GroupBy statistics to compiler plugin by @Jolanrensen in GroupBy statistics compiler plugin prep #1485
Annotated String.invoke, addAll(dataframes), AddDsl.unaryPlus by @koperagen in Annotate String.invoke, addAll(dataframes), AddDsl.unaryPlus #1484
Added annotation IntellijPluginApi to mark API used by KDF plugin by @Allex-Nik in Add annotation IntellijPluginApi to mark API used by KDF plugin #1440
Added annotations for moveTo() to add compiler plugin support by @Jolanrensen in added annotations for moveTo() to add compiler plugin support #1499
Excluded libraries.json from compiler-plugin-core by @koperagen in Exclude libraries.json from compiler-plugin-core #1521
Excluded some unused classes to reduce plugin size by @koperagen in Exclude some unused classes to reduce plugin size #1506

New Contributors

@CarloMariaProietti made their first contribution in adding from_map_to_data_row function #1433
@Allex-Nik made their first contribution in Add annotation IntellijPluginApi to mark API used by KDF plugin #1440
@tp-andygo made their first contribution in Document increasing the heap size for Kotlin Notebook #1518

Full Changelog: v1.0.0-Beta3...v1.0.0-Beta4

This discussion was created from the release v1.0.0-Beta4.

Replies: 0 comments

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment