1# Change log for kotlinx.coroutines 2 3## Version 1.7.2 4 5### Bug fixes and improvements 6 7* Coroutines debugger no longer keeps track of coroutines with empty coroutine context (#3782). 8* `CopyableThreadContextElement` now properly copies an element when crossing the coroutine boundary in `flowOn` (#3787). Thanks @wanyingd1996! 9* Coroutine timeouts no longer prevent K/N `newSingleThreadContext` from closing (#3768). 10* A non-linearizability in `Mutex` during `tryLock`/`unlock` sequence with owners is fixed (#3745). 11* Atomicfu version is updated to 0.21.0. 12 13## Version 1.7.1 14 15### Bug fixes and improvements 16 17* Special characters in coroutine names in JSON dumps are supported (#3747) 18* The binary compatibility of the experimental overload of `runTest` is restored (#3673) 19* Channels that don't use `onUndeliveredElement` now allocate less memory (#3646) 20 21## Version 1.7.0 22 23### Core API significant improvements 24 25* New `Channel` implementation with significant performance improvements across the API (#3621). 26* New `select` operator implementation: faster, more lightweight, and more robust (#3020). 27* `Mutex` and `Semaphore` now share the same underlying data structure (#3020). 28* `Dispatchers.IO` is added to K/N (#3205) 29 * `newFixedThreadPool` and `Dispatchers.Default` implementations on K/N were wholly rewritten to support graceful growth under load (#3595). 30* `kotlinx-coroutines-test` rework: 31 - Add the `timeout` parameter to `runTest` for the whole-test timeout, 10 seconds by default (#3270). This replaces the configuration of quiescence timeouts, which is now deprecated (#3603). 32 - The `withTimeout` exception messages indicate if the timeout used the virtual time (#3588). 33 - `TestCoroutineScheduler`, `runTest`, and `TestScope` API are promoted to stable (#3622). 34 - `runTest` now also fails if there were uncaught exceptions in coroutines not inherited from the test coroutine (#1205). 35 36### Breaking changes 37 38* Old K/N memory model is no longer supported (#3375). 39* New generic upper bounds were added to reactive integration API where the language since 1.8.0 dictates (#3393). 40* `kotlinx-coroutines-core` and `kotlinx-coroutines-jdk8` artifacts were merged into a single artifact (#3268). 41* Artificial stackframes in stacktrace recovery no longer contain the `\b` symbol and are now navigable in IDE and supplied with proper documentation (#2291). 42* `CoroutineContext.isActive` returns `true` for contexts without any job in them (#3300). 43 44### Bug fixes and improvements 45 46* Kotlin version is updated to 1.8.20 47* Atomicfu version is updated to 0.20.2. 48* `JavaFx` version is updated to 17.0.2 in `kotlinx-coroutines-javafx` (#3671).. 49* JPMS is supported (#2237). Thanks @lion7! 50* `BroadcastChannel` and all the corresponding API are deprecated (#2680). 51* Added all supported K/N targets (#3601, #812, #855). 52* K/N `Dispatchers.Default` is backed by the number of threads equal to the number of available cores (#3366). 53* Fixed an issue where some coroutines' internal exceptions were not properly serializable (#3328). 54* Introduced `Job.parent` API (#3201). 55* Fixed a bug when `TestScheduler` leaked cancelled jobs (#3398). 56* `TestScope.timeSource` now provides comparable time marks (#3617). Thanks @hfhbd! 57* Fixed an issue when cancelled `withTimeout` handles were preserved in JS runtime (#3440). 58* Ensure `awaitFrame` only awaits a single frame when used from the main looper (#3432). Thanks @pablobaxter! 59* Obsolete `Class-Path` attribute was removed from `kotlinx-coroutines-debug.jar` manifest (#3361). 60* Fixed a bug when `updateThreadContext` operated on the parent context (#3411). 61* Added new `Flow.filterIsInstance` extension (#3240). 62* `Dispatchers.Default` thread name prefixes are now configurable with system property (#3231). 63* Added `Flow.timeout` operator as `@FlowPreview` (#2624). Thanks @pablobaxter! 64* Improved the performance of the `future` builder in case of exceptions (#3475). Thanks @He-Pin! 65* `Mono.awaitSingleOrNull` now waits for the `onComplete` signal (#3487). 66* `Channel.isClosedForSend` and `Channel.isClosedForReceive` are promoted from experimental to delicate (#3448). 67* Fixed a data race in native `EventLoop` (#3547). 68* `Dispatchers.IO.limitedParallelism(valueLargerThanIOSize)` no longer creates an additional wrapper (#3442). Thanks @dovchinnikov! 69* Various `@FlowPreview` and `@ExperimentalCoroutinesApi` are promoted to experimental and stable respectively (#3542, #3097, #3548). 70* Performance improvements in `Dispatchers.Default` and `Dispatchers.IO` (#3416, #3418). 71* Fixed a bug when internal `suspendCancellableCoroutineReusable` might have hanged (#3613). 72* Introduced internal API to process events in the current system dispatcher (#3439). 73* Global `CoroutineExceptionHandler` is no longer invoked in case of unprocessed `future` failure (#3452). 74* Performance improvements and reduced thread-local pressure for the `withContext` operator (#3592). 75* Improved performance of `DebugProbes` (#3527). 76* Fixed a bug when the coroutine debugger might have detected the state of a coroutine incorrectly (#3193). 77* `CoroutineDispatcher.asExecutor()` runs tasks without dispatching if the dispatcher is unconfined (#3683). Thanks @odedniv! 78* `SharedFlow.toMutableList` and `SharedFlow.toSet` lints are introduced (#3706). 79* `Channel.invokeOnClose` is promoted to stable API (#3358). 80* Improved lock contention in `Dispatchers.Default` and `Dispatchers.IO` during the startup phase (#3652). 81* Fixed a bug that led to threads oversubscription in `Dispatchers.Default` (#3642). 82* Fixed a bug that allowed `limitedParallelism` to perform dispatches even after the underlying dispatcher was closed (#3672). 83* Fixed a bug that prevented stacktrace recovery when the exception's constructor from `cause` was selected (#3714). 84* Improved sanitizing of stracktrace-recovered traces (#3714). 85* Introduced an internal flag to disable uncaught exceptions reporting in tests as a temporary migration mechanism (#3736). 86* Various documentation improvements and fixes. 87 88Changelog for previous versions may be found in [CHANGES_UP_TO_1.7.md](CHANGES_UP_TO_1.7.md) 89