Merge remote-tracking branch 'origin/master' into develop

Author: elizarov

CHANGES.md

@@ -1,5 +1,33 @@
 # Change log for kotlinx.coroutines 
 
+## Version 0.20
+
+* Migrated to Kotlin 1.2.0.
+* Channels:
+  * Sequence-like `filter`, `map`, etc extensions on `ReceiveChannel` are introduced (see #88 by @fvasco and #69 by @konrad-kaminski).
+  * Introduced `ReceiveChannel.cancel` method.
+  * All operators on `ReceiveChannel` fully consume the original channel (`cancel` it when they are done) using a helper `consume` extension.
+  * Deprecated `ActorJob` and `ProducerJob`; `actor` now returns `SendChannel` and `produce` returns `ReceiveChannel` (see #127).
+  * `SendChannel.sendBlocking` extension method (see #157 by @@fvasco).
+* Parent-child relations between coroutines:
+  * Introduced an optional `parent` job parameter for all coroutine builders so that code with an explict parent `Job` is more natural.
+  * Added `parent` parameter to `CompletableDeferred` constructor.
+  * Introduced `Job.children` property.
+  * `Job.cancelChildren` is now an extension (member is deprecated and hidden).
+  * `Job.joinChildren` extension is introduced.
+  * Deprecated `Job.attachChild` as a error-prone API.
+  * Fixed StackOverflow when waiting for a lot of completed children that did not remove their handlers from the parent.
+* Use `java.util.ServiceLoader` to find default instances of `CoroutineExceptionHandler`.
+* Android UI integration:
+  * Use `Thread.getUncaughtExceptionPreHandler` to make sure that exceptions are logged before crash (see #148).
+  * Introduce `UI.awaitFrame` for animation; added sample coroutine-based animation application for Android [here](ui/kotlinx-coroutines-android/animation-app).
+  * Fixed `delay(Long.MAX_VALUE)` (see #161)  
+* Added missing `DefaultDispatcher` on some reactive operators (see #174 by @fvasco)
+* Fixed `actor` and `produce` so that a cancellation of a Job cancels the underlying channel (closes and removes all the pending messages).  
+* Fixed sporadic failure of `example-context-06` (see #160)
+* Fixed hang of `Job.start` on lazy coroutine with attached `invokeOnCompletion` handler.
+* A more gradual introduction to `runBlocking` and coroutines in the [guide](coroutines-guide.md) (see #166).
+
 ## Version 0.19.3
 
 * Fixed `send`/`openSubscription` race in `ArrayBroadcastChannel`.

README.md

@@ -2,7 +2,7 @@
 
 [![official JetBrains project](http://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)
-[![Download](https://api.bintray.com/packages/kotlin/kotlinx/kotlinx.coroutines/images/download.svg?version=0.19.3) ](https://bintray.com/kotlin/kotlinx/kotlinx.coroutines/0.19.3)
+[![Download](https://api.bintray.com/packages/kotlin/kotlinx/kotlinx.coroutines/images/download.svg?version=0.20) ](https://bintray.com/kotlin/kotlinx/kotlinx.coroutines/0.20)
 
 Library support for Kotlin coroutines. 
 This is a companion version for Kotlin 1.2.0 release. 
@@ -25,8 +25,9 @@ This is a companion version for Kotlin 1.2.0 release.
 
 ## Documentation
 
-* [Introduction to Kotlin Coroutines](https://vimeo.com/222499934) video
-  (Roman Elizarov at GeekOut 2017, [slides](https://www.slideshare.net/elizarov/introduction-to-kotlin-coroutines))
+* Presentations and videos:
+   * [Introduction to Coroutines](https://www.youtube.com/watch?v=_hfBv0a09Jc) (Roman Elizarov at KotlinConf 2017, [slides](https://www.slideshare.net/elizarov/introduction-to-coroutines-kotlinconf-2017))
+   * [Deep dive into Coroutines](https://www.youtube.com/watch?v=YrrUCSi72E8) (Roman Elizarov at KotlinConf 2017, [slides](https://www.slideshare.net/elizarov/deep-dive-into-coroutines-on-jvm-kotlinconf-2017))
 * Guides and manuals: 
   * [Guide to kotlinx.coroutines by example](coroutines-guide.md) (**read it first**)
   * [Guide to UI programming with coroutines](ui/coroutines-guide-ui.md)
@@ -51,7 +52,7 @@ Add dependencies (you can also add other modules that you need):
 <dependency>
     <groupId>org.jetbrains.kotlinx</groupId>
     <artifactId>kotlinx-coroutines-core</artifactId>
-    <version>0.19.3</version>
+    <version>0.20</version>
 </dependency>
 ```
 
@@ -68,7 +69,7 @@ And make sure that you use the latest Kotlin version:
 Add dependencies (you can also add other modules that you need):
 
 ```groovy
-compile 'org.jetbrains.kotlinx:kotlinx-coroutines-core:0.19.3'
+compile 'org.jetbrains.kotlinx:kotlinx-coroutines-core:0.20'
 ```
 
 And make sure that you use the latest Kotlin version:

coroutines-guide.md

@@ -178,7 +178,7 @@ World!
 -->
 
 The result is the same, but this code uses only non-blocking [delay]. 
-The the main thread, that invokes `runBlocking`, _blocks_ until the coroutine inside `runBlocking` is active. 
+The the main thread, that invokes `runBlocking`, _blocks_ until the coroutine inside `runBlocking` completes. 
 
 This example can be also rewritten in a more idiomatic way, using `runBlocking` to wrap 
 the execution of the main function:

gradle.properties

@@ -1,4 +1,4 @@
-version = 0.19.3-SNAPSHOT
+version = 0.20-SNAPSHOT
 
 kotlin_version = 1.2.0
 junit_version = 4.12

ui/coroutines-guide-ui.md

@@ -173,7 +173,7 @@ Add dependencies on `kotlinx-coroutines-android` module to the `dependencies { .
 `app/build.gradle` file:
 
 ```groovy
-compile "org.jetbrains.kotlinx:kotlinx-coroutines-android:0.19.3"
+compile "org.jetbrains.kotlinx:kotlinx-coroutines-android:0.20"
 ```
 
 Coroutines are experimental feature in Kotlin.

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

@@ -19,5 +19,5 @@ org.gradle.jvmargs=-Xmx1536m
 kotlin.coroutines=enable
 
 kotlin_version = 1.2.0
-coroutines_version = 0.19.3
+coroutines_version = 0.20
 

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

@@ -31,5 +31,5 @@ dependencies {
     compile 'com.android.support:design:25.4.0'
     testCompile 'junit:junit:4.12'
     compile "org.jetbrains.kotlin:kotlin-stdlib-jre7:$kotlin_version"
-    compile "org.jetbrains.kotlinx:kotlinx-coroutines-android:0.19.3"
+    compile "org.jetbrains.kotlinx:kotlinx-coroutines-android:0.20"
 }

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

@@ -19,5 +19,5 @@ org.gradle.jvmargs=-Xmx1536m
 kotlin.coroutines=enable
 
 kotlin_version = 1.2.0
-coroutines_version = 0.19.3
+coroutines_version = 0.20