Prepare RC2 release (#1087)

Update to Kotlin 1.4.10

Author: sandwwraith

CHANGELOG.md

@@ -1,3 +1,55 @@
+1.0.0-RC2 / 2020-09-21
+==================
+
+Second release candidate for 1.0.0 version. This RC contains tweaks and changes based on users feedback after 1.0.0-RC.
+
+### Major changes
+
+* JSON format is now located in different artifact (#994)
+
+In 1.0.0-RC, the `kotlinx-serialization-core` artifact contained core serialization entities as well as `Json` serial format.
+We've decided to change that and to make `core` format-agnostic.
+It would make the life easier for those who use other serial formats and also make possible to write your own implementation of JSON
+or another format without unnecessary dependency on the default one.
+
+In 1.0.0-RC2, `Json` class and related entities are located in `kotlinx-serialization-json` artifact.
+To migrate, simply replace `kotlinx-serialization-core` dependency with `-json`. Core library then will be included automatically
+as the transitive dependency.
+
+For most use-cases, you should use new `kotlinx-serialization-json` artifact. Use `kotlinx-serialization-core` if you are
+writing a library that depends on kotlinx.serialization in a format-agnostic way of provides its own serial format.
+
+* `encodeDefaults` flag is now set to `false` in the default configuration for JSON, CBOR and Protocol Buffers.
+
+The change is motivated by the fact that in most real-life scenarios, this flag is set to `false` anyway,
+because such configuration reduces visual clutter and saves amount of data being serialized. 
+Other libraries, like GSON and Moshi, also have this behavior by default.
+
+This may change how your serialized data looks like, if you have not set value for `encodeDefaults` flag explicitly.
+We anticipate that most users already had done this, so no migration is required.
+In case you need to return to the old behavior, simply add `encodeDefaults = true` to your configuration while creating `Json/Cbor/ProtoBuf` object.
+
+* Move `Json.encodeToDynamic/Json.decodeFromDynamic` functions to json package
+
+Since these functions are no longer exposed via `DynamicObjectParser/Serializer` and they are now `Json` class extensions,
+they should be moved to `kotlinx.serialization.json` package.
+To migrate, simply add `import kotlinx.serialization.json.*` to your files.
+
+
+### Bugfixes and improvements
+
+  * Do not provide default implementation for serializersModule in AbstractEncoder/Decoder (#1089)
+  * Support JsonElement hierarchy in `dynamic` encoding/decoding (#1080)
+  * Support top-level primitives and primitive map keys in `dynamic` encoding/decoding
+  * Change core annotations retention (#1083)
+  * Fix 'Duplicate class ... found in modules' on Gradle != 6.1.1 (#996)
+  * Various documentation clarifications
+  * Support deserialization of top-level nullable types (#1038)
+  * Make most serialization exceptions eligible for coroutines exception recovery (#1054)
+  * Get rid of methods that do not present in Android API<24 (#1013, #1040)
+  * Throw JsonDecodingException on empty string literal at the end of the input (#1011)
+  * Remove new lines in deprecation warnings that caused errors in ObjC interop (#990)
+
 1.0.0-RC / 2020-08-17
 ==================
 

README.md

@@ -3,7 +3,7 @@
 [![official JetBrains project](https://jb.gg/badges/official.svg)](https://confluence.jetbrains.com/display/ALL/JetBrains+on+GitHub)
 [![GitHub license](https://img.shields.io/badge/license-Apache%20License%202.0-blue.svg?style=flat)](http://www.apache.org/licenses/LICENSE-2.0)
 [![TeamCity build](https://img.shields.io/teamcity/http/teamcity.jetbrains.com/s/KotlinTools_KotlinxSerialization_Ko.svg)](https://teamcity.jetbrains.com/viewType.html?buildTypeId=KotlinTools_KotlinxSerialization_Ko&guest=1)
-[![Download](https://api.bintray.com/packages/kotlin/kotlinx/kotlinx.serialization.runtime/images/download.svg?version=1.0.0-RC) ](https://bintray.com/kotlin/kotlinx/kotlinx.serialization.runtime/1.0.0-RC)
+[![Download](https://api.bintray.com/packages/kotlin/kotlinx/kotlinx.serialization.runtime/images/download.svg?version=1.0.0-RC2) ](https://bintray.com/kotlin/kotlinx/kotlinx.serialization.runtime/1.0.0-RC2)
 
 Kotlin serialization consists of a compiler plugin, that generates visitor code for serializable classes,
  runtime library with core serialization API and support libraries with various serialization formats.
@@ -79,17 +79,17 @@ Kotlin DSL:
 
 ```kotlin
 plugins {
-    kotlin("jvm") version "1.4.0" // or kotlin("multiplatform") or any other kotlin plugin
-    kotlin("plugin.serialization") version "1.4.0"
+    kotlin("jvm") version "1.4.10" // or kotlin("multiplatform") or any other kotlin plugin
+    kotlin("plugin.serialization") version "1.4.10"
 }
 ```       
 
 Groovy DSL:
 
 ```gradle
 plugins {
-    id 'org.jetbrains.kotlin.multiplatform' version '1.4.0'
-    id 'org.jetbrains.kotlin.plugin.serialization' version '1.4.0'
+    id 'org.jetbrains.kotlin.multiplatform' version '1.4.10'
+    id 'org.jetbrains.kotlin.plugin.serialization' version '1.4.10'
 }
 ```
 
@@ -106,7 +106,7 @@ buildscript {
     repositories { jcenter() }
 
     dependencies {
-        val kotlinVersion = "1.4.0"
+        val kotlinVersion = "1.4.10"
         classpath(kotlin("gradle-plugin", version = kotlinVersion))
         classpath(kotlin("serialization", version = kotlinVersion))
     }
@@ -117,7 +117,7 @@ Groovy DSL:
 
 ```gradle
 buildscript {
-    ext.kotlin_version = '1.4.0'
+    ext.kotlin_version = '1.4.10'
     repositories { jcenter() }
 
     dependencies {
@@ -147,7 +147,7 @@ repositories {
 
 dependencies {
     implementation(kotlin("stdlib", KotlinCompilerVersion.VERSION)) // or "stdlib-jdk8"
-    implementation("org.jetbrains.kotlinx:kotlinx-serialization-json:1.0.0-RC") // JVM dependency
+    implementation("org.jetbrains.kotlinx:kotlinx-serialization-json:1.0.0-RC2") // JVM dependency
 }
 ```
 
@@ -160,7 +160,7 @@ repositories {
 
 dependencies {
     implementation "org.jetbrains.kotlin:kotlin-stdlib:$kotlin_version" // or "kotlin-stdlib-jdk8"
-    implementation "org.jetbrains.kotlinx:kotlinx-serialization-json:1.0.0-RC" // JVM dependency
+    implementation "org.jetbrains.kotlinx:kotlinx-serialization-json:1.0.0-RC2" // JVM dependency
 }
 ```
 
@@ -205,8 +205,8 @@ Ensure the proper version of Kotlin and serialization version:
 
 ```xml
 <properties>
-    <kotlin.version>1.4.0</kotlin.version>
-    <serialization.version>1.0.0-RC</serialization.version>
+    <kotlin.version>1.4.10</kotlin.version>
+    <serialization.version>1.0.0-RC2</serialization.version>
 </properties>
 ```
 

docs/compatibility.md

@@ -6,7 +6,7 @@ Note that content of this document is applicable only for JVM platform,
 since Kotlin/Native and Kotlin/JS are experimental themselves and currently do not impose any backward-compatibility guarantees.
 
 - [Core library compatibility](#core-library-compatibility)
-  * [General (Stable) API](#general-stable-api)
+  * [General (Stable) API](#stable-api)
   * [Experimental API](#experimental-api)
   * [Internal API](#internal-api)
 - [Compatibility with Kotlin compiler plugin](#compatibility-with-kotlin-compiler-plugin)
@@ -70,7 +70,7 @@ In such a case, please create an issue on GitHub in order for us to understand a
 
 `kotlinx.serialization` also has the compiler plugin, that generates code depending on the core library.
 Therefore, the compiler plugin should be compatible with the runtime library to work.
-Kotlin & `kotlinx.serialization` plugin 1.4.0 are compatible with 1.0.0 runtime library.
+Kotlin & `kotlinx.serialization` plugin 1.4.0/1.4.10 are compatible with 1.0.0 runtime library.
 
 For further updates, we have the following policy:
 

gradle.properties

@@ -3,9 +3,9 @@
 #
 
 group=org.jetbrains.kotlinx
-version=1.0.0-RC
+version=1.0.0-RC2
 
-kotlin.version=1.4.0
+kotlin.version=1.4.10
 
 # This version take precedence if 'bootstrap' property passed to project
 kotlin.version.snapshot=1.4.255-SNAPSHOT

integration-test/gradle.properties

@@ -2,8 +2,8 @@
 # Copyright 2017-2020 JetBrains s.r.o. Use of this source code is governed by the Apache 2.0 license.
 #
 
-mainKotlinVersion=1.4.0
-mainLibVersion=1.0.0-RC
+mainKotlinVersion=1.4.10
+mainLibVersion=1.0.0-RC2
 
 kotlin.code.style=official