Skip to content

Update createDataFrame.md with compiler-plugin friendly examples #1519

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 4 commits into
base: master
Choose a base branch
from
Open

Update createDataFrame.md with compiler-plugin friendly examples #1519

Show file tree
Hide file tree
Changes from 1 commit
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
b99f562
Update createDataFrame.md with compiler-plugin friendly examples
koperagen Oct 23, 2025
27264bc
Fix single-table examples
koperagen Oct 23, 2025
b51f36a
Fix table display for remaining toDataFrame examples
koperagen Oct 23, 2025
e5fa240
Update examples to use nextInt(IntRange)
koperagen Nov 5, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Prev Previous commit
Update examples to use nextInt(IntRange)
  • Loading branch information
@koperagen
koperagen committed Nov 5, 2025
commit e5fa24004933ed728bd33e47a0d5766f1b39cd86
11 changes: 6 additions & 5 deletions core/src/test/kotlin/org/jetbrains/kotlinx/dataframe/samples/api/Create.kt
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -29,6 +29,7 @@ import org.jetbrains.kotlinx.dataframe.api.value
import org.jetbrains.kotlinx.dataframe.explainer.TransformDataFrameExpressions
import org.junit.Test
import java.io.File
import kotlin.random.nextInt
import kotlin.random.Random as KotlinRandom

class Create : TestBase() {
Expand Down Expand Up @@ -234,7 +235,7 @@ class Create : TestBase() {
"productId" from { "P${1000 + it}" }
"category" from { categories.random() }
"price" from { Random.nextDouble(10.0, 500.0) }
"inStock" from { Random.nextInt(0, 100) }
"inStock" from { Random.nextInt(0..100) }
}
// SampleEnd
}
Expand All @@ -257,14 +258,14 @@ class Create : TestBase() {
// Column Group
"manufacturer" {
"country" from { listOf("USA", "China", "Germany", "Japan").random() }
"yearEstablished" from { Random.nextInt(1950, 2020) }
"yearEstablished" from { Random.nextInt(1950..2020) }
}

// Frame Column
"reviews" from {
val reviewCount = Random.nextInt(0, 8)
val reviewCount = Random.nextInt(0..7)
(0 until reviewCount).toDataFrame {
val ratings: DataColumn<Int> = expr { Random.nextInt(1, 6) }
val ratings: DataColumn<Int> = expr { Random.nextInt(1..5) }
val comments = ratings.map {
when (it) {
5 -> listOf("Amazing quality!", "Best purchase ever!", "Highly recommend!", "Absolutely perfect!")
Expand All @@ -275,7 +276,7 @@ class Create : TestBase() {
}.random()
}

"author" from { "User${Random.nextInt(1000, 9999)}" }
"author" from { "User${Random.nextInt(1000..10000)}" }
ratings into "rating"
comments into "comment"
}
Expand Down
18 changes: 9 additions & 9 deletions ...ppets/org.jetbrains.kotlinx.dataframe.samples.api.Create.createNestedRandomDataFrame.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -565,56 +565,56 @@
{ name: "<span title=\"category: String\">category</span>", children: [], rightAlign: false, values: ["Clothing","Electronics","Clothing","Clothing","Books","Electronics","Books"] },
{ name: "<span title=\"price: Double\">price</span>", children: [], rightAlign: true, values: ["<span class=\"formatted\" title=\"\"><span class=\"numbers\">489.054329</span></span>","<span class=\"formatted\" title=\"\"><span class=\"numbers\">41.332037</span></span>","<span class=\"formatted\" title=\"\"><span class=\"numbers\">339.555785</span></span>","<span class=\"formatted\" title=\"\"><span class=\"numbers\">367.194829</span></span>","<span class=\"formatted\" title=\"\"><span class=\"numbers\">471.963710</span></span>","<span class=\"formatted\" title=\"\"><span class=\"numbers\">65.576163</span></span>","<span class=\"formatted\" title=\"\"><span class=\"numbers\">103.849144</span></span>"] },
{ name: "<span title=\"country: String\">country</span>", children: [], rightAlign: false, values: ["China","Japan","China","China","China","China","Germany"] },
{ name: "<span title=\"yearEstablished: Int\">yearEstablished</span>", children: [], rightAlign: true, values: ["<span class=\"formatted\" title=\"\"><span class=\"numbers\">1986</span></span>","<span class=\"formatted\" title=\"\"><span class=\"numbers\">1986</span></span>","<span class=\"formatted\" title=\"\"><span class=\"numbers\">2006</span></span>","<span class=\"formatted\" title=\"\"><span class=\"numbers\">1981</span></span>","<span class=\"formatted\" title=\"\"><span class=\"numbers\">2015</span></span>","<span class=\"formatted\" title=\"\"><span class=\"numbers\">2008</span></span>","<span class=\"formatted\" title=\"\"><span class=\"numbers\">1987</span></span>"] },
{ name: "<span title=\"manufacturer: DataRow<*>\">manufacturer</span>", children: [3, 4], rightAlign: false, values: ["<span class=\"formatted\" title=\"country: China\nyearEstablished: 1986\"><span class=\"structural\">{ </span><span class=\"structural\">country: </span>China<span class=\"structural\">, </span><span class=\"structural\">yearEstablished: </span><span class=\"numbers\"><span class=\"structural\">...</span></span><span class=\"structural\"> }</span></span>","<span class=\"formatted\" title=\"country: Japan\nyearEstablished: 1986\"><span class=\"structural\">{ </span><span class=\"structural\">country: </span>Japan<span class=\"structural\">, </span><span class=\"structural\">yearEstablished: </span><span class=\"numbers\"><span class=\"structural\">...</span></span><span class=\"structural\"> }</span></span>","<span class=\"formatted\" title=\"country: China\nyearEstablished: 2006\"><span class=\"structural\">{ </span><span class=\"structural\">country: </span>China<span class=\"structural\">, </span><span class=\"structural\">yearEstablished: </span><span class=\"numbers\"><span class=\"structural\">...</span></span><span class=\"structural\"> }</span></span>","<span class=\"formatted\" title=\"country: China\nyearEstablished: 1981\"><span class=\"structural\">{ </span><span class=\"structural\">country: </span>China<span class=\"structural\">, </span><span class=\"structural\">yearEstablished: </span><span class=\"numbers\"><span class=\"structural\">...</span></span><span class=\"structural\"> }</span></span>","<span class=\"formatted\" title=\"country: China\nyearEstablished: 2015\"><span class=\"structural\">{ </span><span class=\"structural\">country: </span>China<span class=\"structural\">, </span><span class=\"structural\">yearEstablished: </span><span class=\"numbers\"><span class=\"structural\">...</span></span><span class=\"structural\"> }</span></span>","<span class=\"formatted\" title=\"country: China\nyearEstablished: 2008\"><span class=\"structural\">{ </span><span class=\"structural\">country: </span>China<span class=\"structural\">, </span><span class=\"structural\">yearEstablished: </span><span class=\"numbers\"><span class=\"structural\">...</span></span><span class=\"structural\"> }</span></span>","<span class=\"formatted\" title=\"country: Germany\nyearEstablished: 1987\"><span class=\"structural\">{ </span><span class=\"structural\">country: </span>Germany<span class=\"structural\">, </span><span class=\"structural\">yearEstablished...</span><span class=\"structural\"> }</span></span>"] },
{ name: "<span title=\"yearEstablished: Int\">yearEstablished</span>", children: [], rightAlign: true, values: ["<span class=\"formatted\" title=\"\"><span class=\"numbers\">1951</span></span>","<span class=\"formatted\" title=\"\"><span class=\"numbers\">1998</span></span>","<span class=\"formatted\" title=\"\"><span class=\"numbers\">2012</span></span>","<span class=\"formatted\" title=\"\"><span class=\"numbers\">1972</span></span>","<span class=\"formatted\" title=\"\"><span class=\"numbers\">1984</span></span>","<span class=\"formatted\" title=\"\"><span class=\"numbers\">1997</span></span>","<span class=\"formatted\" title=\"\"><span class=\"numbers\">1995</span></span>"] },
{ name: "<span title=\"manufacturer: DataRow<*>\">manufacturer</span>", children: [3, 4], rightAlign: false, values: ["<span class=\"formatted\" title=\"country: China\nyearEstablished: 1951\"><span class=\"structural\">{ </span><span class=\"structural\">country: </span>China<span class=\"structural\">, </span><span class=\"structural\">yearEstablished: </span><span class=\"numbers\"><span class=\"structural\">...</span></span><span class=\"structural\"> }</span></span>","<span class=\"formatted\" title=\"country: Japan\nyearEstablished: 1998\"><span class=\"structural\">{ </span><span class=\"structural\">country: </span>Japan<span class=\"structural\">, </span><span class=\"structural\">yearEstablished: </span><span class=\"numbers\"><span class=\"structural\">...</span></span><span class=\"structural\"> }</span></span>","<span class=\"formatted\" title=\"country: China\nyearEstablished: 2012\"><span class=\"structural\">{ </span><span class=\"structural\">country: </span>China<span class=\"structural\">, </span><span class=\"structural\">yearEstablished: </span><span class=\"numbers\"><span class=\"structural\">...</span></span><span class=\"structural\"> }</span></span>","<span class=\"formatted\" title=\"country: China\nyearEstablished: 1972\"><span class=\"structural\">{ </span><span class=\"structural\">country: </span>China<span class=\"structural\">, </span><span class=\"structural\">yearEstablished: </span><span class=\"numbers\"><span class=\"structural\">...</span></span><span class=\"structural\"> }</span></span>","<span class=\"formatted\" title=\"country: China\nyearEstablished: 1984\"><span class=\"structural\">{ </span><span class=\"structural\">country: </span>China<span class=\"structural\">, </span><span class=\"structural\">yearEstablished: </span><span class=\"numbers\"><span class=\"structural\">...</span></span><span class=\"structural\"> }</span></span>","<span class=\"formatted\" title=\"country: China\nyearEstablished: 1997\"><span class=\"structural\">{ </span><span class=\"structural\">country: </span>China<span class=\"structural\">, </span><span class=\"structural\">yearEstablished: </span><span class=\"numbers\"><span class=\"structural\">...</span></span><span class=\"structural\"> }</span></span>","<span class=\"formatted\" title=\"country: Germany\nyearEstablished: 1995\"><span class=\"structural\">{ </span><span class=\"structural\">country: </span>Germany<span class=\"structural\">, </span><span class=\"structural\">yearEstablished...</span><span class=\"structural\"> }</span></span>"] },
{ name: "<span title=\"reviews: DataFrame<*>\">reviews</span>", children: [], rightAlign: false, values: [{ frameId: 1, value: "<b>DataFrame 7 x 3</b>" },{ frameId: 2, value: "<b>DataFrame 1 x 3</b>" },{ frameId: 3, value: "<b>DataFrame 3 x 3</b>" },{ frameId: 4, value: "<b>DataFrame 1 x 3</b>" },{ frameId: 5, value: "<b>DataFrame 1 x 3</b>" },{ frameId: 6, value: "<b>DataFrame 5 x 3</b>" },{ frameId: 7, value: "<b>DataFrame 4 x 3</b>" }] },
], id: 0, rootId: 0, totalRows: 7 } ) });
/*-->*/

/*<!--*/
call_DataFrame(function() { DataFrame.addTable({ cols: [{ name: "<span title=\"author: String\">author</span>", children: [], rightAlign: false, values: ["User7057","User5075","User2452","User3109","User5943"] },
call_DataFrame(function() { DataFrame.addTable({ cols: [{ name: "<span title=\"author: String\">author</span>", children: [], rightAlign: false, values: ["User2982","User3295","User2521","User8279","User4899"] },
{ name: "<span title=\"rating: Int\">rating</span>", children: [], rightAlign: true, values: ["<span class=\"formatted\" title=\"\"><span class=\"numbers\">3</span></span>","<span class=\"formatted\" title=\"\"><span class=\"numbers\">2</span></span>","<span class=\"formatted\" title=\"\"><span class=\"numbers\">3</span></span>","<span class=\"formatted\" title=\"\"><span class=\"numbers\">2</span></span>","<span class=\"formatted\" title=\"\"><span class=\"numbers\">1</span></span>"] },
{ name: "<span title=\"comment: String\">comment</span>", children: [], rightAlign: false, values: ["It&#39;s okay","Not what I expected","Neither good nor bad","Not what I expected","Not worth the price"] },
], id: 1, rootId: 0, totalRows: 7 } ) });
/*-->*/

/*<!--*/
call_DataFrame(function() { DataFrame.addTable({ cols: [{ name: "<span title=\"author: String\">author</span>", children: [], rightAlign: false, values: ["User1785"] },
call_DataFrame(function() { DataFrame.addTable({ cols: [{ name: "<span title=\"author: String\">author</span>", children: [], rightAlign: false, values: ["User5188"] },
{ name: "<span title=\"rating: Int\">rating</span>", children: [], rightAlign: true, values: ["<span class=\"formatted\" title=\"\"><span class=\"numbers\">1</span></span>"] },
{ name: "<span title=\"comment: String\">comment</span>", children: [], rightAlign: false, values: ["Do not buy!"] },
], id: 2, rootId: 0, totalRows: 1 } ) });
/*-->*/

/*<!--*/
call_DataFrame(function() { DataFrame.addTable({ cols: [{ name: "<span title=\"author: String\">author</span>", children: [], rightAlign: false, values: ["User4747","User9875","User9571"] },
call_DataFrame(function() { DataFrame.addTable({ cols: [{ name: "<span title=\"author: String\">author</span>", children: [], rightAlign: false, values: ["User7766","User5615","User5972"] },
{ name: "<span title=\"rating: Int\">rating</span>", children: [], rightAlign: true, values: ["<span class=\"formatted\" title=\"\"><span class=\"numbers\">3</span></span>","<span class=\"formatted\" title=\"\"><span class=\"numbers\">4</span></span>","<span class=\"formatted\" title=\"\"><span class=\"numbers\">5</span></span>"] },
{ name: "<span title=\"comment: String\">comment</span>", children: [], rightAlign: false, values: ["Neither good nor bad","Good value for money","Highly recommend!"] },
], id: 3, rootId: 0, totalRows: 3 } ) });
/*-->*/

/*<!--*/
call_DataFrame(function() { DataFrame.addTable({ cols: [{ name: "<span title=\"author: String\">author</span>", children: [], rightAlign: false, values: ["User6432"] },
call_DataFrame(function() { DataFrame.addTable({ cols: [{ name: "<span title=\"author: String\">author</span>", children: [], rightAlign: false, values: ["User9297"] },
{ name: "<span title=\"rating: Int\">rating</span>", children: [], rightAlign: true, values: ["<span class=\"formatted\" title=\"\"><span class=\"numbers\">5</span></span>"] },
{ name: "<span title=\"comment: String\">comment</span>", children: [], rightAlign: false, values: ["Absolutely perfect!"] },
], id: 4, rootId: 0, totalRows: 1 } ) });
/*-->*/

/*<!--*/
call_DataFrame(function() { DataFrame.addTable({ cols: [{ name: "<span title=\"author: String\">author</span>", children: [], rightAlign: false, values: ["User4866"] },
call_DataFrame(function() { DataFrame.addTable({ cols: [{ name: "<span title=\"author: String\">author</span>", children: [], rightAlign: false, values: ["User1263"] },
{ name: "<span title=\"rating: Int\">rating</span>", children: [], rightAlign: true, values: ["<span class=\"formatted\" title=\"\"><span class=\"numbers\">2</span></span>"] },
{ name: "<span title=\"comment: String\">comment</span>", children: [], rightAlign: false, values: ["Could be better"] },
], id: 5, rootId: 0, totalRows: 1 } ) });
/*-->*/

/*<!--*/
call_DataFrame(function() { DataFrame.addTable({ cols: [{ name: "<span title=\"author: String\">author</span>", children: [], rightAlign: false, values: ["User1534","User7569","User9979","User4586","User6700"] },
call_DataFrame(function() { DataFrame.addTable({ cols: [{ name: "<span title=\"author: String\">author</span>", children: [], rightAlign: false, values: ["User6799","User1199","User6496","User2531","User2767"] },
{ name: "<span title=\"rating: Int\">rating</span>", children: [], rightAlign: true, values: ["<span class=\"formatted\" title=\"\"><span class=\"numbers\">3</span></span>","<span class=\"formatted\" title=\"\"><span class=\"numbers\">2</span></span>","<span class=\"formatted\" title=\"\"><span class=\"numbers\">2</span></span>","<span class=\"formatted\" title=\"\"><span class=\"numbers\">2</span></span>","<span class=\"formatted\" title=\"\"><span class=\"numbers\">2</span></span>"] },
{ name: "<span title=\"comment: String\">comment</span>", children: [], rightAlign: false, values: ["Average quality","Disappointed","Could be better","Could be better","Could be better"] },
], id: 6, rootId: 0, totalRows: 5 } ) });
/*-->*/

/*<!--*/
call_DataFrame(function() { DataFrame.addTable({ cols: [{ name: "<span title=\"author: String\">author</span>", children: [], rightAlign: false, values: ["User4051","User8720","User2337","User8609"] },
call_DataFrame(function() { DataFrame.addTable({ cols: [{ name: "<span title=\"author: String\">author</span>", children: [], rightAlign: false, values: ["User2143","User7435","User7399","User6613"] },
{ name: "<span title=\"rating: Int\">rating</span>", children: [], rightAlign: true, values: ["<span class=\"formatted\" title=\"\"><span class=\"numbers\">2</span></span>","<span class=\"formatted\" title=\"\"><span class=\"numbers\">1</span></span>","<span class=\"formatted\" title=\"\"><span class=\"numbers\">5</span></span>","<span class=\"formatted\" title=\"\"><span class=\"numbers\">3</span></span>"] },
{ name: "<span title=\"comment: String\">comment</span>", children: [], rightAlign: false, values: ["Disappointed","Complete waste of money","Highly recommend!","Does the job"] },
], id: 7, rootId: 0, totalRows: 4 } ) });
Expand Down
2 changes: 1 addition & 1 deletion ...es/snippets/org.jetbrains.kotlinx.dataframe.samples.api.Create.createRandomDataFrame.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -564,7 +564,7 @@
call_DataFrame(function() { DataFrame.addTable({ cols: [{ name: "<span title=\"productId: String\">productId</span>", children: [], rightAlign: false, values: ["P1000","P1001","P1002","P1003","P1004","P1005","P1006"] },
{ name: "<span title=\"category: String\">category</span>", children: [], rightAlign: false, values: ["Clothing","Electronics","Clothing","Clothing","Books","Electronics","Books"] },
{ name: "<span title=\"price: Double\">price</span>", children: [], rightAlign: true, values: ["<span class=\"formatted\" title=\"\"><span class=\"numbers\">489.054329</span></span>","<span class=\"formatted\" title=\"\"><span class=\"numbers\">41.332037</span></span>","<span class=\"formatted\" title=\"\"><span class=\"numbers\">339.555785</span></span>","<span class=\"formatted\" title=\"\"><span class=\"numbers\">367.194829</span></span>","<span class=\"formatted\" title=\"\"><span class=\"numbers\">471.963710</span></span>","<span class=\"formatted\" title=\"\"><span class=\"numbers\">65.576163</span></span>","<span class=\"formatted\" title=\"\"><span class=\"numbers\">103.849144</span></span>"] },
{ name: "<span title=\"inStock: Int\">inStock</span>", children: [], rightAlign: true, values: ["<span class=\"formatted\" title=\"\"><span class=\"numbers\">7</span></span>","<span class=\"formatted\" title=\"\"><span class=\"numbers\">10</span></span>","<span class=\"formatted\" title=\"\"><span class=\"numbers\">51</span></span>","<span class=\"formatted\" title=\"\"><span class=\"numbers\">50</span></span>","<span class=\"formatted\" title=\"\"><span class=\"numbers\">59</span></span>","<span class=\"formatted\" title=\"\"><span class=\"numbers\">45</span></span>","<span class=\"formatted\" title=\"\"><span class=\"numbers\">42</span></span>"] },
{ name: "<span title=\"inStock: Int\">inStock</span>", children: [], rightAlign: true, values: ["<span class=\"formatted\" title=\"\"><span class=\"numbers\">79</span></span>","<span class=\"formatted\" title=\"\"><span class=\"numbers\">80</span></span>","<span class=\"formatted\" title=\"\"><span class=\"numbers\">29</span></span>","<span class=\"formatted\" title=\"\"><span class=\"numbers\">36</span></span>","<span class=\"formatted\" title=\"\"><span class=\"numbers\">18</span></span>","<span class=\"formatted\" title=\"\"><span class=\"numbers\">83</span></span>","<span class=\"formatted\" title=\"\"><span class=\"numbers\">42</span></span>"] },
], id: 0, rootId: 0, totalRows: 7 } ) });
/*-->*/

Expand Down
Loading