1# Change log for kotlinx.coroutines 2 3## Version 1.6.4 4 5* Added `TestScope.backgroundScope` for launching coroutines that perform work in the background and need to be cancelled at the end of the test (#3287). 6* Fixed the POM of `kotlinx-coroutines-debug` having an incorrect reference to `kotlinx-coroutines-bom`, which cause the builds of Maven projects using the debug module to break (#3334). 7* Fixed the `Publisher.await` functions in `kotlinx-coroutines-reactive` not ensuring that the `Subscriber` methods are invoked serially (#3360). Thank you, @EgorKulbachka! 8* Fixed a memory leak in `withTimeout` on K/N with the new memory model (#3351). 9* Added the guarantee that all `Throwable` implementations in the core library are serializable (#3328). 10* Moved the documentation to <https://kotlinlang.org/api/kotlinx.coroutines/> (#3342). 11* Various documentation improvements. 12 13## Version 1.6.3 14 15* Updated atomicfu version to 0.17.3 (#3321), fixing the projects using this library with JS IR failing to build (#3305). 16 17## Version 1.6.2 18 19* Fixed a bug with `ThreadLocalElement` not being correctly updated when the most outer `suspend` function was called directly without `kotlinx.coroutines` (#2930). 20* Fixed multiple data races: one that might have been affecting `runBlocking` event loop, and a benign data race in `Mutex` (#3250, #3251). 21* Obsolete `TestCoroutineContext` is removed, which fixes the `kotlinx-coroutines-test` JPMS package being split between `kotlinx-coroutines-core` and `kotlinx-coroutines-test` (#3218). 22* Updated the ProGuard rules to further shrink the size of the resulting DEX file with coroutines (#3111, #3263). Thanks, @agrieve! 23* Atomicfu is updated to `0.17.2`, which includes a more efficient and robust JS IR transformer (#3255). 24* Kotlin is updated to `1.6.21`, Gradle version is updated to `7.4.2` (#3281). Thanks, @wojtek-kalicinski! 25* Various documentation improvements. 26 27## Version 1.6.1 28 29* Rollback of time-related functions dispatching on `Dispatchers.Main`. 30 This behavior was introduced in 1.6.0 and then found inconvenient and erroneous (#3106, #3113). 31* Reworked the newly-introduced `CopyableThreadContextElement` to solve issues uncovered after the initial release (#3227). 32* Fixed a bug with `ThreadLocalElement` not being properly updated in racy scenarios (#2930). 33* Reverted eager loading of default `CoroutineExceptionHandler` that triggered ANR on some devices (#3180). 34* New API to convert a `CoroutineDispatcher` to a Rx scheduler (#968, #548). Thanks @recheej! 35* Fixed a memory leak with the very last element emitted from `flow` builder being retained in memory (#3197). 36* Fixed a bug with `limitedParallelism` on K/N with new memory model throwing `ClassCastException` (#3223). 37* `CoroutineContext` is added to the exception printed to the default `CoroutineExceptionHandler` to improve debuggability (#3153). 38* Static memory consumption of `Dispatchers.Default` was significantly reduced (#3137). 39* Updated slf4j version in `kotlinx-coroutines-slf4j` from 1.7.25 to 1.7.32. 40 41## Version 1.6.0 42 43Note that this is a full changelog relative to the 1.5.2 version. Changelog relative to 1.6.0-RC3 can be found at the end. 44 45### kotlinx-coroutines-test rework 46 47* `kotlinx-coroutines-test` became a multiplatform library usable from K/JVM, K/JS, and K/N. 48* Its API was completely reworked to address long-standing issues with consistency, structured concurrency and correctness (#1203, #1609, #2379, #1749, #1204, #1390, #1222, #1395, #1881, #1910, #1772, #1626, #1742, #2082, #2102, #2405, #2462 49 ). 50* The old API is deprecated for removal, but the new API is based on the similar concepts ([README](kotlinx-coroutines-test/README.md)), and the migration path is designed to be graceful: [migration guide](kotlinx-coroutines-test/MIGRATION.md). 51 52### Dispatchers 53 54* Introduced `CoroutineDispatcher.limitedParallelism` that allows obtaining a view of the original dispatcher with limited parallelism (#2919). 55* `Dispatchers.IO.limitedParallelism` usages ignore the bound on the parallelism level of `Dispatchers.IO` itself to avoid starvation (#2943). 56* Introduced new `Dispatchers.shutdown` method for containerized environments (#2558). 57* `newSingleThreadContext` and `newFixedThreadPoolContext` are promoted to delicate API (#2919). 58 59### Breaking changes 60 61* When racing with cancellation, the `future` builder no longer reports unhandled exceptions into the global `CoroutineExceptionHandler`. Thanks @vadimsemenov! (#2774, #2791). 62* `Mutex.onLock` is deprecated for removal (#2794). 63* `Dispatchers.Main` is now used as the default source of time for `delay` and `withTimeout` when present(#2972). 64 * To opt-out from this behaviour, `kotlinx.coroutines.main.delay` system property can be set to `false`. 65* Java target of coroutines build is now 8 instead of 6 (#1589). 66* **Source-breaking change**: extension `collect` no longer resolves when used with a non-in-place argument of a functional type. This is a candidate for a fix, uncovered after 1.6.0, see #3107 for the additional details. 67 68### Bug fixes and improvements 69 70* Kotlin is updated to 1.6.0. 71* Kotlin/Native [new memory model](https://blog.jetbrains.com/kotlin/2021/08/try-the-new-kotlin-native-memory-manager-development-preview/) is now supported in regular builds of coroutines conditionally depending on whether `kotlin.native.binary.memoryModel` is enabled (#2914). 72* Introduced `CopyableThreadContextElement` for mutable context elements shared among multiple coroutines. Thanks @yorickhenning! (#2893). 73* `transformWhile`, `awaitClose`, `ProducerScope`, `merge`, `runningFold`, `runingReduce`, and `scan` are promoted to stable API (#2971). 74* `SharedFlow.subscriptionCount` no longer conflates incoming updates and gives all subscribers a chance to observe a short-lived subscription (#2488, #2863, #2871). 75* `Flow` exception transparency mechanism is improved to be more exception-friendly (#3017, #2860). 76* Cancellation from `flat*` operators that leverage multiple coroutines is no longer propagated upstream (#2964). 77* `SharedFlow.collect` now returns `Nothing` (#2789, #2502). 78* `DisposableHandle` is now `fun interface`, and corresponding inline extension is removed (#2790). 79* `FlowCollector` is now `fun interface`, and corresponding inline extension is removed (#3047). 80* Deprecation level of all previously deprecated signatures is raised (#3024). 81* The version file is shipped with each JAR as a resource (#2941). 82* Unhandled exceptions on K/N are passed to the standard library function `processUnhandledException` (#2981). 83* A direct executor is used for `Task` callbacks in `kotlinx-coroutines-play-services` (#2990). 84* Metadata of coroutines artifacts leverages Gradle platform to have all versions of dependencies aligned (#2865). 85* Default `CoroutineExceptionHandler` is loaded eagerly and does not invoke `ServiceLoader` on its exception-handling path (#2552). 86* Fixed the R8 rules for `ServiceLoader` optimization (#2880). 87* Fixed BlockHound integration false-positives (#2894, #2866, #2937). 88* Fixed the exception handler being invoked several times on Android, thanks to @1zaman (#3056). 89* `SendChannel.trySendBlocking` is now available on Kotlin/Native (#3064). 90* The exception recovery mechanism now uses `ClassValue` when available (#2997). 91* JNA is updated to 5.9.0 to support Apple M1 (#3001). 92* Obsolete method on internal `Delay` interface is deprecated (#2979). 93* Support of deprecated `CommonPool` is removed. 94* `@ExperimentalTime` is no longer needed for methods that use `Duration` (#3041). 95* JDK 1.6 is no longer required for building the project (#3043). 96* New version of Dokka is used, fixing the memory leak when building the coroutines and providing brand new reference visuals (https://kotlinlang.org/api/kotlinx.coroutines/) (#3051, #3054). 97 98### Changelog relative to version 1.6.0-RC3 99 100* Restored MPP binary compatibility on K/JS and K/N (#3104). 101* Fixed Dispatchers.Main not being fully initialized on Android and Swing (#3101). 102 103## Version 1.6.0-RC3 104 105* Fixed the error in 1.6.0-RC2 because of which `Flow.collect` couldn't be called due to the `@InternalCoroutinesApi` annotation (#3082) 106* Fixed some R8 warnings introduced in 1.6.0-RC (#3090) 107* `TestCoroutineScheduler` now provides a `TimeSource` with its virtual time via the `timeSource` property. Thanks @hfhbd! (#3087) 108 109## Version 1.6.0-RC2 110 111* `@ExperimentalTime` is no longer needed for methods that use `Duration` (#3041). 112* `FlowCollector` is now `fun interface`, and corresponding inline extension is removed (#3047). 113* Fixed the exception handler being invoked several times on Android, thanks to @1zaman (#3056). 114* The deprecated `TestCoroutineScope` is no longer sealed, to simplify migration from it (#3072). 115* `runTest` gives more informative errors when it times out waiting for external completion (#3071). 116* `SendChannel.trySendBlocking` is now available on Kotlin/Native (#3064). 117* Fixed the bug due to which `Dispatchers.Main` was not used for `delay` and `withTimeout` (#3046). 118* JDK 1.6 is no longer required for building the project (#3043). 119* New version of Dokka is used, fixing the memory leak when building the coroutines and providing brand new reference visuals (https://kotlinlang.org/api/kotlinx.coroutines/) (#3051, #3054). 120 121## Version 1.6.0-RC 122 123### kotlinx-coroutines-test rework 124 125* `kotlinx-coroutines-test` became a multiplatform library usable from K/JVM, K/JS, and K/N. 126* Its API was completely reworked to address long-standing issues with consistency, structured concurrency and correctness (#1203, #1609, #2379, #1749, #1204, #1390, #1222, #1395, #1881, #1910, #1772, #1626, #1742, #2082, #2102, #2405, #2462 127 ). 128* The old API is deprecated for removal, but the new API is based on the similar concepts ([README](kotlinx-coroutines-test/README.md)), and the migration path is designed to be graceful: [migration guide](kotlinx-coroutines-test/MIGRATION.md) 129 130### Dispatchers 131 132* Introduced `CoroutineDispatcher.limitedParallelism` that allows obtaining a view of the original dispatcher with limited parallelism (#2919). 133* `Dispatchers.IO.limitedParallelism` usages ignore the bound on the parallelism level of `Dispatchers.IO` itself to avoid starvation (#2943). 134* Introduced new `Dispatchers.shutdown` method for containerized environments (#2558). 135* `newSingleThreadContext` and `newFixedThreadPoolContext` are promoted to delicate API (#2919). 136 137### Breaking changes 138 139* When racing with cancellation, the `future` builder no longer reports unhandled exceptions into the global `CoroutineExceptionHandler`. Thanks @vadimsemenov! (#2774, #2791). 140* `Mutex.onLock` is deprecated for removal (#2794). 141* `Dispatchers.Main` is now used as the default source of time for `delay` and `withTimeout` when present(#2972). 142 * To opt-out from this behaviour, `kotlinx.coroutines.main.delay` system property can be set to `false`. 143* Java target of coroutines build is now 8 instead of 6 (#1589). 144 145### Bug fixes and improvements 146 147* Kotlin is updated to 1.6.0. 148* Kotlin/Native [new memory model](https://blog.jetbrains.com/kotlin/2021/08/try-the-new-kotlin-native-memory-manager-development-preview/) is now supported in regular builds of coroutines conditionally depending on whether `kotlin.native.binary.memoryModel` is enabled (#2914). 149* Introduced `CopyableThreadContextElement` for mutable context elements shared among multiple coroutines. Thanks @yorickhenning! (#2893). 150* `transformWhile`, `awaitClose`, `ProducerScope`, `merge`, `runningFold`, `runingReduce`, and `scan` are promoted to stable API (#2971). 151* `SharedFlow.subscriptionCount` no longer conflates incoming updates and gives all subscribers a chance to observe a short-lived subscription (#2488, #2863, #2871). 152* `Flow` exception transparency mechanism is improved to be more exception-friendly (#3017, #2860). 153* Cancellation from `flat*` operators that leverage multiple coroutines is no longer propagated upstream (#2964). 154* `SharedFlow.collect` now returns `Nothing` (#2789, #2502). 155* `DisposableHandle` is now `fun interface`, and corresponding inline extension is removed (#2790). 156* Deprecation level of all previously deprecated signatures is raised (#3024). 157* The version file is shipped with each JAR as a resource (#2941). 158* Unhandled exceptions on K/N are passed to the standard library function `processUnhandledException` (#2981). 159* A direct executor is used for `Task` callbacks in `kotlinx-coroutines-play-services` (#2990). 160* Metadata of coroutines artifacts leverages Gradle platform to have all versions of dependencies aligned (#2865). 161* Default `CoroutineExceptionHandler` is loaded eagerly and does not invoke `ServiceLoader` on its exception-handling path (#2552). 162* Fixed the R8 rules for `ServiceLoader` optimization (#2880). 163* Fixed BlockHound integration false-positives (#2894, #2866, #2937). 164* The exception recovery mechanism now uses `ClassValue` when available (#2997). 165* JNA is updated to 5.9.0 to support Apple M1 (#3001). 166* Obsolete method on internal `Delay` interface is deprecated (#2979). 167* Support of deprecated `CommonPool` is removed. 168 169## Version 1.5.2 170 171* Kotlin is updated to 1.5.30. 172* New native targets for Apple Silicon are introduced. 173* Fixed a bug when `onUndeliveredElement` was incorrectly called on a properly received elements on JS (#2826). 174* Fixed `Dispatchers.Default` on React Native, it now fully relies on `setTimeout` instead of stub `process.nextTick`. Thanks to @Legion2 (#2843). 175* Optimizations of `Mutex` implementation (#2581). 176* `Mutex` implementation is made completely lock-free as stated (#2590). 177* Various documentation and guides improvements. Thanks to @MasoodFallahpoor and @Pihanya. 178 179## Version 1.5.1 180 181* Atomic `update`, `getAndUpdate`, and `updateAndGet` operations of `MutableStateFlow` (#2720). 182* `Executor.asCoroutineDispatcher` implementation improvements (#2601): 183 * If the target executor is `ScheduledExecutorService`, then its `schedule` API is used for time-related coroutine operations. 184 * `RemoveOnCancelPolicy` is now part of the public contract. 185* Introduced overloads for `Task.asDeferred` and `Task.await` that accept `CancellationTokenSource` for bidirectional cancellation (#2527). 186* Reactive streams are updated to `1.0.3` (#2740). 187* `CopyableThrowable` is allowed to modify the exception message during stacktrace recovery (#1931). 188* `CoroutineDispatcher.releaseInterceptedContinuation` is now a `final` method (#2785). 189* Closing a Handler underlying `Handler.asCoroutineDispatcher` now causes the dispatched coroutines to be canceled on `Dispatchers.IO (#2778)`. 190* Kotlin is updated to 1.5.20. 191* Fixed a spurious `ClassCastException` in `releaseInterceptedContinuation` and `IllegalStateException` from `tryReleaseClaimedContinuation` (#2736, #2768). 192* Fixed inconsistent exception message during stacktrace recovery for non-suspending channel iterators (#2749). 193* Fixed linear stack usage for `CompletableFuture.asDeferred` when the target future has a long chain of listeners (#2730). 194* Any exceptions from `CoroutineDispatcher.isDispatchNeeded` are now considered as fatal and are propagated to the caller (#2733). 195* Internal `DebugProbesKt` (used in the debugger implementation) are moved from `debug` to `core` module. 196 197## Version 1.5.0 198 199Note that this is a full changelog relative to 1.4.3 version. Changelog relative to 1.5.0-RC can be found in the end. 200 201### Channels API 202 203* Major channels API rework (#330, #974). Existing `offer`, `poll`, and `sendBlocking` methods are deprecated, internal `receiveCatching` and `onReceiveCatching` removed, `receiveOrNull` and `onReceiveOrNull` are completely deprecated. Previously deprecated `SendChannel.isFull` declaration is removed. Channel operators deprecated with `ERROR` are now `HIDDEN`. 204* New methods `receiveCatching`, `onReceiveCatching` `trySend`, `tryReceive`, and `trySendBlocking` along with the new result type `ChannelResult` are introduced. They provide better type safety, are less error-prone, and have a consistent future-proof naming scheme. The full rationale behind this change can be found [here](https://github.com/Kotlin/kotlinx.coroutines/issues/974#issuecomment-806569582). 205* `BroadcastChannel` and `ConflatedBroadcastChannel` are marked as `ObsoleteCoroutinesApi` in the favor or `SharedFlow` and `StateFlow`. The migration scheme can be found in their documentation. These classes will be deprecated in the next major release. 206* `callbackFlow` and `channelFlow` are promoted to stable API. 207 208### Reactive integrations 209 210* All existing API in modules `kotlinx-coroutines-rx2`, `kotlinx-coroutines-rx3`, `kotlinx-coroutines-reactive`, `kotlinx-coroutines-reactor`, and `kotlinx-coroutines-jdk9` were revisited and promoted to stable (#2545). 211* `publish` is no longer allowed to emit `null` values (#2646). 212* Misleading `awaitSingleOr*` functions on `Publisher` type are deprecated (#2591). 213* `MaybeSource.await` is deprecated in the favor of `awaitSingle`, additional lint functions for `Mono` are added in order to prevent ambiguous `Publisher` usages (#2628, #1587). 214* `ContextView` support in `kotlinx-coroutines-reactor` (#2575). 215* All reactive builders no longer ignore inner cancellation exceptions preventing their completion (#2262, #2646). 216* `MaybeSource.collect` and `Maybe.collect` properly finish when they are completed without a value (#2617). 217* All exceptions are now consistently handled according to reactive specification, whether they are considered 'fatal' or not by reactive frameworks (#2646). 218 219### Other improvements 220 221* Kotlin version is upgraded to 1.5.0 and JVM target is updated to 1.8. 222* `Flow.last` and `Flow.lastOrNull` operators (#2246). 223* `Flow.runningFold` operator (#2641). 224* `CoroutinesTimeout` rule for JUnit5 (#2197). 225* Internals of `Job` and `AbstractCoroutine` was reworked, resulting in smaller code size, less memory footprint, and better performance (#2513, #2512). 226* `CancellationException` from Kotlin standard library is used for cancellation on Koltin/JS and Kotlin/Native (#2638). 227* Introduced new `DelicateCoroutinesApi` annotation that warns users about potential target API pitfalls and suggests studying API's documentation first. The only delicate API right now is `GlobalScope` (#2637). 228* Fixed bug introduced in `1.4.3` when `kotlinx-coroutines-core.jar` triggered IDEA debugger failure (#2619). 229* Fixed memory leak of `ChildHandlerNode` with reusable continuations (#2564). 230* Various documentation improvements (#2555, #2589, #2592, #2583, #2437, #2616, #2633, #2560). 231 232### Changelog relative to version 1.5.0-RC 233 234* Fail-fast during `emitAll` called from cancelled `onCompletion` operator (#2700). 235* Flows returned by `stateIn`/`shareIn` keep strong reference to sharing job (#2557). 236* Rename internal `TimeSource` to `AbstractTimeSource` due to import issues (#2691). 237* Reverted the change that triggered IDEA coroutines debugger crash (#2695, reverted #2291). 238* `watchosX64` target support for Kotlin/Native (#2524). 239* Various documentation fixes and improvements. 240 241## Version 1.5.0-RC 242 243### Channels API 244 245* Major channels API rework (#330, #974). Existing `offer`, `poll`, and `sendBlocking` methods are deprecated, internal `receiveCatching` and `onReceiveCatching` removed, `receiveOrNull` and `onReceiveOrNull` are completely deprecated. Previously deprecated `SendChannel.isFull` declaration is removed. Channel operators deprecated with `ERROR` are now `HIDDEN`. 246* New methods `receiveCatching`, `onReceiveCatching` `trySend`, `tryReceive`, and `trySendBlocking` along with the new result type `ChannelResult` are introduced. They provide better type safety, are less error-prone, and have a consistent future-proof naming scheme. The full rationale behind this change can be found [here](https://github.com/Kotlin/kotlinx.coroutines/issues/974#issuecomment-806569582). 247* `BroadcastChannel` and `ConflatedBroadcastChannel` are marked as `ObsoleteCoroutinesApi` in the favor or `SharedFlow` and `StateFlow`. The migration scheme can be found in their documentation. These classes will be deprecated in the next major release. 248* `callbackFlow` and `channelFlow` are promoted to stable API. 249 250### Reactive integrations 251 252* All existing API in modules `kotlinx-coroutines-rx2`, `kotlinx-coroutines-rx3`, `kotlinx-coroutines-reactive`, `kotlinx-coroutines-reactor`, and `kotlinx-coroutines-jdk9` were revisited and promoted to stable (#2545). 253* `publish` is no longer allowed to emit `null` values (#2646). 254* Misleading `awaitSingleOr*` functions on `Publisher` type are deprecated (#2591). 255* `MaybeSource.await` is deprecated in the favor of `awaitSingle`, additional lint functions for `Mono` are added in order to prevent ambiguous `Publisher` usages (#2628, #1587). 256* `ContextView` support in `kotlinx-coroutines-reactor` (#2575). 257* All reactive builders no longer ignore inner cancellation exceptions preventing their completion (#2262, #2646). 258* `MaybeSource.collect` and `Maybe.collect` properly finish when they are completed without a value (#2617). 259* All exceptions are now consistently handled according to reactive specification, whether they are considered 'fatal' or not by reactive frameworks (#2646). 260 261### Other improvements 262 263* `Flow.last` and `Flow.lastOrNull` operators (#2246). 264* `Flow.runningFold` operator (#2641). 265* `CoroutinesTimeout` rule for JUnit5 (#2197). 266* Internals of `Job` and `AbstractCoroutine` was reworked, resulting in smaller code size, less memory footprint, and better performance (#2513, #2512). 267* `CancellationException` from Kotlin standard library is used for cancellation on Koltin/JS and Kotlin/Native (#2638). 268* Introduced new `DelicateCoroutineApi` annotation that warns users about potential target API pitfalls and suggests studying API's documentation first. The only delicate API right now is `GlobalScope` (#2637). 269* Fixed bug introduced in `1.4.3` when `kotlinx-coroutines-core.jar` triggered IDEA debugger failure (#2619). 270* Fixed memory leak of `ChildHandlerNode` with reusable continuations (#2564). 271* Various documentation improvements (#2555, #2589, #2592, #2583, #2437, #2616, #2633, #2560). 272 273## Version 1.4.3 274 275### General changes 276 277* Thread context is properly preserved and restored for coroutines without `ThreadContextElement` (#985) 278* `ThreadContextElement`s are now restored in the opposite order from update (#2195) 279* Improved performance of combine with 4 parameters, thanks to @alexvanyo (#2419) 280* Debug agent sanitizer leaves at least one frame with source location (#1437) 281* Update Reactor version in `kotlinx-coroutines-reactor` to `3.4.1`, thanks to @sokomishalov (#2432) 282* `callInPlace` contract added to `ReceiveChannel.consume` (#941) 283* `CoroutineStart.UNDISPATCHED` promoted to stable API (#1393) 284* Kotlin updated to 1.4.30 285* `kotlinx.coroutines` are now released directly to MavenCentral 286* Reduced the size of `DispatchedCoroutine` by a field 287* Internal class `TimeSource` renamed to `SchedulerTimeSource` to prevent wildcard import issues (#2537) 288 289### Bug fixes 290 291* Fixed the problem that prevented implementation via delegation for `Job` interface (#2423) 292* Fixed incorrect ProGuard rules that allowed shrinking volatile felds (#1564) 293* Fixed `await`/`asDeferred` for `MinimalStage` implementations in jdk8 module (#2456) 294* Fixed bug when `onUndeliveredElement` wasn't called for unlimited channels (#2435) 295* Fixed a bug when `ListenableFuture.isCancelled` returned from `asListenableFuture` could have thrown an exception, thanks to @vadimsemenov (#2421) 296* Coroutine in `callbackFlow` and `produce` is properly cancelled when the channel was closed separately (#2506) 297 298## Version 1.4.2 299 300* Fixed `StackOverflowError` in `Job.toString` when `Job` is observed in its intermediate state (#2371). 301* Improved liveness and latency of `Dispatchers.Default` and `Dispatchers.IO` in low-loaded mode (#2381). 302* Improved performance of consecutive `Channel.cancel` invocations (#2384). 303* `SharingStarted` is now `fun` interface (#2397). 304* Additional lint settings for `SharedFlow` to catch programmatic errors early (#2376). 305* Fixed bug when mutex and semaphore were not released during cancellation (#2390, thanks to @Tilps for reproducing). 306* Some corner cases in cancellation propagation between coroutines and listenable futures are repaired (#1442, thanks to @vadimsemenov). 307* Fixed unconditional cast to `CoroutineStackFrame` in exception recovery that triggered failures of instrumented code (#2386). 308* Platform-specific dependencies are removed from `kotlinx-coroutines-javafx` (#2360). 309 310## Version 1.4.1 311 312This is a patch release with an important fix to the `SharedFlow` implementation. 313 314* SharedFlow: Fix scenario with concurrent emitters and cancellation of subscriber (#2359, thanks to @vehovsky for the bug report). 315 316## Version 1.4.0 317 318### Improvements 319 320* `StateFlow`, `SharedFlow` and corresponding operators are promoted to stable API (#2316). 321* `Flow.debounce` operator with timeout selector based on each individual element is added (#1216, thanks to @mkano9!). 322* `CoroutineContext.job` extension property is introduced (#2159). 323* `Flow.combine operator` is reworked: 324 * Complete fairness is maintained for single-threaded dispatchers. 325 * Its performance is improved, depending on the use-case, by at least 50% (#2296). 326 * Quadratic complexity depending on the number of upstream flows is eliminated (#2296). 327 * `crossinline` and `inline`-heavy internals are removed, fixing sporadic SIGSEGV on Mediatek Android devices (#1683, #1743). 328* `Flow.zip` operator performance is improved by 40%. 329* Various API has been promoted to stable or its deprecation level has been raised (#2316). 330 331### Bug fixes 332 333* Suspendable `stateIn` operator propagates exception to the caller when upstream fails to produce initial value (#2329). 334* Fix `SharedFlow` with replay for subscribers working at different speed (#2325). 335* Do not fail debug agent installation when security manager does not provide access to system properties (#2311). 336* Cancelled lazy coroutines are properly cleaned up from debug agent output (#2294). 337* `BlockHound` false-positives are correctly filtered out (#2302, #2190, #2303). 338* Potential crash during a race between cancellation and upstream in `Observable.asFlow` is fixed (#2104, #2299, thanks to @LouisCAD and @drinkthestars). 339 340## Version 1.4.0-M1 341 342### Breaking changes 343 344* The concept of atomic cancellation in channels is removed. All operations in channels 345 and corresponding `Flow` operators are cancellable in non-atomic way (#1813). 346* If `CoroutineDispatcher` throws `RejectedExecutionException`, cancel current `Job` and schedule its execution to `Dispatchers.IO` (#2003). 347* `CancellableContinuation.invokeOnCancellation` is invoked if the continuation was cancelled while its resume has been dispatched (#1915). 348* `Flow.singleOrNull` operator is aligned with standard library and does not longer throw `IllegalStateException` on multiple values (#2289). 349 350### New experimental features 351 352* `SharedFlow` primitive for managing hot sources of events with support of various subscription mechanisms, replay logs and buffering (#2034). 353* `Flow.shareIn` and `Flow.stateIn` operators to transform cold instances of flow to hot `SharedFlow` and `StateFlow` respectively (#2047). 354 355### Other 356 357* Support leak-free closeable resources transfer via `onUndeliveredElement` in channels (#1936). 358* Changed ABI in reactive integrations for Java interoperability (#2182). 359* Fixed ProGuard rules for `kotlinx-coroutines-core` (#2046, #2266). 360* Lint settings were added to `Flow` to avoid accidental capturing of outer `CoroutineScope` for cancellation check (#2038). 361 362### External contributions 363 364* Allow nullable types in `Flow.firstOrNull` and `Flow.singleOrNull` by @ansman (#2229). 365* Add `Publisher.awaitSingleOrDefault|Null|Else` extensions by @sdeleuze (#1993). 366* `awaitCancellation` top-level function by @LouisCAD (#2213). 367* Significant part of our Gradle build scripts were migrated to `.kts` by @turansky. 368 369Thank you for your contributions and participation in the Kotlin community! 370 371## Version 1.3.9 372 373* Support of `CoroutineContext` in `Flow.asPublisher` and similar reactive builders (#2155). 374* Kotlin updated to 1.4.0. 375* Transition to new HMPP publication scheme for multiplatform usages: 376 * Artifacts `kotlinx-coroutines-core-common` and `kotlinx-coroutines-core-native` are removed. 377 * For multiplatform usages, it's enough to [depend directly](README.md#multiplatform) on `kotlinx-coroutines-core` in `commonMain` source-set. 378 * The same artifact coordinates can be used to depend on platform-specific artifact in platform-specific source-set. 379 380## Version 1.3.8 381 382### New experimental features 383 384* Added `Flow.transformWhile operator` (#2065). 385* Replaced `scanReduce` with `runningReduce` to be consistent with the Kotlin standard library (#2139). 386 387### Bug fixes and improvements 388 389* Improve user experience for the upcoming coroutines debugger (#2093, #2118, #2131). 390* Debugger no longer retains strong references to the running coroutines (#2129). 391* Fixed race in `Flow.asPublisher` (#2109). 392* Fixed `ensureActive` to work in the empty context case to fix `IllegalStateException` when using flow from `suspend fun main` (#2044). 393* Fixed a problem with `AbortFlowException` in the `Flow.first` operator to avoid erroneous `NoSuchElementException` (#2051). 394* Fixed JVM dependency on Android annotations (#2075). 395* Removed keep rules mentioning `kotlinx.coroutines.android` from core module (#2061 by @mkj-gram). 396* Corrected some docs and examples (#2062, #2071, #2076, #2107, #2098, #2127, #2078, #2135). 397* Improved the docs and guide on flow cancellation (#2043). 398* Updated Gradle version to `6.3` (it only affects multiplatform artifacts in this release). 399 400## Version 1.3.7 401 402* Fixed problem that triggered Android Lint failure (#2004). 403* New `Flow.cancellable()` operator for cooperative cancellation (#2026). 404* Emissions from `flow` builder now check cancellation status and are properly cancellable (#2026). 405* New `currentCoroutineContext` function to use unambiguously in the contexts with `CoroutineScope` in receiver position (#2026). 406* `EXACTLY_ONCE` contract support in coroutine builders. 407* Various documentation improvements. 408 409## Version 1.3.6 410 411### Flow 412 413* `StateFlow`, new primitive for state handling (#1973, #1816, #395). The `StateFlow` is designed to eventually replace `ConflatedBroadcastChannel` for state publication scenarios. Please, try it and share your feedback. Note, that Flow-based primitives to publish events will be added later. For events you should continue to either use `BroadcastChannel(1)`, if you put events into the `StateFlow`, protect them from double-processing with flags. 414* `Flow.onEmpty` operator is introduced (#1890). 415* Behavioural change in `Flow.onCompletion`, it is aligned with `invokeOnCompletion` now and passes `CancellationException` to its cause parameter (#1693). 416* A lot of Flow operators have left its experimental status and are promoted to stable API. 417 418### Other 419 420* `runInterruptible` primitive to tie cancellation with thread interruption for blocking calls. Contributed by @jxdabc (#1947). 421* Integration module with RxJava3 is introduced. Contributed by @ZacSweers (#1883) 422* Integration with [BlockHound](https://github.com/reactor/BlockHound) in `kotlinx-coroutines-debug` module (#1821, #1060). 423* Memory leak in ArrayBroadcastChannel is fixed (#1885). 424* Behavioural change in `suspendCancellableCoroutine`, cancellation is established before invoking passed block argument (#1671). 425* Debug agent internals are moved into `kotlinx-coroutines-core` for better integration with IDEA. It should not affect library users and all the redundant code should be properly eliminated with R8. 426* ClassCastException with reusable continuations bug is fixed (#1966). 427* More precise scheduler detection for `Executor.asCoroutineDispatcher` (#1992). 428* Kotlin updated to 1.3.71. 429 430## Version 1.3.5 431 432* `firstOrNull` operator. Contributed by @bradynpoulsen. 433* `java.time` adapters for Flow operators. Contributed by @fvasco. 434* `kotlin.time.Duration` support (#1402). Contributed by @fvasco. 435* Memory leak with a mix of reusable and non-reusable continuations is fixed (#1855). 436* `DebugProbes` are ready for production installation: its performance is increased, the flag to disable creation stacktraces to reduce the footprint is introduced (#1379, #1372). 437* Stacktrace recovery workaround for Android 6.0 and earlier bug (#1866). 438* New integration module: `kotlinx-coroutines-jdk9` with adapters for `java.util.concurrent.Flow`. 439* `BroadcastChannel.close` properly starts lazy coroutine (#1713). 440* `kotlinx-coroutines-bom` is published without Gradle metadata. 441* Make calls to service loader in reactor integrations optimizable by R8 (#1817). 442 443## Version 1.3.4 444 445### Flow 446 447* Detect missing `awaitClose` calls in `callbackFlow` to make it less error-prone when used with callbacks (#1762, #1770). This change makes `callbackFlow` **different** from `channelFlow`. 448* `ReceiveChannel.asFlow` extension is introduced (#1490). 449* Enforce exception transparency invariant in `flow` builder (#1657). 450* Proper `Dispatcher` support in `Flow` reactive integrations (#1765). 451* Batch `Subscription.request` calls in `Flow` reactive integration (#766). 452* `ObservableValue.asFlow` added to JavaFx integration module (#1695). 453* `ObservableSource.asFlow` added to RxJava2 integration module (#1768). 454 455### Other changes 456 457* `kotlinx-coroutines-core` is optimized for R8, making it much smaller for Android usages (75 KB for `1.3.4` release). 458* Performance of `Dispatchers.Default` is improved (#1704, #1706). 459* Kotlin is updated to 1.3.70. 460* `CoroutineDispatcher` and `ExecutorCoroutineDispatcher` experimental coroutine context keys are introduced (#1805). 461* Performance of various `Channel` operations is improved (#1565). 462 463## Version 1.3.3 464 465### Flow 466* `Flow.take` performance is significantly improved (#1538). 467* `Flow.merge` operator (#1491). 468* Reactive Flow adapters are promoted to stable API (#1549). 469* Reusable cancellable continuations were introduced that improved the performance of various flow operators and iteration over channels (#1534). 470* Fixed interaction of multiple flows with `take` operator (#1610). 471* Throw `NoSuchElementException` instead of `UnsupportedOperationException` for empty `Flow` in `reduce` operator (#1659). 472* `onCompletion` now rethrows downstream exceptions on emit attempt (#1654). 473* Allow non-emitting `withContext` from `flow` builder (#1616). 474 475### Debugging 476 477* `DebugProbes.dumpCoroutines` is optimized to be able to print the 6-digit number of coroutines (#1535). 478* Properly capture unstarted lazy coroutines in debugger (#1544). 479* Capture coroutines launched from within a test constructor with `CoroutinesTimeout` test rule (#1542). 480* Stacktraces of `Job`-related coroutine machinery are shortened and prettified (#1574). 481* Stacktrace recovery unification that should provide a consistent experience recover of stacktrace (#1597). 482* Stacktrace recovery for `withTimeout` is supported (#1625). 483* Do not recover exception with a single `String` parameter constructor that is not a `message` (#1631). 484 485### Other features 486 487* `Dispatchers.Default` and `Dispatchers.IO` rework: CPU consumption is significantly lower, predictable idle threads termination (#840, #1046, #1286). 488* Avoid `ServiceLoader` for loading `Dispatchers.Main` (#1572, #1557, #878, #1606). 489* Consistently handle undeliverable exceptions in RxJava and Reactor integrations (#252, #1614). 490* `yield` support in immediate dispatchers (#1474). 491* `CompletableDeferred.completeWith(result: Result<T>)` is introduced. 492* Added support for tvOS and watchOS-based Native targets (#1596). 493 494### Bug fixes and improvements 495 496* Kotlin version is updated to 1.3.61. 497* `CoroutineDispatcher.isDispatchNeeded` is promoted to stable API (#1014). 498* Livelock and stackoverflows in mutual `select` expressions are fixed (#1411, #504). 499* Properly handle `null` values in `ListenableFuture` integration (#1510). 500* Making ReceiveChannel.cancel linearizability-friendly. 501* Linearizability of Channel.close in a complex contended cases (#1419). 502* ArrayChannel.isBufferEmpty atomicity is fixed (#1526). 503* Various documentation improvements. 504* Reduced bytecode size of `kotlinx-coroutines-core`, reduced size of minified `dex` when using basic functionality of `kotlinx-coroutines`. 505 506## Version 1.3.2 507 508This is a maintenance release that does not include any new features or bug fixes. 509 510* Reactive integrations for `Flow` are promoted to stable API. 511* Obsolete reactive API is deprecated. 512* Deprecation level for API deprecated in 1.3.0 is increased. 513* Various documentation improvements. 514 515## Version 1.3.1 516 517This is a minor update with various fixes: 518* Flow: Fix recursion in combineTransform<T1, T2, R> (#1466). 519* Fixed race in the Semaphore (#1477). 520* Repaired some of ListenableFuture.kt's cancellation corner cases (#1441). 521* Consistently unwrap exception in slow path of CompletionStage.asDeferred (#1479). 522* Various fixes in documentation (#1496, #1476, #1470, #1468). 523* Various cleanups and additions in tests. 524 525Note: Kotlin/Native artifacts are now published with Gradle metadata format version 1.0, so you will need 526Gradle version 5.3 or later to use this version of kotlinx.coroutines in your Kotlin/Native project. 527 528## Version 1.3.0 529 530### Flow 531 532This version is the first stable release with [`Flow`](https://kotlinlang.org/api/kotlinx.coroutines/kotlinx-coroutines-core/kotlinx.coroutines.flow/-flow/index.html) API. 533 534All `Flow` API not marked with `@FlowPreview` or `@ExperimentalCoroutinesApi` annotations are stable and here to stay. 535Flow declarations marked with `@ExperimentalCoroutinesApi` have [the same guarantees](/docs/topics/compatibility.md#experimental-api) as regular experimental API. 536Please note that API marked with `@FlowPreview` have [weak guarantees](/docs/topics/compatibility.md#flow-preview-api) on source, binary and semantic compatibility. 537 538### Changelog 539 540* A new [guide section](/docs/topics/flow.md) about Flow. 541* `CoroutineDispatcher.asExecutor` extension (#1450). 542* Fixed bug when `select` statement could report the same exception twice (#1433). 543* Fixed context preservation in `flatMapMerge` in a case when collected values were immediately emitted to another flow (#1440). 544* Reactive Flow integrations enclosing files are renamed for better interoperability with Java. 545* Default buffer size in all Flow operators is increased to 64. 546* Kotlin updated to 1.3.50. 547 548## Version 1.3.0-RC2 549 550### Flow improvements 551* Operators for UI programming are reworked for the sake of consistency, naming scheme for operator overloads is introduced: 552 * `combineLatest` is deprecated in the favor of `combine`. 553 * `combineTransform` operator for non-trivial transformations (#1224). 554 * Top-level `combine` and `combineTransform` overloads for multiple flows (#1262). 555 * `switchMap` is deprecated. `flatMapLatest`, `mapLatest` and `transformLatest` are introduced instead (#1335). 556 * `collectLatest` terminal operator (#1269). 557 558* Improved cancellation support in `flattenMerge` (#1392). 559* `channelFlow` cancellation does not leak to the parent (#1334). 560* Fixed flow invariant enforcement for `suspend fun main` (#1421). 561* `delayEach` and `delayFlow` are deprecated (#1429). 562 563### General changes 564* Integration with Reactor context 565 * Propagation of the coroutine context of `await` calls into Mono/Flux builder. 566 * Publisher.asFlow propagates coroutine context from `collect` call to the Publisher. 567 * New `Flow.asFlux ` builder. 568 569* ServiceLoader-code is adjusted to avoid I/O on the Main thread on newer (3.6.0+) Android toolchain. 570* Stacktrace recovery support for minified builds on Android (#1416). 571* Guava version in `kotlinx-coroutines-guava` updated to `28.0`. 572* `setTimeout`-based JS dispatcher for platforms where `process` is unavailable (#1404). 573* Native, JS and common modules are added to `kotlinx-coroutines-bom`. 574* Fixed bug with ignored `acquiredPermits` in `Semaphore` (#1423). 575 576## Version 1.3.0-RC 577 578### Flow 579 580* Core `Flow` API is promoted to stable 581* New basic `Flow` operators: `withIndex`, `collectIndexed`, `distinctUntilChanged` overload 582* New core `Flow` operators: `onStart` and `onCompletion` 583* `ReceiveChannel.consumeAsFlow` and `emitAll` (#1340) 584 585### General changes 586 587* Kotlin updated to 1.3.41 588* Added `kotlinx-coroutines-bom` with Maven Bill of Materials (#1110) 589* Reactive integrations are seriously improved 590 * All builders now are top-level functions instead of extensions on `CoroutineScope` and prohibit `Job` instance in their context to simplify lifecycle management 591 * Fatal exceptions are handled consistently (#1297) 592 * Integration with Reactor Context added (#284) 593* Stacktrace recovery for `suspend fun main` (#1328) 594* `CoroutineScope.cancel` extension with message (#1338) 595* Protection against non-monotonic clocks in `delay` (#1312) 596* `Duration.ZERO` is handled properly in JDK 8 extensions (#1349) 597* Library code is adjusted to be more minification-friendly 598 599## Version 1.3.0-M2 600 601 * Kotlin updated to 1.3.40. 602 * `Flow` exception transparency concept. 603 * New declarative `Flow` operators: `onCompletion`, `catch`, `retryWhen`, `launchIn`. `onError*` operators are deprecated in favour of `catch`. (#1263) 604 * `Publisher.asFlow` is integrated with `buffer` operator. 605 * `Publisher.openSubscription` default request size is `1` instead of `0` (#1267). 606 607## Version 1.3.0-M1 608 609Flow: 610 * Core `Flow` interfaces and operators are graduated from preview status to experimental. 611 * Context preservation invariant rework (#1210). 612 * `channelFlow` and `callbackFlow` replacements for `flowViaChannel` for concurrent flows or callback-based APIs. 613 * `flow` prohibits emissions from non-scoped coroutines by default and recommends to use `channelFlow` instead to avoid most of the concurrency-related bugs. 614 * Flow cannot be implemented directly 615 * `AbstractFlow` is introduced for extension (e.g. for managing state) and ensures all context preservation invariants. 616 * Buffer size is decoupled from all operators that imply channel usage (#1233) 617 * `buffer` operator can be used to adjust buffer size of any buffer-dependent operator (e.g. `channelFlow`, `flowOn` and `flatMapMerge`). 618 * `conflate` operator is introduced. 619 * Flow performance is significantly improved. 620 * New operators: `scan`, `scanReduce`, `first`, `emitAll`. 621 * `flowWith` and `flowViaChannel` are deprecated. 622 * `retry` ignores cancellation exceptions from upstream when the flow was externally cancelled (#1122). 623 * `combineLatest` overloads for multiple flows (#1193). 624 * Fixed numerical overflow in `drop` operator. 625 626Channels: 627 * `consumeEach` is promoted to experimental API (#1080). 628 * Conflated channels always deliver the latest value after closing (#332, #1235). 629 * Non-suspending `ChannelIterator.next` to improve iteration performance (#1162). 630 * Channel exception types are consistent with `produce` and are no longer swallowed as cancellation exceptions in case of programmatic errors (#957, #1128). 631 * All operators on channels (that were prone to coroutine leaks) are deprecated in the favor of `Flow`. 632 633General changes: 634 * Kotlin updated to 1.3.31 635 * `Semaphore` implementation (#1088) 636 * Loading of `Dispatchers.Main` is tweaked so the latest version of R8 can completely remove I/O when loading it (#1231). 637 * Performace of all JS dispatchers is significantly improved (#820). 638 * `withContext` checks cancellation status on exit to make reasoning about sequential concurrent code easier (#1177). 639 * Consistent exception handling mechanism for complex hierarchies (#689). 640 * Convenient overload for `CoroutinesTimeout.seconds` (#1184). 641 * Fix cancellation bug in onJoin (#1130). 642 * Prevent internal names clash that caused errors for ProGuard (#1159). 643 * POSIX's `nanosleep` as `delay` in `runBlocking ` in K/N (#1225). 644 645## Version 1.2.2 646 647* Kotlin updated to 1.3.40. 648 649## Version 1.2.1 650 651Major: 652 * Infrastructure for testing coroutine-specific code in `kotlinx-coroutines-test`: `runBlockingTest`, `TestCoroutineScope` and `TestCoroutineDispatcher`, contributed by Sean McQuillan (@objcode). Obsolete `TestCoroutineContext` from `kotlinx-coroutines-core` is deprecated. 653 * `Job.asCompletableFuture` extension in jdk8 module (#1113). 654 655Flow improvements: 656 * `flowViaChannel` rework: block parameter is no longer suspending, but provides `CoroutineScope` receiver and allows conflated channel (#1081, #1112). 657 * New operators: `switchMap`, `sample`, `debounce` (#1107). 658 * `consumerEach` is deprecated on `Publisher`, `ObservableSource` and `MaybeSource`, `collect` extension is introduced instead (#1080). 659 660Other: 661 * Race in Job.join and concurrent cancellation is fixed (#1123). 662 * Stacktrace recovery machinery improved: cycle detection works through recovered exceptions, cancellation exceptions are recovered on cancellation fast-path. 663 * Atomicfu-related bug fixes: publish transformed artifacts, do not propagate transitive atomicfu dependency (#1064, #1116). 664 * Publication to NPM fixed (#1118). 665 * Misplaced resources are removed from the final jar (#1131). 666 667## Version 1.2.0 668 669 * Kotlin updated to 1.3.30. 670 * New API: `CancellableContinuation.resume` with `onCancelling` lambda (#1044) to consistently handle closeable resources. 671 * Play services task version updated to 16.0.1. 672 * `ReceiveChannel.isEmpty` is no longer deprecated 673 674A lot of `Flow` improvements: 675 * Purity property is renamed to context preservation and became more restrictive. 676 * `zip` and `combineLatest` operators. 677 * Integration with RxJava2 678 * `flatMap`, `merge` and `concatenate` are replaced with `flattenConcat`, `flattenMerge`, `flatMapConcat` and `flatMapMerge`. 679 * Various documentation improvements and minor bug fixes. 680 681Note that `Flow` **is not** leaving its [preview status](/docs/topics/compatibility.md#flow-preview-api). 682 683## Version 1.2.0-alpha-2 684 685This release contains major [feature preview](/docs/topics/compatibility.md#flow-preview-api): cold streams aka `Flow` (#254). 686 687Performance: 688* Performance of `Dispatcher.Main` initialization is significantly improved (#878). 689 690## Version 1.2.0-alpha 691 692* Major debug agent improvements. Real stacktraces are merged with coroutine stacktraces for running coroutines, merging heuristic is improved, API is cleaned up and is on its road to stabilization (#997). 693* `CoroutineTimeout` rule or JUnit4 is introduced to simplify coroutines debugging (#938). 694* Stacktrace recovery improvements. Exceptions with custom properties are no longer copied, `CopyableThrowable` interface is introduced, machinery is [documented](https://github.com/Kotlin/kotlinx.coroutines/blob/develop/docs/debugging.md) (#921, #950). 695* `Dispatchers.Unconfined`, `MainCoroutineDispatcher.immediate`, `MainScope` and `CoroutineScope.cancel` are promoted to stable API (#972). 696* `CompletableJob` is introduced (#971). 697* Structured concurrency is integrated into futures and listenable futures (#1008). 698* `ensurePresent` and `isPresent` extensions for `ThreadLocal` (#1028). 699* `ensureActive` extensions for `CoroutineContext`, `CoroutineScope` and `Job` (#963). 700* `SendChannel.isFull` and `ReceiveChannel.isEmpty` are deprecated (#1053). 701* `withContext` checks cancellation on entering (#962). 702* Operator `invoke` on `CoroutineDispatcher` (#428). 703* Java 8 extensions for `delay` and `withTimeout` now properly handle too large values (#428). 704* A global exception handler for fatal exceptions in coroutines is introduced (#808, #773). 705* Major improvements in cancellation machinery and exceptions delivery consistency. Cancel with custom exception is completely removed. 706* Kotlin version is updated to 1.3.21. 707* Do not use private API on newer Androids to handle exceptions (#822). 708 709Bug fixes: 710* Proper `select` support in debug agent (#931). 711* Proper `supervisorScope` support in debug agent (#915). 712* Throwing `initCause` does no longer trigger an internal error (#933). 713* Lazy actors are started when calling `close` in order to cleanup their resources (#939). 714* Minor bugs in reactive integrations are fixed (#1008). 715* Experimental scheduler shutdown sequence is fixed (#990). 716 717## Version 1.1.1 718 719* Maintenance release, no changes in the codebase 720* Kotlin is updated to 1.3.20 721* Gradle is updated to 4.10 722* Native module is published with Gradle metadata v0.4 723 724## Version 1.1.0 725 726* Kotlin version updated to 1.3.11. 727* Resumes to `CancellableContinuation` in the final state produce `IllegalStateException` (#901). This change does not affect #830, races between resume and cancellation do not lead to an exceptional situation. 728* `runBlocking` is integrated with `Dispatchers.Unconfined` by sharing an internal event loop. This change does not affect the semantics of the previously correct code but allows to mix multiple `runBlocking` and unconfined tasks (#860). 729 730## Version 1.1.0-alpha 731 732### Major improvements in coroutines testing and debugging 733* New module: [`kotlinx-coroutines-debug`](https://github.com/Kotlin/kotlinx.coroutines/blob/master/core/kotlinx-coroutines-debug/README.md). Debug agent that improves coroutines stacktraces, allows to print all active coroutines and its hierarchies and can be installed as Java agent. 734* New module: [`kotlinx-coroutines-test`](https://github.com/Kotlin/kotlinx.coroutines/blob/master/core/kotlinx-coroutines-test/README.md). Allows setting arbitrary `Dispatchers.Main` implementation for tests (#810). 735* Stacktrace recovery mechanism. Exceptions from coroutines are recovered from current coroutine stacktraces to simplify exception diagnostic. Enabled in debug mode, controlled by `kotlinx.coroutines.debug` system property (#493). 736 737### Other improvements 738* `MainScope` factory and `CoroutineScope.cancel` extension (#829). One line `CoroutineScope` integration! 739* `CancellableContinuation` race between `resumeWithException` and `cancel` is addressed, exceptions during cancellation are no longer reported to exception handler (#830, #892). 740* `Dispatchers.Default` now consumes much less CPU on JVM (#840). 741* Better diagnostic and fast failure if an uninitialized dispatcher is used (#880). 742* Conflated channel becomes linearizable. 743* Fixed inconsistent coroutines state when the result of the coroutine had type `DisposableHandle` (#835). 744* Fixed `JavaFx` initialization bug (#816). 745* `TimeoutCancellationException` is thrown by `withTimeout` instead of `CancellationException` if negative timeout is supplied (#870). 746* Kotlin/Native single-threaded workers support: coroutines can be safely used in multiple independent K/N workers. 747* jsdom support in `Dispatchers.Default` on JS. 748* rxFlowable generic parameter is now restricted with Any. 749* Guava 27 support in `kotlinx-coroutines-guava`. 750* Coroutines are now built with progressive mode. 751* Various fixes in the documentation. 752 753## Version 1.0.1 754 755* Align `publisher` implementation with Reactive TCK. 756* Reimplement `future` coroutine builders on top of `AbstractCoroutine` (#751). 757* Performance optimizations in `Dispatchers.Default` and `Dispatchers.IO`. 758* Use only public API during `JavaFx` instantiation, fixes warnings on Java 9 and build on Java 11 (#463). 759* Updated contract of `CancellableContinuation.resumeWithException` (documentation fix, see #712). 760* Check cancellation on fast-path of all in-place coroutine builders (`withContext`, `coroutineScope`, `supervisorScope`, `withTimeout` and `withTimeoutOrNull`). 761* Add optional prefix to thread names of `ExperimentalCoroutineDispatcher` (#661). 762* Fixed bug when `ExperimentalCoroutineDispatcher` could end up in inconsistent state if `Thread` constructor throws an exception (#748). 763 764## Version 1.0.0 765 766* All Kotlin dependencies updated to 1.3 release version. 767* Fixed potential memory leak in `HandlerDispatcher.scheduleResumeAfterDelay`, thanks @cbeyls. 768* `yield` support for `Unconfined` and immediate dispatchers (#737). 769* Various documentation improvements. 770 771## Version 1.0.0-RC1 772 773* Coroutines API is updated to Kotlin 1.3. 774* Deprecated API is removed or marked as `internal`. 775* Experimental and internal coroutine API is marked with corresponding `kotlin.experimental.Experimental` annotation. If you are using `@ExperimentalCoroutinesApi` or `@InternalCoroutinesApi` you should explicitly opt-in, otherwise compilation warning (or error) will be produced. 776* `Unconfined` dispatcher (and all dispatchers which support immediate invocation) forms event-loop on top of current thread, thus preventing all `StackOverflowError`s. `Unconfined` dispatcher is now much safer for the general use and may leave its experimental status soon (#704). 777* Significantly improved performance of suspending hot loops in `kotlinx.coroutines` (#537). 778* Proguard rules are embedded into coroutines JAR to assist jettifier (#657) 779* Fixed bug in shutdown sequence of `runBlocking` (#692). 780* `ReceiveChannel.receiveOrNull` is marked as obsolete and deprecated. 781* `Job.cancel(cause)` and `ReceiveChannel.cancel(cause)` are deprecated, `cancel()` returns `Unit` (#713). 782 783## Version 0.30.2 784 785* `Dispatchers.Main` is instantiated lazily (see #658 and #665). 786* Blocking coroutine dispatcher views are now shutdown properly (#678). 787* Prevent leaking Kotlin 1.3 from atomicfu dependency (#659). 788* Thread-pool based dispatcher factories are marked as obsolete (#261). 789* Fixed exception loss on `withContext` cancellation (#675). 790 791## Version 0.30.1 792 793Maintenance release: 794* Added `Dispatchers.Main` to common dispatchers, which can be used from Android, Swing and JavaFx projects if a corresponding integration library is added to dependencies. 795* With `Dispatchers.Main` improvement tooling bug in Android Studio #626 is mitigated, so Android users now can safely start the migration to the latest `kotlinx.coroutines` version. 796* Fixed bug with thread unsafety of shutdown sequence in `EventLoop`. 797* Experimental coroutine dispatcher now has `close` contract similar to Java `Executor`, so it can be safely instantiated and closed multiple times (affects only unit tests). 798* Atomicfu version is updated with fixes in JS transformer (see #609) 799 800## Version 0.30.0 801 802* **[Major]** Further improvements in exception handling — no failure exception is lost. 803 * `async` and async-like builders cancel parent on failure (it affects `CompletableDeferred`, and all reactive integration builders). 804 * This makes parallel decomposition exception-safe and reliable without having to rember about `awaitAll` (see #552). 805 * `Job()` wih parent now also cancels parent on failure consistently with other scopes. 806 * All coroutine builders and `Job` implementations propagate failure to the parent unless it is a `CancellationException`. 807 * Note, "scoping" builders don't "cancel the parent" verbatim, but rethrow the corresponding exception to the caller for handling. 808 * `SupervisorJob()` and `supervisorScope { ... }` are introduced, allowing for a flexible implementation of custom exception-handling policies, see a [new section in the guide on supervision](docs/topics/exception-handling.md#supervision). 809 * Got rid of `awaitAll` in documentation and rewrote `currentScope` section (see #624). 810* **[Major]** Coroutine scheduler is used for `Dispatchers.Default` by default instead of deprecated `CommonPool`. 811 * "`DefaultDispatcher`" is used as a public name of the default impl (you'll see it thread names and in the guide). 812 * `-Dkotlinx.coroutines.scheduler=off` can be used to switch back to `CommonPool` for a time being (until deprecated CommonPool is removed). 813* Make `CoroutineStart.ATOMIC` experimental as it covers important use-case with resource cleanup in finally block (see #627). 814* Restored binary compatibility of `Executor.asCoroutineDispatcher` (see #629). 815* Fixed OOM in thread-pool dispatchers (see #571). 816* Check for cancellation when starting coroutine with `Dispatchers.Unconfined` (see #621). 817* A bunch of various performance optimizations and docs fixes, including contributions from @AlexanderPrendota, @PaulWoitaschek. 818 819## Version 0.27.0 820 821* **[Major]** Public API revision. All public API was reviewed and marked as preparation to `1.0` release: 822 1. `@Deprecated` API. All API marked as deprecated will be removed in 1.0 release without replacement. 823 2. `@ExperimentalCoroutinesApi` API. This API is experimental and may change in the future, but migration mechanisms will be provided. Signature, binary compatibility and semantics can be changed. 824 3. `@InternalCoroutinesApi`. This API is intended to be used **only** from within `kotlinx.coroutines`. It can and will be changed, broken 825 and removed in the future releases without any warnings and migration aids. If you find yourself using this API, it is better to report 826 your use-case to Github issues, so decent, stable and well-tested alternative can be provided. 827 4. `@ObsoleteCoroutinesApi`. This API has serious known flaws and will be replaced with a better alternative in the nearest releases. 828 5. Regular public API. This API is proven to be stable and is not going to be changed. If at some point it will be discovered that such API 829 has unfixable design flaws, it will be gradually deprecated with proper replacement and migration aid, but won't be removed for at least a year. 830* **[Major]** Job state machine is reworked. It includes various performance improvements, fixes in 831data-races which could appear in a rare circumstances and consolidation of cancellation and exception handling. 832Visible consequences of include more robust exception handling for large coroutines hierarchies and for different kinds of `CancellationException`, transparent parallel decomposition and consistent view of coroutines hierarchy in terms of its state (see #220 and #585). 833* NIO, Quasar and Rx1 integration modules are removed with no replacement (see #595, #601, #603). 834* `withContext` is now aligned with structured concurrency and awaits for all launched tasks, its performance is significantly improved (see #553 and #617). 835* Added integration module with Play Services Task API. Thanks @SUPERCILEX and @lucasvalenteds for the contribution! 836* Integration with Rx2 now respects nullability in type constraints (see #347). Thanks @Dmitry-Borodin for the contribution! 837* `CompletableFuture.await` and `ListenableFuture.await` now propagate cancellation to the future (see #611). 838* Cancellation of `runBlocking` machinery is improved (see #589). 839* Coroutine guide is restructured and split to multiple files for the sake of simplicity. 840* `CoroutineScope` factory methods add `Job` if it is missing from the context to enforce structured concurrency (see #610). 841* `Handler.asCoroutineDispatcher` has a `name` parameter for better debugging (see #615). 842* Fixed bug when `CoroutineSchedule` was closed from one of its threads (see #612). 843* Exceptions from `CoroutineExceptionHandler` are reported by default exception handler (see #562). 844* `CoroutineName` is now available from common modules (see #570). 845* Update to Kotlin 1.2.70. 846 847## Version 0.26.1 848 849* Android `Main` dispatcher is `async` by default which may significantly improve UI performance. Contributed by @JakeWharton (see #427). 850* Fixed bug when lazily-started coroutine with registered cancellation handler was concurrently started and cancelled. 851* Improved termination sequence in IO dispatcher. 852* Fixed bug with `CoroutineScope.plus` operator (see #559). 853* Various fixes in the documentation. Thanks to @SUPERCILEX, @yorlov, @dualscyther and @soudmaijer! 854 855## Version 0.26.0 856 857* Major rework of `kotlinx.coroutines` concurrency model (see #410 for a full explanation of the rationale behind this change): 858 * All coroutine builders are now extensions on `CoroutineScope` and inherit its `coroutineContext`. Standalone builders are deprecated. 859 * As a consequence, all nested coroutines launched via builders now automatically establish parent-child relationship and inherit `CoroutineDispatcher`. 860 * All coroutine builders use `Dispatchers.Default` by default if `CoroutineInterceptor` is not present in their context. 861 * [CoroutineScope](https://kotlinlang.org/api/kotlinx.coroutines/kotlinx-coroutines-core/kotlinx.coroutines/-coroutine-scope/index.html) became the first-class citizen in `kolinx.coroutines`. 862 * `withContext` `block` argument has `CoroutineScope` as a receiver. 863 * [GlobalScope](https://kotlinlang.org/api/kotlinx.coroutines/kotlinx-coroutines-core/kotlinx.coroutines/-global-scope/index.html) is introduced to simplify migration to new API and to launch global-level coroutines. 864 * `currentScope` and `coroutineScope` builders are introduced to extract and provide `CoroutineScope`. 865 * Factory methods to create `CoroutineScope` from `CoroutineContext` are introduced. 866 * `CoroutineScope.isActive` became an extension property. 867 * New sections about structured concurrency in core guide: ["Structured concurrency"](docs/topics/coroutines-guide.md#structured-concurrency), ["Scope builder"](docs/topics/coroutines-guide.md#scope-builder) and ["Structured concurrency with async"](docs/topics/coroutines-guide.md#structured-concurrency-with-async). 868 * 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). 869 * Deprecated reactive API is removed. 870* Dispatchers are renamed and grouped in the Dispatchers object (see #41 and #533): 871 * Dispatcher names are consistent. 872 * Old dispatchers including `CommonPool` are deprecated. 873* Fixed bug with JS error in rare cases in `invokeOnCompletion(onCancelling = true)`. 874* Fixed loading of Android exception handler when `Thread.contextClassLoader` is mocked (see #530). 875* Fixed bug when `IO` dispatcher silently hung (see #524 and #525) . 876 877## Version 0.25.3 878 879* Distribution no longer uses multi-version jar which is not supported on Android (see #510). 880* JS version of the library does not depend on AtomicFu anymore: 881 All the atomic boxes in JS are fully erased. 882* Note that versions 0.25.1-2 are skipped for technical reasons (they were not fully released). 883 884## Version 0.25.0 885 886* Major rework on exception-handling and cancellation in coroutines (see #333, #452 and #451): 887 * New ["Exception Handling" section in the guide](docs/topics/coroutines-guide.md#exception-handling) explains exceptions in coroutines. 888 * Semantics of `Job.cancel` resulting `Boolean` value changed — `true` means exception was handled by the job, caller shall handle otherwise. 889 * Exceptions are properly propagated from children to parents. 890 * Installed `CoroutineExceptionHandler` for a family of coroutines receives one aggregated exception in case of failure. 891 * Change `handleCoroutineException` contract, so custom exception handlers can't break coroutines machinery. 892 * Unwrap `JobCancellationException` properly to provide exception transparency over whole call chain. 893* Introduced support for thread-local elements in coroutines context (see #119): 894 * `ThreadContextElement` API for custom thread-context sensitive context elements. 895 * `ThreadLocal.asContextElement()` extension function to convert an arbitrary thread-local into coroutine context element. 896 * New ["Thread-local data" subsection in the guide](docs/topics/coroutines-guide.md#thread-local-data) with examples. 897 * SLF4J Mapped Diagnostic Context (MDC) integration is provided via `MDCContext` element defined in [`kotlinx-coroutines-slf4j`](integration/kotlinx-coroutines-slf4j/README.md) integration module. 898* Introduced IO dispatcher to offload blocking I/O-intensive tasks (see #79). 899* Introduced `ExecutorCoroutineDispatcher` instead of `CloseableCoroutineDispatcher` (see #385). 900* Built with Kotlin 1.2.61 and Kotlin/Native 0.8.2. 901* JAR files for `kotlinx-coroutines` are now [JEP 238](https://openjdk.java.net/jeps/238) multi-release JAR files. 902 * On JDK9+ `VarHandle` is used for atomic operations instead of `Atomic*FieldUpdater` for better performance. 903 * See [AtomicFu](https://github.com/Kotlin/kotlinx.atomicfu/blob/master/README.md) project for details. 904* Reversed addition of `BlockingChecker` extension point to control where `runBlocking` can be used (see #227). 905 * `runBlocking` can be used anywhere without limitations (again), but it would still cause problems if improperly used on UI thread. 906* Corrected return-type of `EventLoop` pseudo-constructor (see #477, PR by @Groostav). 907* Fixed `as*Future()` integration functions to catch all `Throwable` exceptions (see #469). 908* Fixed `runBlocking` cancellation (see #501). 909* Fixed races and timing bugs in `withTimeoutOrNull` (see #498). 910* Execute `EventLoop.invokeOnTimeout` in `DefaultDispatcher` to allow busy-wait loops inside `runBlocking` (see #479). 911* Removed `kotlinx-coroutines-io` module from the project, it has moved to [kotlinx-io](https://github.com/kotlin/kotlinx-io/). 912* Provide experimental API to create limited view of experimental dispatcher (see #475). 913* Various minor fixes by @LouisCAD, @Dmitry-Borodin. 914 915## Version 0.24.0 916 917* Fully multiplatform release with Kotlin/Native support (see #246): 918 * Only single-threaded operation inside `runBlocking` event loop is supported at this moment. 919 * See details on setting up build environment [here](native/README.md). 920* Improved channels: 921 * Introduced `SendChannel.invokeOnClose` (see #341). 922 * Make `close`, `cancel`, `isClosedForSend`, `isClosedForReceive` and `offer` linearizable with other operations (see #359). 923 * Fixed bug when send operation can be stuck in channel forever. 924 * Fixed broadcast channels on JS (see #412). 925* Provides `BlockingChecker` mechanism which checks current context (see #227). 926 * Attempts to use `runBlocking` from any supported UI thread (Android, JavaFx, Swing) will result in exception. 927* Android: 928 * Worked around Android bugs with zero-size ForkJoinPool initialization (see #432, #288). 929 * Introduced `UI.immediate` extension as performance-optimization to immediately execute tasks which are invoked from the UI thread (see #381). 930 * Use it only when absolutely needed. It breaks asynchrony of coroutines and may lead to surprising and unexpected results. 931* Fixed materialization of a `cause` exception for `Job` onCancelling handlers (see #436). 932* Fixed JavaFx `UI` on Java 9 (see #443). 933* Fixed and documented the order between cancellation handlers and continuation resume (see #415). 934* Fixed resumption of cancelled continuation (see #450). 935* Includes multiple fixes to documentation contributed by @paolop, @SahilLone, @rocketraman, @bdavisx, @mtopolnik, @Groostav. 936* Experimental coroutines scheduler preview (JVM only): 937 * Written from scratch and optimized for communicating coroutines. 938 * Performs significantly better than ForkJoinPool on coroutine benchmarks and for connected applications with [ktor](https://ktor.io). 939 * 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. 940 * For preview, run JVM with `-Dkotlinx.coroutines.scheduler` option. In this case `DefaultDispatcher` is set to new experimental scheduler instead of FJP-based `CommonPool`. 941 * Submit your feedback to issue #261. 942 943## Version 0.23.4 944 945* Recompiled with Kotlin 1.2.51 to solve broken metadata problem (see [KT-24944](https://youtrack.jetbrains.com/issue/KT-24944)). 946 947## Version 0.23.3 948 949* Kotlin 1.2.50. 950* JS: Moved to atomicfu version 0.10.3 that properly matches NPM & Kotlin/JS module names (see #396). 951* Improve source-code compatibility with previous (0.22.x) version of `openChannel().use { ... }` pattern by providing deprecated extension function `use` on `ReceiveChannel`. 952 953## Version 0.23.2 954 955* IO: fix joining and continuous writing byte array interference. 956 957## Version 0.23.1 958 959* JS: Fix dependencies in NPM: add "kotlinx-atomicfu" dependency (see #370). 960* Introduce `broadcast` coroutine builder (see #280): 961 * Support `BroadcastChannel.cancel` method to drop the buffer. 962 * Introduce `ReceiveChannel.broadcast()` extension. 963* Fixed a bunch of doc typos (PRs by @paolop). 964* Corrected previous version's release notes (PR by @ansman). 965 966## Version 0.23.0 967 968* Kotlin 1.2.41 969* **Coroutines core module is made mostly cross-platform for JVM and JS**: 970 * Migrate channels and related operators to common, so channels can be used from JS (see #201). 971 * Most of the code is shared between JVM and JS versions using cross-platform version of [AtomicFU](https://github.com/Kotlin/kotlinx.atomicfu) library. 972 * The recent version of Kotlin allows default parameters in common code (see #348). 973 * The project is built using Gradle 4.6. 974* **Breaking change**: `CancellableContinuation` is not a `Job` anymore (see #219): 975 * It does not affect casual users of `suspendCancellableCoroutine`, since all the typically used functions are still there. 976 * `CancellableContinuation.invokeOnCompletion` is deprecated now and its semantics had subtly changed: 977 * `invokeOnCancellation` is a replacement for `invokeOnCompletion` to install a handler. 978 * The handler is **not** invoked on `resume` which corresponds to the typical usage pattern. 979 * There is no need to check for `cont.isCancelled` in a typical handler code anymore (since handler is invoked only when continuation is cancelled). 980 * Multiple cancellation handlers cannot be installed. 981 * Cancellation handlers cannot be removed (disposed of) anymore. 982 * This change is designed to allow better performance of suspending cancellable functions: 983 * Now `CancellableContinuation` implementation has simpler state machine and is implemented more efficiently. 984 * Exception handling in `AbstractContinuation` (that implements `CancellableContinuation`) is now consistent: 985 * Always prefer exception thrown from coroutine as exceptional reason, add cancellation cause as suppressed exception. 986* **Big change**: Deprecate `CoroutineScope.coroutineContext`: 987 * It is replaced with top-level `coroutineContext` function from Kotlin standard library. 988* Improve `ReceiveChannel` operators implementations to guarantee closing of the source channels under all circumstances (see #279): 989 * `onCompletion` parameter added to `produce` and all other coroutine builders. 990 * Introduce `ReceiveChannel.consumes(): CompletionHandler` extension function. 991* Replace `SubscriptionReceiveChannel` with `ReceiveChannel` (see #283, PR by @deva666). 992 * `ReceiveChannel.use` extension is introduced to preserve source compatibility, but is deprecated. 993 * `consume` or `consumeEach` extensions should be used for channels. 994 * When writing operators, `produce(onCompletion=consumes()) { ... }` pattern shall be used (see #279 above). 995* JS: Kotlin is declared as peer dependency (see #339, #340, PR by @ansman). 996* Invoke exception handler for actor on cancellation even when channel was successfully closed, so exceptions thrown by actor are always reported (see #368). 997* Introduce `awaitAll` and `joinAll` for `Deferred` and `Job` lists correspondingly (see #171). 998* Unwrap `CompletionException` exception in `CompletionStage.await` slow-path to provide consistent results (see #375). 999* Add extension to `ExecutorService` to return `CloseableCoroutineDispatcher` (see #278, PR by @deva666). 1000* Fail with proper message during build if JDK_16 is not set (see #291, PR by @venkatperi). 1001* Allow negative timeouts in `delay`, `withTimeout` and `onTimeout` (see #310). 1002* Fix a few bugs (leaks on cancellation) in `delay`: 1003 * Invoke `clearTimeout` on cancellation in JSDispatcher. 1004 * Remove delayed task on cancellation from internal data structure on JVM. 1005* Introduce `ticker` function to create "ticker channels" (see #327): 1006 * It provides analogue of RX `Observable.timer` for coroutine channels. 1007 * It is currently supported on JVM only. 1008* Add a test-helper class `TestCoroutineContext` (see #297, PR by @streetsofboston). 1009 * It is currently supported on JVM only. 1010 * Ticker channels (#327) are not yet compatible with it. 1011* Implement a better way to set `CoroutineContext.DEBUG` value (see #316, PR by @dmytrodanylyk): 1012 * Made `CoroutineContext.DEBUG_PROPERTY_NAME` constant public. 1013 * Introduce public constants with `"on"`, `"off"`, `"auto"` values. 1014* Introduce system property to control `CommonPool` parallelism (see #343): 1015 * `CommonPool.DEFAULT_PARALLELISM_PROPERTY_NAME` constant is introduced with a value of "kotlinx.coroutines.default.parallelism". 1016* Include package-list files into documentation site (see #290). 1017* Fix various typos in docs (PRs by @paolop and @ArtsiomCh). 1018 1019## Version 0.22.5 1020 1021* JS: Fixed main file reference in [NPM package](https://www.npmjs.com/package/kotlinx-coroutines-core) 1022* Added context argument to `Channel.filterNot` (PR by @jcornaz). 1023* Implemented debug `toString` for channels (see #185). 1024 1025## Version 0.22.4 1026 1027* JS: Publish to NPM (see #229). 1028* JS: Use node-style dispatcher on ReactNative (see #236). 1029* [jdk8 integration](integration/kotlinx-coroutines-jdk8/README.md) improvements: 1030 * Added conversion from `CompletionStage` to `Deferred` (see #262, PR by @jcornaz). 1031 * Use fast path in `CompletionStage.await` and make it cancellable. 1032 1033## Version 0.22.3 1034 1035* Fixed `produce` builder to close the channel on completion instead of cancelling it, which lead to lost elements with buffered channels (see #256). 1036* Don't use `ForkJoinPool` if there is a `SecurityManager` present to work around JNLP problems (see #216, PR by @NikolayMetchev). 1037* JS: Check for undefined `window.addEventListener` when choosing default coroutine dispatcher (see #230, PR by @ScottPierce). 1038* Update 3rd party dependencies: 1039 * [kotlinx-coroutines-rx1](reactive/kotlinx-coroutines-rx1) to RxJava version `1.3.6`. 1040 * [kotlinx-coroutines-rx2](reactive/kotlinx-coroutines-rx2) to RxJava version `2.1.9`. 1041 * [kotlinx-coroutines-guava](integration/kotlinx-coroutines-guava) to Guava version `24.0-jre`. 1042 1043## Version 0.22.2 1044 1045* Android: Use @Keep annotation on AndroidExceptionPreHandler to fix the problem on Android with minification enabled (see #214). 1046* Reactive: Added `awaitFirstOrDefault` and `awaitFirstOrNull` extensions (see #224, PR by @konrad-kaminski). 1047* Core: Fixed `withTimeout` and `withTimeoutOrNull` that should not use equals on result (see #212, PR by @konrad-kaminski). 1048* Core: Fixed hanged receive from a closed subscription of BroadcastChannel (see #226). 1049* IO: fixed error propagation (see https://github.com/ktorio/ktor/issues/301). 1050* Include common sources into sources jar file to work around KT-20971. 1051* Fixed bugs in documentation due to MPP. 1052 1053## Version 0.22.1 1054 1055* Migrated to Kotlin 1.2.21. 1056* Improved `actor` builder documentation (see #210) and fixed bugs in rendered documentation due to multiplatform. 1057* Fixed `runBlocking` to properly support specified dispatchers (see #209). 1058* Fixed data race in `Job` implementation (it was hanging at `LockFreeLinkedList.helpDelete` on certain stress tests). 1059* `AbstractCoroutine.onCancellation` is invoked before cancellation handler that is set via `invokeOnCompletion`. 1060* Ensure that `launch` handles uncaught exception before another coroutine that uses `join` on it resumes (see #208). 1061 1062## Version 0.22 1063 1064* Migrated to Kotlin 1.2.20. 1065* Introduced stable public API for `AbstractCoroutine`: 1066 * Implements `Job`, `Continuation`, and `CoroutineScope`. 1067 * Has overridable `onStart`, `onCancellation`, `onCompleted` and `onCompletedExceptionally` functions. 1068 * Reactive integration modules are now implemented using public API only. 1069 * Notifies onXXX before all the installed handlers, so `launch` handles uncaught exceptions before "joining" coroutines wakeup (see #208). 1070 1071## Version 0.21.2 1072 1073* Fixed `openSubscription` extension for reactive `Publisher`/`Observable`/`Flowable` when used with `select { ... }` and added an optional `request` parameter to specify how many elements are requested from publisher in advance on subscription (see #197). 1074* Simplified implementation of `Channel.flatMap` using `toChannel` function to work around Android 5.0 APK install SIGSEGV (see #205). 1075 1076## Version 0.21.1 1077 1078* Improved performance of coroutine dispatching (`DispatchTask` instance is no longer allocated). 1079* Fixed `Job.cancel` and `CompletableDeferred.complete` to support cancelling/completing states and properly wait for their children to complete on join/await (see #199). 1080* Fixed a bug in binary heap implementation (used internally by `delay`) which could have resulted in wrong delay time in rare circumstances. 1081* Coroutines library for [Kotlin/JS](js/README.md): 1082 * `Promise.asDeferred` immediately installs handlers to avoid "Unhandled promise rejection" warning. 1083 * Use `window.postMessage` instead of `setTimeout` for coroutines inside the browser to avoid timeout throttling (see #194). 1084 * Use custom queue in `Window.awaitAnimationFrame` to align all animations and reduce overhead. 1085 * Introduced `Window.asCoroutineDispatcher()` extension function. 1086 1087## Version 0.21 1088 1089* Migrated to Kotlin 1.2.10. 1090* Coroutines library for [Kotlin/JS](js/README.md) and [multiplatform projects](https://kotlinlang.org/docs/reference/multiplatform.html) (see #33): 1091 * `launch` and `async` coroutine builders. 1092 * `Job` and `Deferred` light-weight future with cancellation support. 1093 * `delay` and `yield` top-level suspending functions. 1094 * `await` extension for JS `Promise` and `asPromise`/`asDeferred` conversions. 1095 * `promise` coroutine builder. 1096 * `Job()` and `CompletableDeferred()` factories. 1097 * Full support for parent-child coroutine hierarchies. 1098 * `Window.awaitAnimationFrame` extension function. 1099 * [Sample frontend Kotlin/JS application](js/example-frontend-js/README.md) with coroutine-driven animations. 1100* `run` is deprecated and renamed to `withContext` (see #134). 1101* `runBlocking` and `EventLoop` implementations optimized (see #190). 1102 1103## Version 0.20 1104 1105* Migrated to Kotlin 1.2.0. 1106* Channels: 1107 * Sequence-like `filter`, `map`, etc extensions on `ReceiveChannel` are introduced (see #88 by @fvasco and #69 by @konrad-kaminski). 1108 * Introduced `ReceiveChannel.cancel` method. 1109 * All operators on `ReceiveChannel` fully consume the original channel (`cancel` it when they are done) using a helper `consume` extension. 1110 * Deprecated `ActorJob` and `ProducerJob`; `actor` now returns `SendChannel` and `produce` returns `ReceiveChannel` (see #127). 1111 * `SendChannel.sendBlocking` extension method (see #157 by @@fvasco). 1112* Parent-child relations between coroutines: 1113 * Introduced an optional `parent` job parameter for all coroutine builders so that code with an explict parent `Job` is more natural. 1114 * Added `parent` parameter to `CompletableDeferred` constructor. 1115 * Introduced `Job.children` property. 1116 * `Job.cancelChildren` is now an extension (member is deprecated and hidden). 1117 * `Job.joinChildren` extension is introduced. 1118 * Deprecated `Job.attachChild` as a error-prone API. 1119 * Fixed StackOverflow when waiting for a lot of completed children that did not remove their handlers from the parent. 1120* Use `java.util.ServiceLoader` to find default instances of `CoroutineExceptionHandler`. 1121* Android UI integration: 1122 * Use `Thread.getUncaughtExceptionPreHandler` to make sure that exceptions are logged before crash (see #148). 1123 * Introduce `UI.awaitFrame` for animation; added sample coroutine-based animation application for Android [here](ui/kotlinx-coroutines-android/animation-app). 1124 * Fixed `delay(Long.MAX_VALUE)` (see #161) 1125* Added missing `DefaultDispatcher` on some reactive operators (see #174 by @fvasco) 1126* Fixed `actor` and `produce` so that a cancellation of a Job cancels the underlying channel (closes and removes all the pending messages). 1127* Fixed sporadic failure of `example-context-06` (see #160) 1128* Fixed hang of `Job.start` on lazy coroutine with attached `invokeOnCompletion` handler. 1129* A more gradual introduction to `runBlocking` and coroutines in the [guide](docs/topics/coroutines-guide.md) (see #166). 1130 1131## Version 0.19.3 1132 1133* Fixed `send`/`openSubscription` race in `ArrayBroadcastChannel`. 1134 This race lead to stalled (hanged) `send`/`receive` invocations. 1135* Project build has been migrated to Gradle. 1136 1137## Version 0.19.2 1138 1139* Fixed `ArrayBroadcastChannel` receive of stale elements on `openSubscription`. 1140 Only elements that are sent after invocation of `openSubscription` are received now. 1141* Added a default value for `context` parameter to `rxFlowable` (see #146 by @PhilGlass). 1142* Exception propagation logic from cancelled coroutines is adjusted (see #152): 1143 * When cancelled coroutine crashes due to some other exception, this other exception becomes the cancellation reason 1144 of the coroutine, while the original cancellation reason is suppressed. 1145 * `UnexpectedCoroutineException` is no longer used to report those cases as is removed. 1146 * This fixes a race between crash of CPU-consuming coroutine and cancellation which resulted in an unhandled exception 1147 and lead to crashes on Android. 1148* `run` uses cancelling state & propagates exceptions when cancelled (see #147): 1149 * When coroutine that was switched into a different dispatcher using `run` is cancelled, the run invocation does not 1150 complete immediately, but waits until the body completes. 1151 * If the body completes with exception, then this exception is propagated. 1152* No `Job` in `newSingleThreadContext` and `newFixedThreadPoolContext` anymore (see #149, #151): 1153 * This resolves the common issue of using `run(ctx)` where ctx comes from either `newSingleThreadContext` or 1154 `newFixedThreadPoolContext` invocation. They both used to return a combination of dispatcher + job, 1155 and this job was overriding the parent job, thus preventing propagation of cancellation. Not anymore. 1156 * `ThreadPoolDispatcher` class is now public and is the result type for both functions. 1157 It has the `close` method to release the thread pool. 1158 1159## Version 0.19.1 1160 1161* Failed parent Job cancels all children jobs, then waits for them them. 1162 This makes parent-child hierarchies easier to get working right without 1163 having to use `try/catch` or other exception handlers. 1164* Fixed a race in `ArrayBroadcastChannel` between `send` and `openChannel` invocations 1165 (see #138). 1166* Fixed quite a rare race in `runBlocking` that resulted in `AssertionError`. 1167 Unfortunately, cannot write a reliable stress-test to reproduce it. 1168* Updated Reactor support to leverage Bismuth release train 1169 (contributed by @sdeleuze, see PR #141) 1170 1171## Version 0.19 1172 1173* This release is published to Maven Central. 1174* `DefaultDispatcher` is introduced (see #136): 1175 * `launch`, `async`, `produce`, `actor` and other integration-specific coroutine builders now use 1176 `DefaultDispatcher` as the default value for their `context` parameter. 1177 * When a context is explicitly specified, `newCoroutineContext` function checks if there is any 1178 interceptor/dispatcher defined in the context and uses `DefaultDispatcher` if there is none. 1179 * `DefaultDispatcher` is currently defined to be equal to `CommonPool`. 1180 * Examples in the [guide](docs/topics/coroutines-guide.md) now start with `launch { ... }` code and explanation on the nature 1181 and the need for coroutine context starts in "Coroutine context and dispatchers" section. 1182* Parent coroutines now wait for their children (see #125): 1183 * Job _completing_ state is introduced in documentation as a state in which parent coroutine waits for its children. 1184 * `Job.attachChild` and `Job.cancelChildren` are introduced. 1185 * `Job.join` now always checks cancellation status of invoker coroutine for predictable behavior when joining 1186 failed child coroutine. 1187 * `Job.cancelAndJoin` extension is introduced. 1188 * `CoroutineContext.cancel` and `CoroutineContext.cancelChildren` extensions are introduced for convenience. 1189 * `withTimeout`/`withTimeoutOrNull` blocks become proper coroutines that have `CoroutineScope` and wait for children, too. 1190 * Diagnostics in cancellation and unexpected exception messages are improved, 1191 coroutine name is included in debug mode. 1192 * Fixed cancellable suspending functions to throw `CancellationException` (as was documented before) even when 1193 the coroutine is cancelled with another application-specific exception. 1194 * `JobCancellationException` is introduced as a specific subclass of `CancellationException` which is 1195 used for coroutines that are cancelled without cause and to wrap application-specific exceptions. 1196 * `Job.getCompletionException` is renamed to `Job.getCancellationException` and return a wrapper exception if needed. 1197 * Introduced `Deferred.getCompletionExceptionOrNull` to get not-wrapped exception result of `async` task. 1198 * Updated docs for `Job` & `Deferred` to explain parent/child relations. 1199* `select` expression is modularized: 1200 * `SelectClause(0,1,2)` interfaces are introduced, so that synchronization 1201 constructs can define their select clauses without having to modify 1202 the source of the `SelectBuilder` in `kotlinx-corounes-core` module. 1203 * `Job.onJoin`, `Deferred.onAwait`, `Mutex.onLock`, `SendChannel.onSend`, `ReceiveChannel.onReceive`, etc 1204 that were functions before are now properties returning the corresponding select clauses. Old functions 1205 are left in bytecode for backwards compatibility on use-site, but any outside code that was implementing those 1206 interfaces by itself must be updated. 1207 * This opens road to moving channels into a separate module in future updates. 1208* Renamed `TimeoutException` to `TimeoutCancellationException` (old name is deprecated). 1209* Fixed various minor problems: 1210 * JavaFx toolkit is now initialized by `JavaFx` context (see #108). 1211 * Fixed lost ACC_STATIC on <clinit> methods (see #116). 1212 * Fixed link to source code from documentation (see #129). 1213 * Fixed `delay` in arbitrary contexts (see #133). 1214* `kotlinx-coroutines-io` module is introduced. It is a work-in-progress on `ByteReadChannel` and `ByteWriteChannel` 1215 interfaces, their implementations, and related classes to enable convenient coroutine integration with various 1216 asynchronous I/O libraries and sockets. It is currently _unstable_ and **will change** in the next release. 1217 1218## Version 0.18 1219 1220* Kotlin 1.1.4 is required to use this version, which enables: 1221 * `withLock` and `consumeEach` functions are now inline suspend functions. 1222 * `JobSupport` class implementation is optimized (one fewer field). 1223* `TimeoutException` is public (see #89). 1224* Improvements to `Mutex` (courtesy of @fvasco): 1225 * Introduced `holdsLock` (see #92). 1226 * Improved documentation on `Mutex` fairness (see #90). 1227* Fixed NPE when `ArrayBroadcastChannel` is closed concurrently with receive (see #97). 1228* Fixed bug in internal class LockFreeLinkedList that resulted in ISE under stress in extremely rare circumstances. 1229* Integrations: 1230 * [quasar](integration/kotlinx-coroutines-quasar): Introduced integration with suspendable JVM functions 1231 that are instrumented with [Parallel Universe Quasar](https://docs.paralleluniverse.co/quasar/) 1232 (thanks to the help of @pron). 1233 * [reactor](reactive/kotlinx-coroutines-reactor): Replaced deprecated `setCancellation` with `onDipose` and 1234 updated to Aluminium-SR3 release (courtesy of @yxf07, see #96) 1235 * [jdk8](integration/kotlinx-coroutines-jdk8): Added adapters for `java.time` classes (courtesy of @fvasco, see #93) 1236 1237## Version 0.17 1238 1239* `CompletableDeferred` is introduced as a set-once event-like communication primitive (see #70). 1240 * [Coroutines guide](docs/topics/coroutines-guide.md) uses it in a section on actors. 1241 * `CompletableDeferred` is an interface with private impl (courtesy of @fvasco, see #86). 1242 * It extends `Deferred` interface with `complete` and `completeExceptionally` functions. 1243* `Job.join` and `Deferred.await` wait until a cancelled coroutine stops execution (see #64). 1244 * `Job` and `Deferred` have a new _cancelling_ state which they enter on invocation of `cancel`. 1245 * `Job.invokeOnCompletion` has an additional overload with `onCancelling: Boolean` parameter to 1246 install handlers that are fired as soon as coroutine enters _cancelling_ state as opposed 1247 to waiting until it _completes_. 1248 * Internal `select` implementation is refactored to decouple it from `JobSupport` internal class 1249 and to optimize its state-machine. 1250 * Internal `AbstractCoroutine` class is refactored so that it is extended only by true coroutines, 1251 all of which support the new _cancelling_ state. 1252* `CoroutineScope.context` is renamed to `coroutineContext` to avoid conflicts with other usages of `context` 1253 in applications (like Android context, see #75). 1254* `BroadcastChannel.open` is renamed to `openSubscription` (see #54). 1255* Fixed `StackOverflowError` in a convoy of `Mutex.unlock` invokers with `Unconfined` dispatcher (see #80). 1256* Fixed `SecurityException` when trying to use coroutines library with installed `SecurityManager`. 1257* Fixed a bug in `withTimeoutOrNull` in case with nested timeouts when coroutine was cancelled before it was 1258 ever suspended. 1259* Fixed a minor problem with `awaitFirst` on reactive streams that would have resulted in spurious stack-traces printed 1260 on the console when used with publishers/observables that continue to invoke `onNext` despite being cancelled/disposed 1261 (which they are technically allowed to do by specification). 1262* All factory functions for various interfaces are implemented as top-level functions 1263 (affects `Job`, `Channel`, `BroadcastChannel`, `Mutex`, `EventLoop`, and `CoroutineExceptionHandler`). 1264 Previous approach of using `operator invoke` on their companion objects is deprecated. 1265* Nicer-to-use debug `toString` implementations for coroutine dispatcher tasks and continuations. 1266* A default dispatcher for `delay` is rewritten and now shares code with `EventLoopImpl` that is used by 1267 `runBlocking`. It internally supports non-default `TimeSource` so that delay-using tests can be written 1268 with "virtual time" by replacing their time source for the duration of tests (this feature is not available 1269 outside of the library). 1270 1271## Version 0.16 1272 1273* Coroutines that are scheduled for execution are cancellable by default now 1274 * `suspendAtomicCancellableCoroutine` function is introduced for funs like 1275 `send`/`receive`/`receiveOrNull` that require atomic cancellation 1276 (they cannot be cancelled after decision was made) 1277 * Coroutines started with default mode using 1278 `async`/`launch`/`actor` builders can be cancelled before their execution starts 1279 * `CoroutineStart.ATOMIC` is introduced as a start mode to specify that 1280 coroutine cannot be cancelled before its execution starts 1281 * `run` function is also cancellable in the same way and accepts an optional 1282 `CoroutineStart` parameter to change this default. 1283* `BroadcastChannel` factory function is introduced 1284* `CoroutineExceptionHandler` factory function is introduced by @konrad-kaminski 1285* [`integration`](integration) directory is introduced for all 3rd party integration projects 1286 * It has [contribution guidelines](integration/README.md#contributing) and contributions from community are welcome 1287 * Support for Guava `ListenableFuture` in the new [`kotlinx-coroutines-guava`](integration/kotlinx-coroutines-guava) module 1288 * Rx1 Scheduler support by @konrad-kaminski 1289* Fixed a number of `Channel` and `BroadcastChannel` implementation bugs related to concurrent 1290 send/close/close of channels that lead to hanging send, offer or close operations (see #66). 1291 Thanks to @chrisly42 and @cy6erGn0m for finding them. 1292* Fixed `withTimeoutOrNull` which was returning `null` on timeout of inner or outer `withTimeout` blocks (see #67). 1293 Thanks to @gregschlom for finding the problem. 1294* Fixed a bug where `Job` fails to dispose a handler when it is the only handler by @uchuhimo 1295 1296## Version 0.15 1297 1298* Switched to Kotlin version 1.1.2 (can still be used with 1.1.0). 1299* `CoroutineStart` enum is introduced for `launch`/`async`/`actor` builders: 1300 * The usage of `luanch(context, start = false)` is deprecated and is replaced with 1301 `launch(context, CoroutineStart.LAZY)` 1302 * `CoroutineStart.UNDISPATCHED` is introduced to start coroutine execution immediately in the invoker thread, 1303 so that `async(context, CoroutineStart.UNDISPATCHED)` is similar to the behavior of C# `async`. 1304 * [Guide to UI programming with coroutines](ui/coroutines-guide-ui.md) mentions the use of it to optimize 1305 the start of coroutines from UI threads. 1306* Introduced `BroadcastChannel` interface in `kotlinx-coroutines-core` module: 1307 * It extends `SendChannel` interface and provides `open` function to create subscriptions. 1308 * Subscriptions are represented with `SubscriptionReceiveChannel` interface. 1309 * The corresponding `SubscriptionReceiveChannel` interfaces are removed from [reactive](reactive) implementation 1310 modules. They use an interface defined in `kotlinx-coroutines-core` module. 1311 * `ConflatedBroadcastChannel` implementation is provided for state-observation-like use-cases, where a coroutine or a 1312 regular code (in UI, for example) updates the state that subscriber coroutines shall react to. 1313 * `ArrayBroadcastChannel` implementation is provided for event-bus-like use-cases, where a sequence of events shall 1314 be received by multiple subscribers without any omissions. 1315 * [Guide to reactive streams with coroutines](reactive/coroutines-guide-reactive.md) includes 1316 "Rx Subject vs BroadcastChannel" section. 1317* Pull requests from Konrad Kamiński are merged into reactive stream implementations: 1318 * Support for Project Reactor `Mono` and `Flux`. 1319 See [`kotlinx-coroutines-reactor`](reactive/kotlinx-coroutines-reactor) module. 1320 * Implemented Rx1 `Completable.awaitCompleted`. 1321 * Added support for Rx2 `Maybe`. 1322* Better timeout support: 1323 * Introduced `withTimeoutOrNull` function. 1324 * Implemented `onTimeout` clause for `select` expressions. 1325 * Fixed spurious concurrency inside `withTimeout` blocks on their cancellation. 1326 * Changed behavior of `withTimeout` when `CancellationException` is suppressed inside the block. 1327 Invocation of `withTimeout` now always returns the result of execution of its inner block. 1328* The `channel` property in `ActorScope` is promoted to a wider `Channel` type, so that an actor 1329 can have an easy access to its own inbox send channel. 1330* Renamed `Mutex.withMutex` to `Mutex.withLock`, old name is deprecated. 1331 1332## Version 0.14 1333 1334* Switched to Kotlin version 1.1.1 (can still be used with 1.1.0). 1335* Introduced `consumeEach` helper function for channels and reactive streams, Rx 1.x, and Rx 2.x. 1336 * It ensures that streams are unsubscribed from on any exception. 1337 * Iteration with `for` loop on reactive streams is **deprecated**. 1338 * [Guide to reactive streams with coroutines](reactive/coroutines-guide-reactive.md) is updated virtually 1339 all over the place to reflect these important changes. 1340* Implemented `awaitFirstOrDefault` extension for reactive streams, Rx 1.x, and Rx 2.x. 1341* Added `Mutex.withMutex` helper function. 1342* `kotlinx-coroutines-android` module has `provided` dependency on of Android APIs to 1343 eliminate warnings when using it in android project. 1344 1345## Version 0.13 1346 1347* New `kotlinx-coroutinex-android` module with Android `UI` context implementation. 1348* Introduced `whileSelect` convenience function. 1349* Implemented `ConflatedChannel`. 1350* Renamed various `toXXX` conversion functions to `asXXX` (old names are deprecated). 1351* `run` is optimized with fast-path case and no longer has `CoroutineScope` in its block. 1352* Fixed dispatching logic of `withTimeout` (removed extra dispatch). 1353* `EventLoop` that is used by `runBlocking` now implements Delay, giving more predictable test behavior. 1354* Various refactorings related to resource management and timeouts: 1355 * `Job.Registration` is renamed to `DisposableHandle`. 1356 * `EmptyRegistration` is renamed to `NonDisposableHandle`. 1357 * `Job.unregisterOnCompletion` is renamed to `Job.disposeOnCompletion`. 1358 * `Delay.invokeOnTimeout` is introduced. 1359 * `withTimeout` now uses `Delay.invokeOnTimeout` when available. 1360* A number of improvement for reactive streams and Rx: 1361 * Introduced `rxFlowable` builder for Rx 2.x. 1362 * `Scheduler.asCoroutineDispatcher` extension for Rx 2.x. 1363 * Fixed bug with sometimes missing `onComplete` in `publish`, `rxObservable`, and `rxFlowable` builders. 1364 * Channels that are open for reactive streams are now `Closeable`. 1365 * Fixed `CompletableSource.await` and added test for it. 1366 * Removed `rx.Completable.await` due to name conflict. 1367* New documentation: 1368 * [Guide to UI programming with coroutines](ui/coroutines-guide-ui.md) 1369 * [Guide to reactive streams with coroutines](reactive/coroutines-guide-reactive.md) 1370* Code is published to JCenter repository. 1371 1372## Version 0.12 1373 1374* Switched to Kotlin version 1.1.0 release. 1375* Reworked and updated utilities for 1376 [Reactive Streams](kotlinx-coroutines-reactive), 1377 [Rx 1.x](kotlinx-coroutines-rx1), and 1378 [Rx 2.x](kotlinx-coroutines-rx2) with library-specific 1379 coroutine builders, suspending functions, converters and iteration support. 1380* `LinkedListChannel` with unlimited buffer (`offer` always succeeds). 1381* `onLock` select clause and an optional `owner` parameter in all `Mutex` functions. 1382* `selectUnbiased` function. 1383* `actor` coroutine builder. 1384* Couple more examples for "Shared mutable state and concurrency" section and 1385 "Channels are fair" section with ping-pong table example 1386 in [coroutines guide](docs/topics/coroutines-guide.md). 1387 1388## Version 0.11-rc 1389 1390* `select` expression with onJoin/onAwait/onSend/onReceive clauses. 1391* `Mutex` is moved to `kotlinx.coroutines.sync` package. 1392* `ClosedSendChannelException` is a subclass of `CancellationException` now. 1393* New sections on "Shared mutable state and concurrency" and "Select expression" 1394 in [coroutines guide](docs/topics/coroutines-guide.md). 1395 1396## Version 0.10-rc 1397 1398* Switched to Kotlin version 1.1.0-rc-91. 1399* `Mutex` synchronization primitive is introduced. 1400* `buildChannel` is renamed to `produce`, old name is deprecated. 1401* `Job.onCompletion` is renamed to `Job.invokeOnCompletion`, old name is deprecated. 1402* `delay` implementation in Swing, JavaFx, and scheduled executors is fixed to avoid an extra dispatch. 1403* `CancellableContinuation.resumeUndispatched` is introduced to make this efficient implementation possible. 1404* Remove unnecessary creation of `CancellationException` to improve performance, plus other performance improvements. 1405* Suppress deprecated and internal APIs from docs. 1406* Better docs at top level with categorized summary of classes and functions. 1407 1408## Version 0.8-beta 1409 1410* `defer` coroutine builder is renamed to `async`. 1411* `lazyDefer` is deprecated, `async` has an optional `start` parameter instead. 1412* `LazyDeferred` interface is deprecated, lazy start functionality is integrated into `Job` interface. 1413* `launch` has an optional `start` parameter for lazily started coroutines. 1414* `Job.start` and `Job.isCompleted` are introduced. 1415* `Deferred.isCompletedExceptionally` and `Deferred.isCancelled` are introduced. 1416* `Job.getInactiveCancellationException` is renamed to `getCompletionException`. 1417* `Job.join` is now a member function. 1418* Internal `JobSupport` state machine is enhanced to support _new_ (not-started-yet) state. 1419 So, lazy coroutines do not need a separate state variable to track their started/not-started (new/active) status. 1420* Exception transparency in `Job.cancel` (original cause is rethrown). 1421* Clarified possible states for `Job`/`CancellableContinuation`/`Deferred` in docs. 1422* Example on async-style functions and links to API reference site from [coroutines guide](docs/topics/coroutines-guide.md). 1423 1424## Version 0.7-beta 1425 1426* Buffered and unbuffered channels are introduced: `Channel`, `SendChannel`, and `ReceiveChannel` interfaces, 1427 `RendezvousChannel` and `ArrayChannel` implementations, `Channel()` factory function and `buildChannel{}` 1428 coroutines builder. 1429* `Here` context is renamed to `Unconfined` (the old name is deprecated). 1430* A [guide on coroutines](docs/topics/coroutines-guide.md) is expanded: sections on contexts and channels. 1431 1432## Version 0.6-beta 1433 1434* Switched to Kotlin version 1.1.0-beta-37. 1435* A [guide on coroutines](docs/topics/coroutines-guide.md) is expanded. 1436 1437## Version 0.5-beta 1438 1439* Switched to Kotlin version 1.1.0-beta-22 (republished version). 1440* Removed `currentCoroutineContext` and related thread-locals without replacement. 1441 Explicitly pass coroutine context around if needed. 1442* `lazyDefer(context) {...}` coroutine builder and `LazyDeferred` interface are introduced. 1443* The default behaviour of all coroutine dispatchers is changed to always schedule execution of new coroutine 1444 for later in this thread or thread pool. Correspondingly, `CoroutineDispatcher.isDispatchNeeded` function 1445 has a default implementation that returns `true`. 1446* `NonCancellable` context is introduced. 1447* Performance optimizations for cancellable continuations (fewer objects created). 1448* A [guide on coroutines](docs/topics/coroutines-guide.md) is added. 1449 1450## Version 0.4-beta 1451 1452* Switched to Kotlin version 1.1.0-beta-18 (republished version). 1453* `CoroutineDispatcher` methods now have `context` parameter. 1454* Introduced `CancellableContinuation.isCancelled` 1455* Introduced `EventLoop` dispatcher and made it a default for `runBlocking { ... }` 1456* Introduced `CoroutineScope` interface with `isActive` and `context` properties; 1457 standard coroutine builders include it as receiver for convenience. 1458* Introduced `Executor.toCoroutineDispatcher()` extension. 1459* Delay scheduler thread is not daemon anymore, but times out automatically. 1460* Debugging facilities in `newCoroutineContext` can be explicitly disabled with `-Dkotlinx.coroutines.debug=off`. 1461* xxx-test files are renamed to xxx-example for clarity. 1462* Fixed NPE in Job implementation when starting coroutine with already cancelled parent job. 1463* Support cancellation in `kotlinx-coroutines-nio` module 1464