Version 1.2.0

Author: qwwdfsad

CHANGES.md

@@ -1,5 +1,21 @@
 # Change log for kotlinx.coroutines
 
+## Version 1.2.0
+
+ * Kotlin updated to 1.3.30.
+ * New API: `CancellableContinuation.resume` with `onCancelling` lambda (#1044) to consistently handle closeable resources.
+ * Play services task version updated to 16.0.1.
+ * `ReceiveChannel.isEmpty` is no longer deprecated
+
+A lot of `Flow` improvements:
+  * Purity property is renamed to context preservation and became more restrictive.
+  * `zip` and `combineLatest` operators.
+  * Integration with RxJava2
+  * `flatMap`, `merge` and `concatenate` are replaced with `flattenConcat`, `flattenMerge`, `flatMapConcat` and `flatMapMerge`.
+  * Various documentation improvements and minor bug fixes.
+  
+Note that `Flow` **is not** leaving its [preview status](/docs/compatibility.md#flow-preview-api).
+  
 ## Version 1.2.0-alpha-2
 
 This release contains major [feature preview](/docs/compatibility.md#flow-preview-api): cold streams aka `Flow` (#254). 

README.md

@@ -2,10 +2,10 @@
 
 [![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)](https://www.apache.org/licenses/LICENSE-2.0)
-[![Download](https://api.bintray.com/packages/kotlin/kotlinx/kotlinx.coroutines/images/download.svg?version=1.2.0-alpha-2) ](https://bintray.com/kotlin/kotlinx/kotlinx.coroutines/1.2.0-alpha-2)
+[![Download](https://api.bintray.com/packages/kotlin/kotlinx/kotlinx.coroutines/images/download.svg?version=1.2.0) ](https://bintray.com/kotlin/kotlinx/kotlinx.coroutines/1.2.0)
 
 Library support for Kotlin coroutines with [multiplatform](#multiplatform) support.
-This is a companion version for Kotlin `1.3.21` release.
+This is a companion version for Kotlin `1.3.30` release.
 
 ```kotlin
 GlobalScope.launch {
@@ -75,15 +75,15 @@ Add dependencies (you can also add other modules that you need):
 <dependency>
     <groupId>org.jetbrains.kotlinx</groupId>
     <artifactId>kotlinx-coroutines-core</artifactId>
-    <version>1.2.0-alpha-2</version>
+    <version>1.2.0</version>
 </dependency>
 ```
 
 And make sure that you use the latest Kotlin version:
 
 ```xml
 <properties>
-    <kotlin.version>1.3.21</kotlin.version>
+    <kotlin.version>1.3.30</kotlin.version>
 </properties>
 ```
 
@@ -93,15 +93,15 @@ Add dependencies (you can also add other modules that you need):
 
 ```groovy
 dependencies {
-    implementation 'org.jetbrains.kotlinx:kotlinx-coroutines-core:1.2.0-alpha-2'
+    implementation 'org.jetbrains.kotlinx:kotlinx-coroutines-core:1.2.0'
 }
 ```
 
 And make sure that you use the latest Kotlin version:
 
 ```groovy
 buildscript {
-    ext.kotlin_version = '1.3.21'
+    ext.kotlin_version = '1.3.30'
 }
 ```
 
@@ -119,15 +119,15 @@ Add dependencies (you can also add other modules that you need):
 
 ```groovy
 dependencies {
-    implementation("org.jetbrains.kotlinx:kotlinx-coroutines-core:1.2.0-alpha-2")
+    implementation("org.jetbrains.kotlinx:kotlinx-coroutines-core:1.2.0")
 }
 ```
 
 And make sure that you use the latest Kotlin version:
 
 ```groovy
 plugins {
-    kotlin("jvm") version "1.3.21"
+    kotlin("jvm") version "1.3.30"
 }
 ```
 
@@ -147,7 +147,7 @@ Add [`kotlinx-coroutines-android`](ui/kotlinx-coroutines-android)
 module as dependency when using `kotlinx.coroutines` on Android:
 
 ```groovy
-implementation 'org.jetbrains.kotlinx:kotlinx-coroutines-android:1.2.0-alpha-2'
+implementation 'org.jetbrains.kotlinx:kotlinx-coroutines-android:1.2.0'
 ```
 This gives you access to Android [Dispatchers.Main](https://kotlin.github.io/kotlinx.coroutines/kotlinx-coroutines-android/kotlinx.coroutines.android/kotlinx.coroutines.-dispatchers/index.html)
 coroutine dispatcher and also makes sure that in case of crashed coroutine with unhandled exception this

gradle.properties

@@ -1,5 +1,5 @@
 # Kotlin
-version=1.2.0-alpha-2-SNAPSHOT
+version=1.2.0-SNAPSHOT
 group=org.jetbrains.kotlinx
 kotlin_version=1.3.30
 

kotlinx-coroutines-core/common/src/flow/internal/NullSurrogate.kt

@@ -8,7 +8,7 @@ import kotlin.jvm.*
 
 internal object NullSurrogate {
 
-    @Suppress("NULL_FOR_NONNULL_TYPE")
     @JvmStatic
-    internal fun <T> unbox(value: Any?): T = if (value === NullSurrogate) null else value as T
+    @Suppress("UNCHECKED_CAST")
+    internal fun <T> unbox(value: Any?): T = if (value === NullSurrogate) null as T else value as T
 }

kotlinx-coroutines-debug/README.md

@@ -18,7 +18,7 @@ of coroutines hierarchy referenced by a [Job] or [CoroutineScope] instances usin
 Add `kotlinx-coroutines-debug` to your project test dependencies:
 ```
 dependencies {
-    testImplementation 'org.jetbrains.kotlinx:kotlinx-coroutines-debug:1.2.0-alpha-2'
+    testImplementation 'org.jetbrains.kotlinx:kotlinx-coroutines-debug:1.2.0'
 }
 ```
 
@@ -57,7 +57,7 @@ stacktraces will be dumped to the console.
 ### Using as JVM agent
 
 It is possible to use this module as a standalone JVM agent to enable debug probes on the application startup.
-You can run your application with an additional argument: `-javaagent:kotlinx-coroutines-debug-1.2.0-alpha-2.jar`.
+You can run your application with an additional argument: `-javaagent:kotlinx-coroutines-debug-1.2.0.jar`.
 Additionally, on Linux and Mac OS X you can use `kill -5 $pid` command in order to force your application to print all alive coroutines.
 
 

kotlinx-coroutines-test/README.md

@@ -7,7 +7,7 @@ Test utilities for `kotlinx.coroutines`. Provides `Dispatchers.setMain` to overr
 Add `kotlinx-coroutines-test` to your project test dependencies:
 ```
 dependencies {
-    testImplementation 'org.jetbrains.kotlinx:kotlinx-coroutines-test:1.2.0-alpha-2'
+    testImplementation 'org.jetbrains.kotlinx:kotlinx-coroutines-test:1.2.0'
 }
 ```
 

ui/coroutines-guide-ui.md

@@ -165,7 +165,7 @@ Add dependencies on `kotlinx-coroutines-android` module to the `dependencies { .
 `app/build.gradle` file:
 
 ```groovy
-implementation "org.jetbrains.kotlinx:kotlinx-coroutines-android:1.2.0-alpha-2"
+implementation "org.jetbrains.kotlinx:kotlinx-coroutines-android:1.2.0"
 ```
 
 You can clone [kotlinx.coroutines](https://github.com/Kotlin/kotlinx.coroutines) project from GitHub onto your 

ui/kotlinx-coroutines-android/animation-app/gradle.properties

@@ -18,6 +18,6 @@ org.gradle.jvmargs=-Xmx1536m
 
 kotlin.coroutines=enable
 
-kotlin_version=1.3.21
-coroutines_version=1.2.0-alpha-2
+kotlin_version=1.3.30
+coroutines_version=1.2.0
 

ui/kotlinx-coroutines-android/example-app/gradle.properties

@@ -18,6 +18,6 @@ org.gradle.jvmargs=-Xmx1536m
 
 kotlin.coroutines=enable
 
-kotlin_version=1.3.21
-coroutines_version=1.2.0-alpha-2
+kotlin_version=1.3.30
+coroutines_version=1.2.0