[!WARNING]
Some dependencies could not be looked up. Check the Dependency Dashboard for more information.
Release Notes
Kotlin/kotlinx.serialization (org.jetbrains.kotlinx:kotlinx-serialization-json)
### [`v1.7.1`](https://togithub.com/Kotlin/kotlinx.serialization/blob/HEAD/CHANGELOG.md#171--2024-06-25)
\==================
This is a bugfix release that aims to fix missing `kotlinx-serialization-hocon` artifact.
It also contains experimental integration with `kotlinx-io` library.
Kotlin 2.0.0 is used by default.
#### Fixed HOCON publication
Sadly, 1.7.0 release was published incomplete: `kotlinx-serialization-hocon` artifact is missing from 1.7.0 and 1.7.0-RC releases.
This release fixes this problem and now `kotlinx-serialization-hocon` is available again with 1.7.1 version.
No other changes were made to this artifact. Related ticket: [#2717](https://togithub.com/Kotlin/kotlinx.serialization/issues/2717).
#### Add integration with a kotlinx-io library
[`kotlinx-io`](https://togithub.com/Kotlin/kotlinx-io) is an official multiplatform library that provides basic IO primitives, similar to Okio.
kotlinx.serialization integration is now available in a separate artifact, located at the `kotlinx-serialization-json-io` coordinates.
Integration artifact provides functions similar to existing [Okio integration](https://kotlinlang.org/api/kotlinx.serialization/kotlinx-serialization-json-okio/kotlinx.serialization.json.okio/): `encodeToSink`, `decodeFromSource`, and `decodeSourceToSequence`.
Check out the [PR](https://togithub.com/Kotlin/kotlinx.serialization/pull/2707) for more details.
#### Other bugfixes
- Prohibited use of elements other than JsonObject in JsonTransformingSerializer with polymorphic serialization ([#2715](https://togithub.com/Kotlin/kotlinx.serialization/issues/2715))
### [`v1.7.0`](https://togithub.com/Kotlin/kotlinx.serialization/blob/HEAD/CHANGELOG.md#170--2024-06-05)
\==================
This release contains all of the changes from 1.7.0-RC and is compatible with Kotlin 2.0.
Please note that for reasons explained in the [1.7.0-RC changelog](https://togithub.com/Kotlin/kotlinx.serialization/releases/tag/v1.7.0-RC), it may not be possible to use it with the Kotlin 1.9.x
compiler plugin. Yet, it is still fully backwards compatible with previous versions.
The only difference with 1.7.0-RC is that `classDiscriminatorMode` property in `JsonBuilder` is marked as experimental,
as it should have been when it was introduced ([#2680](https://togithub.com/Kotlin/kotlinx.serialization/issues/2680)).
### [`v1.6.3`](https://togithub.com/Kotlin/kotlinx.serialization/blob/HEAD/CHANGELOG.md#163--2024-02-16)
\==================
This release provides a couple of new features and uses Kotlin 1.9.22 as default.
##### Class discriminator output mode
Class discriminator provides information for serializing and deserializing [polymorphic class hierarchies](docs/polymorphism.md#sealed-classes).
In case you want to encode more or less information for various third party APIs about types in the output, it is possible to control
addition of the class discriminator with the `JsonBuilder.classDiscriminatorMode` property.
For example, `ClassDiscriminatorMode.NONE` does not add class discriminator at all, in case the receiving party is not interested in Kotlin types.
You can learn more about this feature in the documentation and corresponding [PR](https://togithub.com/Kotlin/kotlinx.serialization/pull/2532).
##### Other features
- Add kebab-case naming strategy ([#2531](https://togithub.com/Kotlin/kotlinx.serialization/issues/2531)) (thanks to [Emil Kantis](https://togithub.com/Kantis))
- Add value class support to the ProtoBufSchemaGenerator ([#2542](https://togithub.com/Kotlin/kotlinx.serialization/issues/2542)) (thanks to [Felipe Rotilho](https://togithub.com/rotilho))
##### Bugfixes and improvements
- Fix: Hocon polymorphic serialization in containers ([#2151](https://togithub.com/Kotlin/kotlinx.serialization/issues/2151)) (thanks to [LichtHund](https://togithub.com/LichtHund))
- Actualize lenient mode documentation ([#2568](https://togithub.com/Kotlin/kotlinx.serialization/issues/2568))
- Slightly improve error messages thrown from serializer() function ([#2533](https://togithub.com/Kotlin/kotlinx.serialization/issues/2533))
- Do not try to coerce input values for properties ([#2530](https://togithub.com/Kotlin/kotlinx.serialization/issues/2530))
- Make empty objects and arrays collapsed in pretty print mode ([#2506](https://togithub.com/Kotlin/kotlinx.serialization/issues/2506))
- Update Gradle dokka configuration to make sure "source" button is visible in all API docs ([#2518](https://togithub.com/Kotlin/kotlinx.serialization/issues/2518), [#2524](https://togithub.com/Kotlin/kotlinx.serialization/issues/2524))
### [`v1.6.2`](https://togithub.com/Kotlin/kotlinx.serialization/compare/v1.6.1...v1.6.2)
### [`v1.6.1`](https://togithub.com/Kotlin/kotlinx.serialization/blob/HEAD/CHANGELOG.md#161--2023-11-15)
\==================
This release uses Kotlin 1.9.20 by default, while upcoming 1.9.21 is also supported.
##### Trailing commas in Json
Trailing commas are one of the most popular non-spec Json variations.
A new configuration flag, `allowTrailingComma`, makes Json parser accept them instead of throwing an exception.
Note that it does not affect encoding, so kotlinx.serialization always produces Json without trailing commas.
See details in the corresponding [PR](https://togithub.com/Kotlin/kotlinx.serialization/pull/2480)
##### Support of WasmJs target
Kotlin/Wasm has been experimental for some time and gained enough maturity to be added to the kotlinx libraries.
Starting with 1.6.1, kotlinx.serialization provides a wasm-js flavor, so your projects with Kotlin/Wasm can have even more
functionality.
As usual, just add serialization dependencies to your build
and [declare wasmJs target](https://kotlinlang.org/docs/whatsnew1920.html#new-wasm-wasi-target-and-the-renaming-of-the-wasm-target-to-wasm-js).
Please remember that Kotlin/Wasm is still experimental, so changes are expected.
##### Bugfixes and improvements
- Fix TaggedDecoder nullable decoding ([#2456](https://togithub.com/Kotlin/kotlinx.serialization/issues/2456)) (thanks to [Phillip Schichtel](https://togithub.com/pschichtel))
- Fix IllegalAccessException for some JPMS boundaries ([#2469](https://togithub.com/Kotlin/kotlinx.serialization/issues/2469))
- Cbor: check if inline value classes are marked as [@ByteString](https://togithub.com/ByteString) ([#2466](https://togithub.com/Kotlin/kotlinx.serialization/issues/2466)) (thanks to [eater](https://togithub.com/the-eater))
- Improve polymorphic deserialization optimization ([#2481](https://togithub.com/Kotlin/kotlinx.serialization/issues/2481))
- Update Okio dependency to 3.6.0 ([#2473](https://togithub.com/Kotlin/kotlinx.serialization/issues/2473))
- Add protobuf conformance tests ([#2404](https://togithub.com/Kotlin/kotlinx.serialization/issues/2404)) (thanks to [Doğaç Eldenk](https://togithub.com/Dogacel))
- Support decoding maps with boolean keys ([#2440](https://togithub.com/Kotlin/kotlinx.serialization/issues/2440))
Configuration
📅 Schedule: Branch creation - "every 3 months on the first day of the month" (UTC), Automerge - At any time (no schedule defined).
🚦 Automerge: Disabled by config. Please merge this manually once you are satisfied.
♻ Rebasing: Whenever PR becomes conflicted, or you tick the rebase/retry checkbox.
🔕 Ignore: Close this PR and you won't be reminded about this update again.
[ ] If you want to rebase/retry this PR, check this box
This PR has been generated by Mend Renovate. View repository job log here.
This PR contains the following updates:
1.6.0->1.7.1Release Notes
Kotlin/kotlinx.serialization (org.jetbrains.kotlinx:kotlinx-serialization-json)
### [`v1.7.1`](https://togithub.com/Kotlin/kotlinx.serialization/blob/HEAD/CHANGELOG.md#171--2024-06-25) \================== This is a bugfix release that aims to fix missing `kotlinx-serialization-hocon` artifact. It also contains experimental integration with `kotlinx-io` library. Kotlin 2.0.0 is used by default. #### Fixed HOCON publication Sadly, 1.7.0 release was published incomplete: `kotlinx-serialization-hocon` artifact is missing from 1.7.0 and 1.7.0-RC releases. This release fixes this problem and now `kotlinx-serialization-hocon` is available again with 1.7.1 version. No other changes were made to this artifact. Related ticket: [#2717](https://togithub.com/Kotlin/kotlinx.serialization/issues/2717). #### Add integration with a kotlinx-io library [`kotlinx-io`](https://togithub.com/Kotlin/kotlinx-io) is an official multiplatform library that provides basic IO primitives, similar to Okio. kotlinx.serialization integration is now available in a separate artifact, located at the `kotlinx-serialization-json-io` coordinates. Integration artifact provides functions similar to existing [Okio integration](https://kotlinlang.org/api/kotlinx.serialization/kotlinx-serialization-json-okio/kotlinx.serialization.json.okio/): `encodeToSink`, `decodeFromSource`, and `decodeSourceToSequence`. Check out the [PR](https://togithub.com/Kotlin/kotlinx.serialization/pull/2707) for more details. #### Other bugfixes - Prohibited use of elements other than JsonObject in JsonTransformingSerializer with polymorphic serialization ([#2715](https://togithub.com/Kotlin/kotlinx.serialization/issues/2715)) ### [`v1.7.0`](https://togithub.com/Kotlin/kotlinx.serialization/blob/HEAD/CHANGELOG.md#170--2024-06-05) \================== This release contains all of the changes from 1.7.0-RC and is compatible with Kotlin 2.0. Please note that for reasons explained in the [1.7.0-RC changelog](https://togithub.com/Kotlin/kotlinx.serialization/releases/tag/v1.7.0-RC), it may not be possible to use it with the Kotlin 1.9.x compiler plugin. Yet, it is still fully backwards compatible with previous versions. The only difference with 1.7.0-RC is that `classDiscriminatorMode` property in `JsonBuilder` is marked as experimental, as it should have been when it was introduced ([#2680](https://togithub.com/Kotlin/kotlinx.serialization/issues/2680)). ### [`v1.6.3`](https://togithub.com/Kotlin/kotlinx.serialization/blob/HEAD/CHANGELOG.md#163--2024-02-16) \================== This release provides a couple of new features and uses Kotlin 1.9.22 as default. ##### Class discriminator output mode Class discriminator provides information for serializing and deserializing [polymorphic class hierarchies](docs/polymorphism.md#sealed-classes). In case you want to encode more or less information for various third party APIs about types in the output, it is possible to control addition of the class discriminator with the `JsonBuilder.classDiscriminatorMode` property. For example, `ClassDiscriminatorMode.NONE` does not add class discriminator at all, in case the receiving party is not interested in Kotlin types. You can learn more about this feature in the documentation and corresponding [PR](https://togithub.com/Kotlin/kotlinx.serialization/pull/2532). ##### Other features - Add kebab-case naming strategy ([#2531](https://togithub.com/Kotlin/kotlinx.serialization/issues/2531)) (thanks to [Emil Kantis](https://togithub.com/Kantis)) - Add value class support to the ProtoBufSchemaGenerator ([#2542](https://togithub.com/Kotlin/kotlinx.serialization/issues/2542)) (thanks to [Felipe Rotilho](https://togithub.com/rotilho)) ##### Bugfixes and improvements - Fix: Hocon polymorphic serialization in containers ([#2151](https://togithub.com/Kotlin/kotlinx.serialization/issues/2151)) (thanks to [LichtHund](https://togithub.com/LichtHund)) - Actualize lenient mode documentation ([#2568](https://togithub.com/Kotlin/kotlinx.serialization/issues/2568)) - Slightly improve error messages thrown from serializerConfiguration
📅 Schedule: Branch creation - "every 3 months on the first day of the month" (UTC), Automerge - At any time (no schedule defined).
🚦 Automerge: Disabled by config. Please merge this manually once you are satisfied.
♻ Rebasing: Whenever PR becomes conflicted, or you tick the rebase/retry checkbox.
🔕 Ignore: Close this PR and you won't be reminded about this update again.
This PR has been generated by Mend Renovate. View repository job log here.