Skip to content
This repository has been archived by the owner on Sep 2, 2024. It is now read-only.

Update dependency org.jetbrains.kotlinx:kotlinx-serialization-json to v1.7.2 #43

Open
wants to merge 1 commit into
base: main
Choose a base branch
from

Conversation

renovate[bot]
Copy link

@renovate renovate bot commented Dec 23, 2021

This PR contains the following updates:

Package Change Age Adoption Passing Confidence
org.jetbrains.kotlinx:kotlinx-serialization-json 1.3.1 -> 1.7.2 age adoption passing confidence

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.2

==================

This release provides several new features, including a major Cbor configuration rework.
It uses Kotlin 2.0.20 by default.

Cbor feature set for COSE compliance

This change brings a lot of features to the CBOR format, namely:

  • Serial Labels — see @CborLabel annotation and preferCborLabelsOverNames flag.
  • Tagging of keys and values — see encode*Tags and verify*Tags set of flags
  • Definite length encoding — see useDefiniteLengthEncoding. This flag affects object encoding, since decoding of arrays with definite lenghts is automatically supported.
  • Option to globally prefer major type 2 for byte array encoding — see alwaysUseByteString flag.

Since there are quite a lot of flags now, they were restructured to a separate CborConfiguration class, similarly to JsonConfiguration.
It is possible to retrieve this configuration from CborEncoder/CborDecoder interfaces in your custom serializers (see their documentation for details).

All of these features make it possible to serialize and parse COSE-compliant CBOR, for example, ISO/IEC 18013-5:2021-compliant mobile driving license data.
In case you want to make use of them, there is a predefined Cbor.CoseCompliant instance.
However, some canonicalization steps (such as sorting keys) still need to be performed manually.

This functionality was contributed to us by Bernd Prünster.

Keeping generated serializers

One of the most requested features for serialization plugin was to continue to generate a serializer even if a custom one is specified for the class.
It allows using a plugin-generated serializer in a fallback or delegate strategy, accessing type structure via descriptor, using default serialization behavior in inheritors that do not use custom serializers.

Starting with this release, you can specify the @KeepGeneratedSerializer annotation on the class declaration to instruct the plugin to continue generating the serializer.
In this case, the serializer will be accessible using the .generatedSerializer() function on the class's companion object.

This annotation is currently experimental. Kotlin 2.0.20 or higher is required for this feature to work.

You can check out the examples in the documentation and in the PRs: #​2758, #​2669.

Serializer for kotlin.uuid.Uuid

Kotlin 2.0.20 added a common class to represent UUIDs in a multiplatform code.
kotlinx.serialization 1.7.2 provides a corresponding Uuid.serializer() for it, making it possible to use it in @Serializable classes.
Note that for now, serializer should be provided manually with @Contextual annotation.
Plugin will be able to automatically insert Uuid serializer in Kotlin 2.1.0.

See more details in the corresponding PR.

Other bugfixes and improvements

  • Prohibited using of zero and negative field numbers in ProtoNumber (#​2766)
  • Improve readability of protobuf decoding exception messages (#​2768) (thanks to xiaozhikang0916)
  • docs(serializers): Fix grammatical errors (#​2779) (thanks to jamhour1g)
  • Fixed VerifyError after ProGuard optimization (#​2728)
  • Add wasm-wasi target to Okio integration (#​2727)

v1.7.1

==================

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.

Add integration with a kotlinx-io library

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: encodeToSink, decodeFromSource, and decodeSourceToSequence.
Check out the PR for more details.

Other bugfixes

  • Prohibited use of elements other than JsonObject in JsonTransformingSerializer with polymorphic serialization (#​2715)

v1.7.0

==================

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, 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).

v1.6.3

==================

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.
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.

Other features
Bugfixes and improvements
  • Fix: Hocon polymorphic serialization in containers (#​2151) (thanks to LichtHund)
  • Actualize lenient mode documentation (#​2568)
  • Slightly improve error messages thrown from serializer() function (#​2533)
  • Do not try to coerce input values for properties (#​2530)
  • Make empty objects and arrays collapsed in pretty print mode (#​2506)
  • Update Gradle dokka configuration to make sure "source" button is visible in all API docs (#​2518, #​2524)

v1.6.2

v1.6.1

==================

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

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.
Please remember that Kotlin/Wasm is still experimental, so changes are expected.

Bugfixes and improvements

v1.6.0

==================

This release contains all features and bugfixes from 1.6.0-RC plus some bugfixes on its own (see below).
Kotlin 1.9.0 is used as a default, while 1.9.10 is also supported.

Bugfixes

v1.5.1

==================
This release contains an important Native targets overhaul, as well as numerous enhancements and bugfixes.
Kotlin 1.8.21 is used by default.

New set of Native targets

The official Kotlin target support policy has recently been published
describing new target policy: each target belongs to a certain tier, and different tiers have different stability guarantees.
The official recommendation for library authors is to support targets up to Tier 3,
and kotlinx.serialization now follows it.
It means that in this release, there are a lot of new targets added from this tier,
such as androidNativeX86 or watchosDeviceArm64.
Note that since they belong to Tier 3, they're not auto-tested on CI.

kotlinx.serialization also ships some deprecated Kotlin/Native targets that do not belong to any tier (e.g. iosArm32, mingwX86).
We'll continue to release them, but we do not provide support for them, nor do we plan to add new targets from the deprecated list.

Improvements in Json elements

There are two new function sets that should make creating raw Json elements easier.
First one contains overloads for JsonPrimitive constructor-like function
that accept unsigned types: JsonPrimitive(1u).
Second one adds new addAll functions to JsonArrayBuilder to be used with collections
of numbers, booleans or strings: buildJsonArray { addAll(listOf(1, 2, 3)) }
Both were contributed to us by aSemy.

Other enhancements
  • Potential source-breaking change: Rename json-okio target variables to sink (#​2226)
  • Function to retrieve KSerializer by KClass and type arguments serializers (#​2291)
  • Added FormatLanguage annotation to Json methods (#​2234)
  • Properties Format: Support sealed/polymorphic classes as class properties (#​2255)
Bugfixes
  • KeyValueSerializer: Fix missing call to endStructure() (#​2272)
  • ObjectSerializer: Respect sequential decoding (#​2273)
  • Fix value class encoding in various corner cases (#​2242)
  • Fix incorrect json decoding iterator's .hasNext() behavior on array-wrapped inputs (#​2268)
  • Fix memory leak caused by invalid KTypeWrapper's equals method (#​2274)
  • Fixed NoSuchMethodError when parsing a JSON stream on Java 8 (#​2219)
  • Fix MissingFieldException duplication (#​2213)

v1.5.0

==================

This release contains all features and bugfixes from 1.5.0-RC plus some experimental features and bugfixes on its own (see below).
Kotlin 1.8.10 is used as a default.

HoconEncoder and HoconDecoder interfaces and HOCON-specific serializers

These interfaces work in a way similar to JsonEncoder and JsonDecoder: they allow intercepting (de)serialization process,
making writing if custom HOCON-specific serializers easier. New ConfigMemorySizeSerializer and JavaDurationSerializer already make use of them.
See more details in the PR.
Big thanks to Alexander Mikhailov for contributing this!

Ability to read buffered huge strings in custom Json deserializers

New interface ChunkedDecoder allows you to read huge strings that may not fit in memory by chunks.
Currently, this interface is only implemented by Json decoder that works with strings and streams,
but we may expand it later, if there's a demand for it.
See more details in the PR authored by Alexey Sviridov.

Bugfixes
  • Improve runtime exceptions messages (#​2180)
  • Added support for null values for nullable enums in lenient mode (#​2176)
  • Prevent class loaders from leaking when using ClassValue cache (#​2175)

v1.4.1

==================

This is patch release contains several bugfixes and improvements.
Kotlin 1.7.20 is used by default.

Improvements
  • Add @​MustBeDocumented to certain annotations (#​2059)
  • Deprecate .isNullable in SerialDescriptor builder (#​2040)
  • Unsigned primitives and unsigned arrays serializers can be retrieved as built-ins (#​1992)
  • Serializers are now cached inside reflective lookup, leading to faster serializer retrieval (#​2015)
  • Compiler plugin can create enum serializers using static factories for better speed (#​1851) (Kotlin 1.7.20 required)
  • Provide foundation for compiler plugin intrinsics available in Kotlin 1.8.0 (#​2031)
Bugfixes

v1.4.0

==================

This release contains all features and bugfixes from 1.4.0-RC plus some bugfixes on its own (see below).
Kotlin 1.7.10 is used as a default.

Bugfixes
  • Fixed decoding of huge JSON data for okio streams (#​2006)

v1.3.3

==================

This release contains support for Protocol Buffers packed fields, as well as several bugfixes.
It uses Kotlin 1.6.21 by default.

Protobuf packed fields

It is now possible to encode and decode Kotlin classes to/from Protobuf messages with packed repeated fields.
To mark the field as packed, use @ProtoPacked annotation on it.
Note it affects only List and primitive collection such as IntArray types.
With this feature, it is now possible to decode Proto3 messages, where all repeated fields are packed by default.
Protobuf schema generator also supports new @ProtoPacked annotation.

Many thanks to Paul de Vrieze for his valuable contribution!

Other improvements & small features
  • Incorporate JsonPath into exception messages (#​1841)
  • Mark block in corresponding encodeStructure/decodeStructure extensions as crossinline to reduce amount of bytecode (#​1917)
  • Support serialization of compile-time Collection<E> properties that are not lists at the runtime (#​1821)
  • Best-effort kotlin reflect avoidance in serializer(Type) (#​1819)
Bugfixes
  • Iterate over element indices in ObjectSerializer in order to let the format skip unknown keys (#​1916)
  • Correctly support registering both default polymorphic serializer & deserializer (#​1849)
  • Make error message for captured generic type parameters much more straightforward (#​1863)

v1.3.2

==================

This release contains several features and bugfixes for core API as well as for HOCON format.
It uses Kotlin 1.6.10 by default.

Serializing objects to HOCON

It's now possible to encode Kotlin objects to Config values with new Hocon.encodeToConfig function.
This feature may help edit existing configs inside Kotlin program or generate new ones.

Big thanks to Osip Fatkullin for implementing this.

Polymorphic default serializers

As of now, polymorphicDefault clause inside SerializersModule { } builder specifies a
fallback serializer to be used only during deserialization process. A new function has been introduced to allow setting
fallback serializer for serialization: polymorphicDefaultSerializer.
This function should ease serializing vast hierarchies of third-party or Java classes.

Note that there are two new experimental functions, polymorphicDefaultSerializer and polymorphicDefaultDeserializer.
To avoid naming confusion, we are going to deprecate polymorphicDefault in favor of polymorphicDefaultDeserializer in the next minor release (1.4.0).

Credit for the PR goes to our contributor Joseph Burton.

Other improvements
Bugfixes
  • Properly handle top-level value classes in encodeToJsonElement (#​1777)
  • Fix incorrect handling of object end when JsonTreeReader (JsonElement) is used with decodeToSequence (#​1782)

Configuration

📅 Schedule: Branch creation - At any time (no schedule defined), 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 was generated by Mend Renovate. View the repository job log.

@renovate renovate bot changed the title Update dependency org.jetbrains.kotlinx:kotlinx-serialization-json to v1.3.2 Update dependency org.jetbrains.kotlinx:kotlinx-serialization-json to v1.3.3 May 12, 2022
@renovate renovate bot force-pushed the renovate/org.jetbrains.kotlinx-kotlinx-serialization-json-1.x branch from 7bf4a30 to f175a43 Compare May 12, 2022 11:43
@renovate renovate bot force-pushed the renovate/org.jetbrains.kotlinx-kotlinx-serialization-json-1.x branch from f175a43 to b033296 Compare May 26, 2022 23:28
@renovate renovate bot changed the title Update dependency org.jetbrains.kotlinx:kotlinx-serialization-json to v1.3.3 Update dependency org.jetbrains.kotlinx:kotlinx-serialization-json to v1.4.0 Sep 25, 2022
@renovate renovate bot force-pushed the renovate/org.jetbrains.kotlinx-kotlinx-serialization-json-1.x branch from b033296 to e6f4526 Compare September 25, 2022 12:09
@renovate renovate bot force-pushed the renovate/org.jetbrains.kotlinx-kotlinx-serialization-json-1.x branch from e6f4526 to 6ed44b5 Compare November 20, 2022 18:49
@renovate renovate bot changed the title Update dependency org.jetbrains.kotlinx:kotlinx-serialization-json to v1.4.0 Update dependency org.jetbrains.kotlinx:kotlinx-serialization-json to v1.4.1 Nov 20, 2022
@renovate renovate bot changed the title Update dependency org.jetbrains.kotlinx:kotlinx-serialization-json to v1.4.1 Update dependency org.jetbrains.kotlinx:kotlinx-serialization-json to v1.5.0 Mar 17, 2023
@renovate renovate bot force-pushed the renovate/org.jetbrains.kotlinx-kotlinx-serialization-json-1.x branch from 6ed44b5 to f1e3370 Compare March 17, 2023 03:59
@renovate renovate bot changed the title Update dependency org.jetbrains.kotlinx:kotlinx-serialization-json to v1.5.0 Update dependency org.jetbrains.kotlinx:kotlinx-serialization-json to v1.5.1 Jun 1, 2023
@renovate renovate bot force-pushed the renovate/org.jetbrains.kotlinx-kotlinx-serialization-json-1.x branch from f1e3370 to 47b1298 Compare June 1, 2023 03:35
@renovate renovate bot changed the title Update dependency org.jetbrains.kotlinx:kotlinx-serialization-json to v1.5.1 Update dependency org.jetbrains.kotlinx:kotlinx-serialization-json to v1.6.0 Aug 22, 2023
@renovate renovate bot force-pushed the renovate/org.jetbrains.kotlinx-kotlinx-serialization-json-1.x branch from 47b1298 to 23d9d7e Compare August 22, 2023 20:32
@renovate renovate bot changed the title Update dependency org.jetbrains.kotlinx:kotlinx-serialization-json to v1.6.0 Update dependency org.jetbrains.kotlinx:kotlinx-serialization-json to v1.6.1 Nov 15, 2023
@renovate renovate bot force-pushed the renovate/org.jetbrains.kotlinx-kotlinx-serialization-json-1.x branch from 23d9d7e to 7f65177 Compare November 15, 2023 17:28
@renovate renovate bot changed the title Update dependency org.jetbrains.kotlinx:kotlinx-serialization-json to v1.6.1 Update dependency org.jetbrains.kotlinx:kotlinx-serialization-json to v1.6.2 Nov 30, 2023
@renovate renovate bot force-pushed the renovate/org.jetbrains.kotlinx-kotlinx-serialization-json-1.x branch from 7f65177 to 3630e02 Compare November 30, 2023 17:12
@renovate renovate bot force-pushed the renovate/org.jetbrains.kotlinx-kotlinx-serialization-json-1.x branch from 3630e02 to b48a14e Compare February 16, 2024 19:57
@renovate renovate bot changed the title Update dependency org.jetbrains.kotlinx:kotlinx-serialization-json to v1.6.2 Update dependency org.jetbrains.kotlinx:kotlinx-serialization-json to v1.6.3 Feb 16, 2024
@renovate renovate bot changed the title Update dependency org.jetbrains.kotlinx:kotlinx-serialization-json to v1.6.3 Update dependency org.jetbrains.kotlinx:kotlinx-serialization-json to v1.7.0 Jun 6, 2024
@renovate renovate bot force-pushed the renovate/org.jetbrains.kotlinx-kotlinx-serialization-json-1.x branch from b48a14e to b7b626c Compare June 6, 2024 14:08
@renovate renovate bot changed the title Update dependency org.jetbrains.kotlinx:kotlinx-serialization-json to v1.7.0 Update dependency org.jetbrains.kotlinx:kotlinx-serialization-json to v1.7.1 Jun 25, 2024
@renovate renovate bot force-pushed the renovate/org.jetbrains.kotlinx-kotlinx-serialization-json-1.x branch from b7b626c to 167e367 Compare June 25, 2024 17:11
@renovate renovate bot force-pushed the renovate/org.jetbrains.kotlinx-kotlinx-serialization-json-1.x branch from 167e367 to df1cefd Compare August 28, 2024 19:47
@renovate renovate bot changed the title Update dependency org.jetbrains.kotlinx:kotlinx-serialization-json to v1.7.1 Update dependency org.jetbrains.kotlinx:kotlinx-serialization-json to v1.7.2 Aug 28, 2024
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

0 participants