0.24.0

• Fully multiplatform release with Kotlin/Native support (see #246):
  • Only single-threaded operation inside runBlocking event loop is supported at this moment.
  • See details on setting up build environment here.
• Improved channels:
  • Introduced SendChannel.invokeOnClose (see #341).
  • Make close, cancel, isClosedForSend, isClosedForReceive and offer linearizable with other operations (see #359).
  • Fixed bug when send operation can be stuck in channel forever.
  • Fixed broadcast channels on JS (see #412).
• Provides BlockingChecker mechanism which checks current context (see #227).
  • Attempts to use runBlocking from any supported UI thread (Android, JavaFx, Swing) will result in exception.
• Android:
  • Worked around Android bugs with zero-size ForkJoinPool initialization (see #432, #288).
  • Introduced UI.immediate extension as performance-optimization to immediately execute tasks which are invoked from the UI thread (see #381).
    • Use it only when absolutely needed. It breaks asynchrony of coroutines and may lead to surprising and unexpected results.
• Fixed materialization of a cause exception for Job onCancelling handlers (see #436).
• Fixed JavaFx UI on Java 9 (see #443).
• Fixed and documented the order between cancellation handlers and continuation resume (see #415).
• Fixed resumption of cancelled continuation (see #450).
• Includes multiple fixes to documentation contributed by @paolop, @sahillone, @rocketraman, @bdavisx, @mtopolnik, @Groostav.
• Experimental coroutines scheduler preview (JVM only):
  • Written from scratch and optimized for communicating coroutines.
  • Performs significantly better than ForkJoinPool on coroutine benchmarks and for connected applications with ktor.
  • Supports automatic creating of new threads for blocking operations running on the same thread pool (with an eye on solving #79), but there is no stable public API for it just yet.
  • For preview, run JVM with -Dkotlinx.coroutines.scheduler option. In this case DefaultDispatcher is set to new experimental scheduler instead of FJP-based CommonPool.
  • Submit your feedback to issue #261.

0.23.4

• Recompiled with Kotlin 1.2.51 to solve broken metadata problem (see KT-24944).

0.23.3

• Kotlin 1.2.50.
• JS: Moved to atomicfu version 0.10.3 that properly matches NPM & Kotlin/JS module names (see #396).
• Improve source-code compatibility with previous (0.22.x) version of openChannel().use { ... } pattern by providing deprecated extension function use on ReceiveChannel.

0.23.2

• IO: fix joining and continuous writing byte array interference.

0.23.1

• JS: Fix dependencies in NPM: add "kotlinx-atomicfu" dependency (see #370).
• Introduce broadcast coroutine builder (see #280):
  • Support BroadcastChannel.cancel method to drop the buffer.
  • Introduce ReceiveChannel.broadcast() extension.
• Fixed a bunch of doc typos (PRs by @paolop).
• Corrected previous version's release notes (PR by @ansman).

0.23.0

• Kotlin 1.2.41
• Coroutines core module is made mostly cross-platform for JVM and JS:
  • Migrate channels and related operators to common, so channels can be used from JS (see #201).
  • Most of the code is shared between JVM and JS versions using cross-platform version of AtomicFU library.
  • The recent version of Kotlin allows default parameters in common code (see #348).
  • The project is built using Gradle 4.6.
• Breaking change: CancellableContinuation is not a Job anymore (see #219):
  • It does not affect casual users of suspendCancellableCoroutine, since all the typically used functions are still there.
  • CancellableContinuation.invokeOnCompletion is deprecated now and its semantics had subtly changed:
    • invokeOnCancellation is a replacement for invokeOnCompletion to install a handler.
    • The handler is not invoked on resume which corresponds to the typical usage pattern.
    • There is no need to check for cont.isCancelled in a typical handler code anymore (since handler is invoked only when continuation is cancelled).
    • Multiple cancellation handlers cannot be installed.
    • Cancellation handlers cannot be removed (disposed of) anymore.
  • This change is designed to allow better performance of suspending cancellable functions:
    • Now CancellableContinuation implementation has simpler state machine and is implemented more efficiently.
  • Exception handling in AbstractContinuation (that implements CancellableContinuation) is now consistent:
    • Always prefer exception thrown from coroutine as exceptional reason, add cancellation cause as suppressed exception.
• Big change: Deprecate CoroutineScope.coroutineContext:
  • It is replaced with top-level coroutineContext function from Kotlin standard library.
• Improve ReceiveChannel operators implementations to guarantee closing of the source channels under all circumstances (see #279):
  • onCompletion parameter added to produce and all other coroutine builders.
  • Introduce ReceiveChannel.consumes(): CompletionHandler extension function.
• Replace SubscriptionReceiveChannel with ReceiveChannel (see #283, PR by @deva666).
  • ReceiveChannel.use extension is introduced to preserve source compatibility, but is deprecated.
    • consume or consumeEach extensions should be used for channels.
    • When writing operators, produce(onCompletion=consumes()) { ... } pattern shall be used (see #279 above).
• JS: Kotlin is declared as peer dependency (see #339, #340, PR by @ansman).
• Invoke exception handler for actor on cancellation even when channel was successfully closed, so exceptions thrown by actor are always reported (see #368).
• Introduce awaitAll and joinAll for Deferred and Job lists correspondingly (see #171).
• Unwrap CompletionException exception in CompletionStage.await slow-path to provide consistent results (see #375).
• Add extension to ExecutorService to return CloseableCoroutineDispatcher (see #278, PR by @deva666).
• Fail with proper message during build if JDK_16 is not set (see #291, PR by @venkatperi).
• Allow negative timeouts in delay, withTimeout and onTimeout (see #310).
• Fix a few bugs (leaks on cancellation) in delay:
  • Invoke clearTimeout on cancellation in JSDispatcher.
  • Remove delayed task on cancellation from internal data structure on JVM.
• Introduce ticker function to create "ticker channels" (see #327):
  • It provides analogue of RX Observable.timer for coroutine channels.
  • It is currently supported on JVM only.
• Add a test-helper class TestCoroutineContext (see #297, PR by @streetsofboston).
  • It is currently supported on JVM only.
  • Ticker channels (#327) are not yet compatible with it.
• Implement a better way to set CoroutineContext.DEBUG value (see #316, PR by @dmytrodanylyk):
  • Made CoroutineContext.DEBUG_PROPERTY_NAME constant public.
  • Introduce public constants with "on", "off", "auto" values.
• Introduce system property to control CommonPool parallelism (see #343):
  • CommonPool.DEFAULT_PARALLELISM_PROPERTY_NAME constant is introduced with a value of "kotlinx.coroutines.default.parallelism".
• Include package-list files into documentation site (see #290).
• Fix various typos in docs (PRs by @paolop and @ArtsiomCh).

0.22.5

• JS: Fixed main file reference in NPM package
• Added context argument to Channel.filterNot (PR by @jcornaz).
• Implemented debug toString for channels (see #185).

0.22.4

• JS: Publish to NPM (see #229).
• JS: Use node-style dispatcher on ReactNative (see #236).
• jdk8 integration improvements:
  • Added conversion from CompletionStage to Deferred (see #262, PR by @jcornaz).
  • Use fast path in CompletionStage.await and make it cancellable.

0.22.3

• Fixed produce builder to close the channel on completion instead of cancelling it, which lead to lost elements with buffered channels (see #256).
• Don't use ForkJoinPool if there is a SecurityManager present to work around JNLP problems (see #216, PR by @NikolayMetchev).
• JS: Check for undefined window.addEventListener when choosing default coroutine dispatcher (see #230, PR by @ScottPierce).
• Update 3rd party dependencies:
  • kotlinx-coroutines-rx1 to RxJava version 1.3.6.
  • kotlinx-coroutines-rx2 to RxJava version 2.1.9.
  • kotlinx-coroutines-guava to Guava version 24.0-jre.

0.22.2

• Android: Use Keep annotation on AndroidExceptionPreHandler to fix the problem on Android with minification enabled (see #214).
• Reactive: Added awaitFirstOrDefault and awaitFirstOrNull extensions (see #224, PR by @konrad-kaminski).
• Core: Fixed withTimeout and withTimeoutOrNull that should not use equals on result (see #212, PR by @konrad-kaminski).
• Core: Fixed hanged receive from a closed subscription of BroadcastChannel (see #226).
• IO: fixed error propagation (see ktorio/ktor#301)
• Include common sources into sources jar file to work around KT-20971.
• Fixed bugs in documentation due to MPP.