formats/README.md
This area of repository contains different libraries with various add-on formats which were not included in the core library.
For convenience, they have same groupId, versioning and release cycle as core library.
| Format | Artifact id | Platform | Status | Notes |
|---|---|---|---|---|
| JSON | kotlinx-serialization-json | all supported platforms | stable | |
| JSON-Okio | kotlinx-serialization-json-okio | all supported by Okio platforms | experimental | Extensions on Json for integration with Okio library. |
| HOCON | kotlinx-serialization-hocon | JVM only | experimental | Allows deserialization of Config object from popular lightbend/config library into Kotlin objects.You can learn about "Human-Optimized Config Object Notation" or HOCON from library's readme. |
| ProtoBuf | kotlinx-serialization-protobuf | all supported platforms | experimental | |
| CBOR | kotlinx-serialization-cbor | all supported platforms | experimental | |
| Properties | kotlinx-serialization-properties | all supported platforms | experimental | Allows converting arbitrary hierarchy of Kotlin classes to a flat key-value structure à la Java Properties. |
These formats are community members' projects and are not maintained by the Kotlin team. Please be advised that they are listed here for reference purposes, and some of them may be outdated.
| Format | GitHub repo and Artifact | Platform | Notes |
|---|---|---|---|
| Avro | avro-kotlin/avro4k | ||
com.github.avro-kotlin.avro4k:avro4k-core | JVM only | This library allows serialization and deserialization of objects to and from Avro. It will read and write from Avro binary or json streams or generate Avro Generic Records directly. It will also generate Avro schemas from data classes. The library allows for easy extension and overrides for custom schema formats, compatiblity with schemas defined outside out of the JVM and for types not supported out of the box. | |
| Bson | jershell/kbson | ||
com.github.jershell:kbson | JVM only | Allows serialization and deserialization of objects to and from BSON. | |
| TOML | Peanuuutz/tomlkt | ||
net.peanuuutz.tomlkt:tomlkt | all supported platforms | Multiplatform encoder and decoder for TOML 1.0.0 compliant. This library aims to provide similar API to the official JSON format (such as TomlLiteral, TomlTable), while adding TOML specific features (such as @TomlComment, @TomlMultilineString). | |
| TOML | akuleshov7/ktoml | ||
com.akuleshov7:ktoml-core | all supported platforms | Fully Native and Multiplatform Kotlin serialization library for serialization/deserialization of TOML format. This library contains no Java code and no Java dependencies and it implements multiplatform parser, decoder and encoder of TOML. | |
| Minecraft NBT | BenWoodworth/knbt | ||
net.benwoodworth.knbt:knbt | all supported platforms | Implements the NBT format for kotlinx.serialization, and provides a type-safe DSL for constructing NBT tags. | |
| MsgPack | esensar/kotlinx-serialization-msgpack | ||
com.ensarsarajcic.kotlinx:serialization-msgpack | all supported platforms | Allows serialization and deserialization of objects to and from MsgPack. | |
| SharedPreferences | EdwarDDay/serialization.kprefs | ||
net.edwardday.serialization:kprefs | Android only | This library allows serialization and deserialization of objects into and from Android SharedPreferences. | |
| XML | pdvrieze/xmlutil | ||
io.github.pdvrieze.xmlutil:serialization | all supported platforms | This library allows for reading and writing of XML documents with the serialization library. It is multiplatform, providing both a shared parser/writer for xml as well as platform-specific parsers where available. The library is designed to handle existing xml formats that use features that would not be available in other formats such as JSON. | |
| YAML | him188/yamlkt | ||
net.mamoe.yamlkt:yamlkt | all supported platforms | Allows serialization and deserialization of objects to and from YAML. Basic serial operations have been implemented, but some features such as compound keys and polymorphism are still work in progress. | |
| CBOR | L-Briand/obor | ||
net.orandja.obor:obor | all supported platforms | Allow serialization and deserialization of objects to and from CBOR. The serializer supports major type 2 byte string and custom tags. | |
| Amazon Ion (binary only) | dimitark/kotlinx-serialization-ion | ||
com.github.dimitark:kotlinx-serialization-ion | JVM only | Allow serialization and deserialization of objects to and from Amazon Ion. It stores the data in a flat binary format. Upon destialization, it retains the references between the objects. | |
| android.os.Bundle | AhmedMourad0/bundlizer | ||
dev.ahmedmourad.bundlizer:bundlizer-core | Android | Allow serialization and deserialization of objects to and from android.os.Bundle. | |
| CSV | hfhbd/kotlinx-serialization-csv | ||
app.softwork:kotlinx-serialization-csv | all supported platforms | Allows serialization and deserialization of CSV files. There are still some limitations (ordered properties). | |
| Fixed Length Format | hfhbd/kotlinx-serialization-csv-flf | ||
app.softwork:kotlinx-serialization-flf | all supported platforms | Allows serialization and deserialization of Fixed Length Format files. Each property must be annotated with @FixedLength and there are still some limitations due to missing delimiters. | |
| DynamoDB | codanbaru/DynaMap | ||
com.codanbaru.kotlin:dynamap | JVM | Allows serialization and deserialization of objects to and from AttributeValue of Amazon DynamoDB | |
| Bencoding | iseki0/kotlinx-serialization-bencoding | ||
space.iseki.bencoding:kotlinx-serialization-bencoding | all supported platforms | Allows serialization and deserialization of objects to and from Bencoding of BitTorrent. | |
| Smile | vooft/kotlinx-serialization-smile | ||
io.github.vooft:kotlinx-serialization-smile-core | all supported platforms | Allows serialization and deserialization of objects to and from Smile. | |
| PHP | jsoizo/kotlinx-serialization-php | ||
com.jsoizo:kotlinx-serialization-php | all supported platforms | Allows serialization and deserialization of objects to and from PHP Serialization. | |
| androidx.savedstate.SavedState | androidx.savedstate | ||
androidx.savedstate:savedstate-ktx | all supported platforms | SavedState 1.3.0 allows serialization and deserialization of objects to and from androidx.savedstate.SavedState, which is a typealias of android.os.Bundle on Android. | |
| JSON5 | lisonge/kotlin-json5 | ||
li.songe:json5 | all supported platforms | kotlin multiplatform json5 for kotlinx.serialization |