You're Invited:Meet the Socket Team at BlackHat and DEF CON in Las Vegas, Aug 7-8.RSVP
Socket
Socket
Sign inDemoInstall

net.mamoe.yamlkt:yamlkt-tvosarm64

Package Overview
Dependencies
0
Maintainers
1
Alerts
File Explorer

Advanced tools

Install Socket

Detect and block malicious and high-risk dependencies

Install

net.mamoe.yamlkt:yamlkt-tvosarm64

Multiplatform YAML parser & serializer for kotlinx.serialization written in pure Kotlin.


Version published
Maintainers
1

Readme

Source

YamlKt

Gradle CI Download

Fast multi-platform YAML with comments support for kotlinx.serialization

This project is in alpha state.

Setup

Third-party formats for kotlinx.serialization is strongly dependent on the versions of kotlinx-serialization-core and Kotlin compiler.

The table below shows recommended version parings. Note that normally you may use higher versions within the minor version range, e.g. preferring 1.3.3 or 1.3.0 over 1.3.2.

yamlktKotlinkotlinx-serialization-core
0.3.31.3.700.20.0
0.5.31.4.01.0.0-RC
0.6.01.4.101.0.0-RC2
0.8.01.4.101.0.1
0.9.01.4.301.1.0-RC
0.10.21.5.201.2.1
0.10.21.5.311.3.0
0.11.01.6.211.3.3
0.12.01.6.211.3.3
0.12.01.7.101.3.3
Gradle
repositories {
    mavenCentral()
}
dependencies {
    implementation("net.mamoe.yamlkt:yamlkt:0.12.0")
}

If your project is multiplatform, you need only to add this dependency for commonMain:

commonMain {
    dependencies {
        implementation("net.mamoe.yamlkt:yamlkt:0.12.0")
    }
}
Maven

Only JVM target is available for Maven.

<dependency>
    <groupId>net.mamoe.yamlkt</groupId>
    <artifactId>yamlkt-jvm</artifactId>
    <version>0.12.0</version>
</dependency>

Overview

This library supports:

  • fast deserializing YAML text to a structured object
  • contextual and polymorphic serialization: @Contextual, @Polymorphic
  • dynamic types: YamlDynamicSerializer which works on Any
  • YamlElement wrapper classes, allowing YamlMap.getInt, YamlMap.getLong
  • comments encoding (Using annotation Comment)

The features that aren't yet supported:

  • Anchors (*, &)
  • Explicit types (e.g. !!map)
  • Multiline string (| and > are partially supported; \ is not)

Learn to use

Serialize / deserialize with compiled serializers

This approach is fastest and recommended way as the type is already provided.

@Serializable
data class Test(
    val test: String,
    val optional: String = "optional", // Having default value means optional
    val nest: Nested,
    val list: List<String>
) {
    @Serializable
    data class Nested(
        val numberCast: Int
    )
}

println(Yaml.parse(Test.serializer(), """
test: testString
nest: 
  numberCast: 0xFE
list: [str, "str2"]
"""))
Contextual serializing / deserializing

YamlKt provides a contextual serializer YamlDynamicSerializer for Any
and YamlNullDynamicSerializer for Any?

By default, YamlDynamicSerializer is installed to Any.
You can start by using @Contextual:

@Serializable
data class Test(
    val any: @Contextual Any
)

Yaml.parse(Test.serializer(), yamlText)

For input YAML text:

test: { key1: v1, key2: [v2, v3, v4] }

Alternatively, you can deserialize without any class:

val map: Map<String?, Any?> = Yaml.parseMap("""test: { key1: v1, key2: [v2, v3, v4] }""")
YamlElement

YamlElement is a type-safe way to deserialize without descriptors.

val map: YamlMap = Yaml.decodeYamlMapFromString("""test: { key1: v1, key2: [v2, v3, v4] }""")
Comments

Annotate your comments to a field(property) using @Comment:
Example:

@Serializable
data class User(
  @Comment("The name of the user")
  val name: String = "value"
)

gives yaml text:

# The name of the user
name: ""

FAQs

Package last updated on 01 May 2023

Did you know?

Socket

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap
  • Changelog

Packages

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc