Version 0.4-beta and its change log

Author: elizarov

CHANGES.md

@@ -0,0 +1,16 @@
+# kotlinx.coroutines change log
+
+## Version 0.4-beta
+
+* Switched to Kotlin version 1.1.0-beta-18 (republished version).
+* `CoroutineDispatcher` methods now have `context` parameter.
+* Introduced `CancellableContinuation.isCancelled`
+* Introduced `EventLoop` dispatcher and made it a default for `runBlocking { ... }`
+* Introduced `CoroutineScope` interface with `isActive` and `context` properties; 
+  standard coroutine builders include it as receiver for convenience.
+* Introduced `Executor.toCoroutineDispatcher()` extension.  
+* Delay scheduler thread is not daemon anymore, but times out automatically.
+* Debugging facilities in `newCoroutineContext` can be explicitly disabled with `-Dkotlinx.coroutines.debug=off`.
+* xxx-test files are renamed to xxx-example for clarity.
+* Fixed NPE in Job implementation when starting coroutine with already cancelled parent job.
+* Support cancellation in `kotlinx-coroutines-nio` module

README.md

@@ -4,18 +4,21 @@ Library support for Kotlin coroutines. This is a companion version for Kotlin 1.
 It contains worked-out implementation of coroutine builders, suspending functions, and contexts that are
 used as examples in 
 [Kotlin coroutines design document](https://github.com/Kotlin/kotlin-coroutines/blob/master/kotlin-coroutines-informal.md)
+
+See [change log](CHANGES.md) for a summary of changes between releases. 
 
 It consists of the following modules:
 
 * `kotlinx-coroutines-core` module with core primitives to work with coroutines. It is designed to work on any JDK6+ and Android
 and contains the following main pieces:
   * `launch(context) { ... }` to start a coroutine in the given context.
   * `run(context) { ... }` to switch to a different context inside a coroutine.
-  * `runBlocking(context) { ... }` to use asynchronous Kotlin APIs from a thread-blocking code.  
+  * `runBlocking { ... }` to use asynchronous Kotlin APIs from a thread-blocking code.  
   * `defer(context) { ... }` to get a deferred result of coroutine execution in a non-blocking way.
   * `delay(...)` for a non-blocking sleep in coroutines.
-  * `Here` and `CommonPool` contexts.
-  * `newSingleThreadContext(...)` and `newFixedThreadPoolContext(...)` functions.
+  * `Here` and `CommonPool` contexts, `context` or a parent coroutine.
+  * `newSingleThreadContext(...)` and `newFixedThreadPoolContext(...)` functions, 
+    `Executor.toCoroutineDispatcher()` extension.
   * Cancellation support with `Job` interface and `suspendCancellableCoroutine` helper function.
   * Debugging facilities for coroutines (run JVM with `-ea` or `-Dkotlinx.coroutines.debug` options) and
     `newCoroutineContext(context)` function to write user-defined coroutine builders that work with these
@@ -25,7 +28,7 @@ and contains the following main pieces:
   * `future { ... }` coroutine builder that returns `CompletableFuture` and works in `CommonPool` context by default.
   * `.await()` suspending function for `CompletableFuture`.
 
-* `kotlinx-coroutines-nio` module with extensions for asynchronous IO on JDK7+ (does not support cancellation yet).
+* `kotlinx-coroutines-nio` module with extensions for asynchronous IO on JDK7+.
 
 * `kotlinx-coroutines-swing` module with `Swing` context for Swing UI applications.
 
@@ -66,7 +69,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.3-beta</version>
+    <version>0.4-beta</version>
 </dependency>
 ```
 
@@ -93,7 +96,7 @@ repositories {
 Add dependencies (you can also add other modules that you need):
 
 ```groovy
-compile 'org.jetbrains.kotlinx:kotlinx-coroutines-core:0.3-beta'
+compile 'org.jetbrains.kotlinx:kotlinx-coroutines-core:0.4-beta'
 ```
 
 And make sure that you use the right Kotlin version:

kotlinx-coroutines-core/pom.xml

@@ -6,7 +6,7 @@
     <parent>
         <groupId>org.jetbrains.kotlinx</groupId>
         <artifactId>kotlinx-coroutines</artifactId>
-        <version>0.3-beta-SNAPSHOT</version>
+        <version>0.4-beta-SNAPSHOT</version>
     </parent>
 
     <artifactId>kotlinx-coroutines-core</artifactId>

kotlinx-coroutines-javafx/pom.xml

@@ -6,7 +6,7 @@
     <parent>
         <groupId>org.jetbrains.kotlinx</groupId>
         <artifactId>kotlinx-coroutines</artifactId>
-        <version>0.3-beta-SNAPSHOT</version>
+        <version>0.4-beta-SNAPSHOT</version>
     </parent>
 
     <artifactId>kotlinx-coroutines-javafx</artifactId>

kotlinx-coroutines-jdk8/pom.xml

@@ -6,7 +6,7 @@
     <parent>
         <groupId>org.jetbrains.kotlinx</groupId>
         <artifactId>kotlinx-coroutines</artifactId>
-        <version>0.3-beta-SNAPSHOT</version>
+        <version>0.4-beta-SNAPSHOT</version>
     </parent>
 
     <artifactId>kotlinx-coroutines-jdk8</artifactId>

kotlinx-coroutines-nio/pom.xml

@@ -6,7 +6,7 @@
     <parent>
         <groupId>org.jetbrains.kotlinx</groupId>
         <artifactId>kotlinx-coroutines</artifactId>
-        <version>0.3-beta-SNAPSHOT</version>
+        <version>0.4-beta-SNAPSHOT</version>
     </parent>
 
     <artifactId>kotlinx-coroutines-nio</artifactId>

kotlinx-coroutines-rx-example/pom.xml

@@ -6,7 +6,7 @@
     <parent>
         <groupId>org.jetbrains.kotlinx</groupId>
         <artifactId>kotlinx-coroutines</artifactId>
-        <version>0.3-beta-SNAPSHOT</version>
+        <version>0.4-beta-SNAPSHOT</version>
     </parent>
 
     <artifactId>kotlinx-coroutines-rx-example</artifactId>

kotlinx-coroutines-rx/pom.xml

@@ -6,7 +6,7 @@
     <parent>
         <groupId>org.jetbrains.kotlinx</groupId>
         <artifactId>kotlinx-coroutines</artifactId>
-        <version>0.3-beta-SNAPSHOT</version>
+        <version>0.4-beta-SNAPSHOT</version>
     </parent>
 
     <artifactId>kotlinx-coroutines-rx</artifactId>

kotlinx-coroutines-swing/pom.xml

@@ -6,7 +6,7 @@
     <parent>
         <groupId>org.jetbrains.kotlinx</groupId>
         <artifactId>kotlinx-coroutines</artifactId>
-        <version>0.3-beta-SNAPSHOT</version>
+        <version>0.4-beta-SNAPSHOT</version>
     </parent>
 
     <artifactId>kotlinx-coroutines-swing</artifactId>

pom.xml

@@ -7,7 +7,7 @@
 
     <groupId>org.jetbrains.kotlinx</groupId>
     <artifactId>kotlinx-coroutines</artifactId>
-    <version>0.3-beta-SNAPSHOT</version>
+    <version>0.4-beta-SNAPSHOT</version>
     <packaging>pom</packaging>
 
     <name>Kotlin coroutines libraries</name>