Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/kantis/ks3
KotlinX Serialization Standard Serializers (KS3)
https://github.com/kantis/ks3
Last synced: about 2 months ago
JSON representation
KotlinX Serialization Standard Serializers (KS3)
- Host: GitHub
- URL: https://github.com/kantis/ks3
- Owner: Kantis
- License: apache-2.0
- Created: 2022-10-22T12:26:51.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2024-09-10T15:42:26.000Z (4 months ago)
- Last Synced: 2024-09-10T17:28:49.181Z (4 months ago)
- Language: Kotlin
- Size: 1.04 MB
- Stars: 19
- Watchers: 3
- Forks: 4
- Open Issues: 20
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
# KotlinX Serialization Standard Serializers (KS3)
This project aims to provide a set of serializers for common types, as well as provide [utilities](/doc/builders.md) to make it more convenient to build custom serializers for your needs.
> ⚠️ Consider this project to be in [Beta](https://kotlinlang.org/docs/components-stability.html) for the time being. The project has had
> no need to perform any breaking changes so far. We would be happy for you to use it, and appreciate your feedback, but we can't guarantee
> that APIs won't change.
## Contributing
See the contribution guide [here](CONTRIBUTING.md).
## Getting started
Add the dependency. With Gradle:
```kotlin
dependencies {
implementation("io.ks3:ks3-jdk:0.6.0")
}
```
Maven:
```xml
io.ks3
ks3-jdk-jvm
0.6.0
```
> Note that when using Maven dependencies must specify the multiplatform variant. For example, append `-jvm` to specify the JVM variant of `ks3-jdk`.
Now you can start using the provided serializers. There's several possible ways to do this.
* Using [contextual serialization](https://github.com/Kotlin/kotlinx.serialization/blob/1.4.1-release/docs/serializers.md#contextual-serialization)
* [Passing a serializer manually](https://github.com/Kotlin/kotlinx.serialization/blob/1.4.1-release/docs/serializers.md#passing-a-serializer-manually)
* [Specifying serializer on a property](https://github.com/Kotlin/kotlinx.serialization/blob/1.4.1-release/docs/serializers.md#specifying-serializer-on-a-property)
* [Specifying serializers for a file](https://github.com/Kotlin/kotlinx.serialization/blob/1.4.1-release/docs/serializers.md#specifying-serializers-for-a-file)
* [Specifying serializer using a typealias](https://github.com/Kotlin/kotlinx.serialization/blob/1.4.1-release/docs/serializers.md#specifying-serializer-globally-using-typealias)
### Using `typealias`
```kotlin
typealias LocalDateTimeAsString = @Serializable(LocalDateTimeAsStringSerializer::class) LocalDateTime
data class Appointment(
val datetime: LocalDateTimeAsString
)
```
> For details, see the [kotlinx.serialization guide](https://github.com/Kotlin/kotlinx.serialization/blob/1.4.1-release/docs/serializers.md#specifying-serializer-globally-using-typealias)
This method is most useful when you want to use different serial formats for the same type, or when you can't configure the serializer itself.
### Using `@Contextual`
> See the details in [kotlinx.serialization guide](https://github.com/Kotlin/kotlinx.serialization/blob/1.4.1-release/docs/serializers.md#contextual-serialization)
```kotlin
@Serializable
class ProgrammingLanguage(
val name: String,
@Contextual
val stableReleaseDate: Date
)
private val module = SerializersModule {
contextual(DateAsLongSerializer)
}
val format = Json { serializersModule = module }
```