Version 0.26.0

Author: qwwdfsad

CHANGES.md

@@ -1,5 +1,26 @@
 # Change log for kotlinx.coroutines
 
+## Version 0.26.0
+* Major rework of `kotlinx.coroutines` concurrency model (see #410 for a full explanation of the rationale behind this change):
+  * All coroutine builders are now extensions on `CoroutineScope` and inherit its `coroutineContext`. Standalone builders are deprecated.
+  * As a consequence, all nested coroutines launched via builders now automatically establish parent-child relationship and inherit `CoroutineDispatcher`.
+  * All coroutine builders use `Dispatchers.Default` by default if `CoroutineInterceptor` is not present in their context.
+  * [CoroutineScope](https://kotlin.github.io/kotlinx.coroutines/kotlinx-coroutines-core/kotlinx.coroutines.experimental/-coroutine-scope/) became the first-class citizen in `kolinx.coroutines`.
+  * `withContext` `block` argument has `CoroutineScope` as a receiver.
+  * [GlobalScope](https://kotlin.github.io/kotlinx.coroutines/kotlinx-coroutines-core/kotlinx.coroutines.experimental/-global-scope/) is introduced to simplify migration to new API and to launch global-level coroutines.
+  * `currentScope` and `coroutineScope` builders are introduced to extract and provide `CoroutineScope`.
+  * Factory methods to create `CoroutineScope` from `CoroutineContext` are introduced.
+  * `CoroutineScope.isActive` became an extension property.
+  * New sections about structured concurrency in core guide: ["Structured concurrency"](coroutines-guide.md#structured-concurrency), ["Scope builder"](coroutines-guide.md#scope-builder) and ["Structured concurrency with async"](coroutines-guide.md#structured-concurrency-with-async).
+  * New section in UI guide with Android example: ["Structured concurrency, lifecycle and coroutine parent-child hierarchy"](ui/coroutines-guide-ui.md#structured-concurrency,-lifecycle-and-coroutine-parent-child-hierarchy).
+  * Deprecated reactive API is removed.
+* Dispatchers are renamed and grouped in the Dispatchers object (see #41 and #533):
+  * Dispatcher names are consistent.
+  * Old dispatchers including `CommonPool` are deprecated.
+* Fixed bug with JS error in rare cases in `invokeOnCompletion(onCancelling = true)`.
+* Fixed loading of Android exception handler when `Thread.contextClassLoader` is mocked (see #530).
+* Fixed bug when `IO` dispatcher silently hung (see #524 and #525) .
+
 ## Version 0.25.3
 
 * Distribution no longer uses multi-version jar which is not supported on Android (see #510).

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.25.3) ](https://bintray.com/kotlin/kotlinx/kotlinx.coroutines/0.25.3)
+[![Download](https://api.bintray.com/packages/kotlin/kotlinx/kotlinx.coroutines/images/download.svg?version=0.26.0) ](https://bintray.com/kotlin/kotlinx/kotlinx.coroutines/0.26.0)
 
 Library support for Kotlin coroutines with [multiplatform](#multiplatform) support.
 This is a companion version for Kotlin 1.2.61 release.
@@ -63,7 +63,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.25.3</version>
+    <version>0.26.0</version>
 </dependency>
 ```
 
@@ -80,7 +80,7 @@ And make sure that you use the latest Kotlin version:
 Add dependencies (you can also add other modules that you need):
 
 ```groovy
-implementation 'org.jetbrains.kotlinx:kotlinx-coroutines-core:0.25.3'
+implementation 'org.jetbrains.kotlinx:kotlinx-coroutines-core:0.26.0'
 ```
 
 And make sure that you use the latest Kotlin version:
@@ -113,10 +113,9 @@ 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:0.25.3'
+implementation 'org.jetbrains.kotlinx:kotlinx-coroutines-android:0.26.0'
 ```
-
-This gives you access to Android [UI](https://kotlin.github.io/kotlinx.coroutines/kotlinx-coroutines-android/kotlinx.coroutines.experimental.android/-u-i.html)
+This gives you access to Android [Dispatchers.Main](https://kotlin.github.io/kotlinx.coroutines/kotlinx-coroutines-android/kotlinx.coroutines.experimental.android/kotlinx.coroutines.experimental.-dispatchers/index.html)
 coroutine dispatcher and also makes sure that in case of crashed coroutine with unhandled exception this
 exception is logged before crashing Android application, similarly to the way uncaught exceptions in 
 threads are handled by Android runtime. 

gradle.properties

@@ -1,6 +1,6 @@
 # Kotlin
-version = 0.25.3-SNAPSHOT
-group = org.jetbrains.kotlinx
+version=0.26.0-SNAPSHOT
+group=org.jetbrains.kotlinx
 kotlin_version=1.2.61
 kotlin_native_version=0.8.2
 

native/README.md

@@ -42,7 +42,7 @@ repositories {
 }
 
 dependencies {
-    implementation 'org.jetbrains.kotlinx:kotlinx-coroutines-core-native:0.25.3'
+    implementation 'org.jetbrains.kotlinx:kotlinx-coroutines-core-native:0.26.0'
 }
 
 sourceSets {

ui/coroutines-guide-ui.md

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

ui/kotlinx-coroutines-android/README.md

@@ -1,6 +1,6 @@
 # Module kotlinx-coroutines-android
 
-Provides `UI` context for Android applications.
+Provides `Dispatchers.Main` context for Android applications.
 
 Read [Guide to UI programming with coroutines](https://github.com/Kotlin/kotlinx.coroutines/blob/master/ui/coroutines-guide-ui.md)
 for tutorial on this module.

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

@@ -18,6 +18,6 @@ org.gradle.jvmargs=-Xmx1536m
 
 kotlin.coroutines=enable
 
-kotlin_version = 1.2.61
-coroutines_version = 0.25.3
+kotlin_version=1.2.61
+coroutines_version=0.26.0
 

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

@@ -18,6 +18,6 @@ org.gradle.jvmargs=-Xmx1536m
 
 kotlin.coroutines=enable
 
-kotlin_version = 1.2.61
-coroutines_version = 0.25.3
+kotlin_version=1.2.61
+coroutines_version=0.26.0
 

ui/kotlinx-coroutines-javafx/README.md

@@ -1,6 +1,6 @@
 # Module kotlinx-coroutines-javafx
 
-Provides `JavaFx` context for JavaFX UI applications.
+Provides `Dispatchers.JavaFx` context for JavaFX UI applications.
 
 Read [Guide to UI programming with coroutines](https://github.com/Kotlin/kotlinx.coroutines/blob/master/ui/coroutines-guide-ui.md)
 for tutorial on this module.

ui/kotlinx-coroutines-swing/README.md

@@ -1,6 +1,6 @@
 # Module kotlinx-coroutines-swing
 
-Provides `Swing` context for Swing UI applications.
+Provides `Dispatchers.Swing` context for Swing UI applications.
 
 Read [Guide to UI programming with coroutines](https://github.com/Kotlin/kotlinx.coroutines/blob/master/ui/coroutines-guide-ui.md)
 for tutorial on this module.