Lightweight library for querying and transforming JSON data with a fluent, composable API. Enables nested path traversal, property selection, array slicing, filtering, and data aggregation.
A lightweight Kotlin library for querying and transforming JSON data using a fluent, composable API. ✨
implementation("io.github.lexa-diky:json-query:0.6.0")
val json = Json.parseToJsonElement(File().readText())
println(json.query { path() })
println(json.query { path()[].path() })
println(json.query { path() })
println(json.query())
println(json.query { path() })
println(json.query { path() })
println(json.query { path().filterT<String> { it.startsWith() } })
println(json.query { path()[].path() })
queryAsYou can use queryAs to directly convert the result of a query to a Kotlin type using kotlinx.serialization:
// Get a list of cat names as List<String>
val names = json.queryAs<List<String>> { path("shelter.cats.name") }
// Get a single age as Int
val age = json.queryAs<Int> { path("shelter.cats.1.age") }
json-query-kt is designed to be efficient and fast, it beats standard kotlinx-serialization object mapping in most
cases, especially for large datasets and/or complex serialization logic.
path("a.b.c")path("a.*.b")path("arr")[2], path("arr")[0..2], or dot form path("arr.2")path("a|b") chooses the first existing key.path("a&b") returns only those keys if all exist; otherwise returns JsonNull.
path("a&b.x") applies .x to both a and b and returns an object with results per key.// Statistical operations
println(json.query { path("shelter.cats.age").max() })
println(json.query { path("shelter.cats.age").min() })
println(json.query { path("shelter.cats.age").average() })
println(json.query { path("shelter.cats.age").sum() })
println(json.query { path("shelter.cats.age").first() })
println(json.query { path("shelter.cats.age").last() })
println(json.query { path("shelter.cats.age").distinct() })
println(json.query { path("shelter.cats.age").filterT<Int> { it >= 2 }.size() })
// Selecting specific fields
println(json.query { path("shelter.cats.0").select("name", "age") })
println(json.query { path("shelter.cats").select("name", "age") })
// Aggregating data into objects
println(json.query {
path("shelter.cats").qmap {
buildJsonObject {
put("names", query { path("name") })
put("ages", query { path("age") })
}
}
})
// Applying a query to each element in an array
println(json.query {
path("shelter.cats.name")
.each { mapT<String, String> { it.uppercase() } }
})
Surfaced from shared tags and platforms — no rankings paid for.