tree: 2506c56d0bf29bf9a780d441ecd71ab7c7ee58aa [path history] [tgz]
  1. cbor/
  2. hocon/
  3. json/
  4. json-okio/
  5. json-tests/
  6. properties/
  7. protobuf/
  8. README.md
formats/README.md

Serialization formats

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.

FormatArtifact idPlatformStatusNotes
JSONkotlinx-serialization-jsonall supported platformsstable
JSON-Okiokotlinx-serialization-json-okioall supported by Okio platformsexperimentalExtensions on Json for integration with Okio library.
HOCONkotlinx-serialization-hoconJVM onlyexperimentalAllows 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.
ProtoBufkotlinx-serialization-protobufall supported platformsexperimental
CBORkotlinx-serialization-cborall supported platformsexperimental
Propertieskotlinx-serialization-propertiesall supported platformsexperimentalAllows converting arbitrary hierarchy of Kotlin classes to a flat key-value structure à la Java Properties.

Other community-supported formats

FormatGitHub repo and ArtifactPlatformNotes
Avrosksamuel/avro4k
com.sksamuel.avro4k:avro4k
JVM onlyThis 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.
Bsonjershell/kbson
com.github.jershell:kbson
JVM onlyAllows serialization and deserialization of objects to and from BSON.
TOMLakuleshov7/ktoml
com.akuleshov7:ktoml-core
all supported platformsFully 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 NBTBenWoodworth/knbt
net.benwoodworth.knbt:knbt
all supported platformsImplements the NBT format for kotlinx.serialization, and provides a type-safe DSL for constructing NBT tags.
MsgPackesensar/kotlinx-serialization-msgpack
com.ensarsarajcic.kotlinx:serialization-msgpack
all supported platformsAllows serialization and deserialization of objects to and from MsgPack.
SharedPreferencesEdwarDDay/serialization.kprefs
net.edwardday.serialization:kprefs
Android onlyThis library allows serialization and deserialization of objects into and from Android SharedPreferences.
XMLpdvrieze/xmlutil
io.github.pdvrieze.xmlutil:serialization
all supported platformsThis 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.
YAMLcharleskorn/kaml
com.charleskorn.kaml:kaml
JVM onlyAllows serialization and deserialization of objects to and from YAML.
YAMLhim188/yamlkt
net.mamoe.yamlkt:yamlkt
all supported platformsAllows 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.
CBORL-Briand/obor
net.orandja.obor:obor
JVM, AndroidAllow serialization and deserialization of objects to and from CBOR. This codec can be used to read and write from Java InputStream and OutputStream.
Amazon Ion (binary only)dimitark/kotlinx-serialization-ion
com.github.dimitark:kotlinx-serialization-ion
JVM onlyAllow 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.BundleAhmedMourad0/bundlizer
dev.ahmedmourad.bundlizer:bundlizer-core
AndroidAllow serialization and deserialization of objects to and from android.os.Bundle.
CSVhfhbd/kotlinx-serialization-csv
app.softwork:kotlinx-serialization-csv
all supported platformsAllows serialization and deserialization of CSV files. There are still some limitations (ordered properties).
Fixed Length Formathfhbd/kotlinx-serialization-csv
app.softwork:kotlinx-serialization-flf
all supported platformsAllows 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.
JSON5xn32/json5k
io.github.xn32:json5k
JVM, NativeLibrary for the serialization to and deserialization from JSON5 text.