Repository navigation
Releases
v3.5.2
This is a bug-fixing release for the 3.5.x series.
Note
Emergency release that fixes an issue introduced in v3.5.1.
Monix 3.5.1 failed on any JDK older than 27, including the supported minimum of 17, with UnsupportedClassVersionError (class file version 71.0), because the Java classes in its artifacts were compiled for JDK 27, the version used by the release workflow; Java sources are now compiled with -source and -target set to 17 (#2085, #2086).
Sorry for this publishing error, it was caused by Renovate upgrading the JDK used for publishing to 27 in PR #2080.
This release was made possible by the work and feedback of:
- Alexandru Nedelcu (@alexandru)
- Kenji Yoshida (@xuwei-k)
v3.5.1
This is a bug-fixing release for the 3.5.x series, with no API changes.
Fixes
Observable.fromInputStreamandObservable.fromInputStreamUnsafenow emit a chunk when no more bytes are currently available, instead of blocking until the buffer fills up (#1479, #2082).Observer.toReactiveSubscriber,Subscriber.toReactiveSubscriber,Subject.toReactiveProcessor, andTask.parSequenceUnorderednow usePlatform.recommendedBatchSizeinstead of the scheduler'sExecutionModel#recommendedBatchSize, which forExecutionModel.SynchronousExecutionis effectively unbounded, disabling backpressure (#1670, #2081).
Build and publishing
- Automatic snapshot releases from
mainwere disabled; publishing is now triggered manually via themanual-publishworkflow. - Updated sbt to
1.13.0and sbt plugins (Scala.js1.22.0, sbt-mima1.2.1).
Contributors
- Alexandru Nedelcu (@alexandru)
- Jakub Pinowski (@Pinioo)
- Kamil Podsiadło (@kpodsiad)
- Kenji Yoshida (@xuwei-k)
- Roman Janusz (@ghik)
- Tomasz Godzik (@tgodzik)
Full Changelog: v3.5.0...v3.5.1
v3.5.0
This version updates the supported runtime and Scala versions, dependencies, and includes several concurrency and scheduler bug fixes.
Note
It does not upgrade Cats-Effect to 3.x, because that's still a breaking change, sorry, but an upgrade in a near-future 4.0.0 is in the works.
Breaking changes:
- JDK
17is now the minimum supported runtime and build target. - JDK
21is now part of the validated support matrix. - Scala
2.12support is dropped. - The supported Scala versions are now
2.13.18and3.3.7. - Legacy
sun.misc.Unsafe-based internals were removed in favor of JDKVarHandle-based implementations.
Fixes and improvements:
- Scheduled task failures are now reported to the configured
UncaughtExceptionReporterbyScheduledExecutorService-backed schedulers and the Scala.jsAsyncScheduler(#2036). - Forked
Trampolineexecutions no longer share mutable, non-thread-safe queues across threads, preventing dropped or stuck tasks and memory consiste 8000 ncy errors (#2031). Zip2ObservablethroughZip6Observablenow synchronize completion and error signaling at their call sites, avoiding re-entrant synchronization and stale reads (#2040).DynamicWorkerThreadFactorydelegates maximum thread-count management toForkJoinPool(#1589).- Invalid-state errors from
MapTaskObservablenow include the mapping function to improve diagnostics (#2030). - Scala.js scheduling now uses
MacrotaskExecutor(#1522).
Modules and dependencies:
- Added the
monix-execution-atomicmodule (#1561). - Updated Cats to
2.13.0and Cats Effect to2.5.5. - Updated Scala.js to
1.21.0and JCTools to4.0.6. - Published artifacts now declare the
semver-specversion scheme.
Build and publishing:
- Maven Central publishing now uses the Central Portal.
- Scaladoc JARs omit bundled fonts and Inkuire assets to reduce their size.
This release was made possible by the work and feedback of:
- Alexandru Nedelcu (@alexandru)
- Mikołaj Bul (@mikkolaj)
- Bartłomiej Kozak (@halotukozak)
- Łukasz Petka (@lpetka)
- Roman Janusz (@ghik)
- Arman Bilge (@armanbilge)
- Kenji Yoshida (@xuwei-k)
Full Changelog: v3.4.1...v3.5.0
v3.4.1
This is a minor bug-fixing release for the 3.x series.
Updated dependencies (#1554):
- Scala compiler updated to 2.12.15, 2.13.8 and 3.1.2;
- Typelevel Cats updated to 2.7.0;
- Typelevel Cats-Effect updated to 2.5.4;
- Updated compiler and sbt plugins to latest versions;
Fixes:
Trampoline.trampolineContextno longer ignores its parent BlockContext (#1544)- Only include JCTools in
executionShadedJCTools(#1514)
This release was made possible by:
- Alexandru Nedelcu (@alexandru)
- Gabriele Petronella (@gabro)
- Roman Janusz (@ghik)
v3.4.0
The release is binary and source compatible with 3.x series, and was cross-built for the following Scala and ScalaJS versions:
- Scala
2.12,2.13and3.0 - Scala.js
1.5.1
WARN: we're dropping compatibility with Scala 2.11 and ScalaJS 0.6.x. If you still need those you'll have to stay on version 3.3.0.
Changes in this release:
- Dropped support for Scala
2.11and Scala.js0.6.x - Dependency updates:
- Cats
2.6.1 - Cats-Effect
2.5.1 - JCTools
3.3.0
- Cats
- Adds support for Scala 3 (#1326, #1327, #1328, #1329, #1344, #1323)
- Adds
Observable.whileBusyAggregateEvents(#1320) - Fix tracing in
CoevalandTaskvia a more accurate filter (#1353) - Adds
Observable.throttleLatest(#1396) - Implement pagination for
Observable(#1381)
This release was made possible by the work and feedback of:
- Alexandru Nedelcu (@alexandru)
- Dominik Wosiński (@Wosin)
- Lars Hupel (@larsrh)
- Luke Stephenson (@lukestephenson)
- Oleg Pyzhcov (@oleg-py)
- Pau Alarcón (@paualarco)
- Piotr Gawryś (@Avasil)
v3.3.0
The release is binary and source compatible with 3.x.x line.
It is released for the following Scala and ScalaJS versions:
- Scala 2.11: ScalaJS 0.6.x
- Scala 2.12: ScalaJS 0.6.x and 1.3.x
- Scala 2.13: ScalaJS 0.6.x and 1.3.x
Note that most likely, this is going to be the last release on ScalaJS 0.6.x.
We can consider doing backports on-demand.
Highlights
Better Stack Traces
This release includes a highly requested feature of better stack traces for Task and Coeval!
Big thanks to @RaasAhsan and @djspiewak for providing the original implementation that we have ported.
They are enabled by default, but it is configurable.
Refer to Stack Traces section for more details.
We have measured about 10-30% performance hit in CACHED mode (the default) in microbenchmarks.
If you have any performance tests, we would greatly appreciate any reports!
If the hit is too big, you can disable the stack traces with -Dmonix.eval.stackTracingMode=none.
For the following code:
package test.app
import monix.eval.Task
import monix.execution.Scheduler
import cats.implicits._
import scala.concurrent.duration._
object TestTracingApp extends App {
implicit val s = Scheduler.global
def customMethod: Task[Unit] =
Task.now(()).guarantee(Task.sleep(10.millis))
val tracingTestApp: Task[Unit] = for {
_ <- Task.shift
_ <- Task.unit.attempt
_ <- (Task(println("Started the program")), Task.unit).parTupled
_ <- customMethod
_ <- if (true) Task.raiseError(new Exception("boom")) else Task.unit
} yield ()
tracingTestApp.onErrorHandleWith(ex => Task(ex.printStackTrace())).runSyncUnsafe
}The default (cached) stack trace is going to be:
java.lang.Exception: boom
at test.app.TestTracingApp$.$anonfun$tracingTestApp$5(TestTracingApp.scala:36)
at guarantee @ test.app.TestTracingApp$.customMethod(TestTracingApp.scala:29)
at flatMap @ test.app.TestTracingApp$.$anonfun$tracingTestApp$4(TestTracingApp.scala:35)
at parTupled @ test.app.TestTracingApp$.$anonfun$tracingTestApp$2(TestTracingApp.scala:34)
at parTupled @ test.app.TestTracingApp$.$anonfun$tracingTestApp$2(TestTracingApp.scala:34)
at flatMap @ test.app.TestTracingApp$.$anonfun$tracingTestApp$2(TestTracingApp.scala:34)
at flatMap @ test.app.TestTracingApp$.$anonfun$tracingTestApp$1(TestTracingApp.scala:33)
at flatMap @ test.app.TestTracingApp$.delayedEndpoint$test$app$TestTracingApp$1(TestTracingApp.scala:32)
Before 3.3.0 and with stack traces disabled, stack traces are a mess:
java.lang.Exception: boom
at test.app.TestTracingApp$.$anonfun$tracingTestApp$5(TestTracingApp.scala:36)
at monix.eval.internal.TaskRunLoop$.startFull(TaskRunLoop.scala:188)
at monix.eval.internal.TaskRestartCallback.syncOnSuccess(TaskRestartCallback.scala:101)
at monix.eval.internal.TaskRestartCallback$$anon$1.run(TaskRestartCallback.scala:118)
at monix.execution.internal.Trampoline.monix$execution$internal$Trampoline$$immediateLoop(Trampoline.scala:66)
at monix.execution.internal.Trampoline.startLoop(Trampoline.scala:32)
at monix.execution.schedulers.TrampolineExecutionContext$JVMNormalTrampoline.super$startLoop(TrampolineExecutionContext.scala:142)
at monix.execution.schedulers.TrampolineExecutionContext$JVMNormalTrampoline.$anonfun$startLoop$1(TrampolineExecutionContext.scala:142)
at scala.runtime.java8.JFunction0$mcV$sp.apply(JFunction0$mcV$sp.scala:18)
at scala.concurrent.BlockContext$.withBlockContext(BlockContext.scala:94)
at monix.execution.schedulers.TrampolineExecutionContext$JVMNormalTrampoline.startLoop(TrampolineExecutionContext.scala:142)
at monix.execution.internal.Trampoline.execute(Trampoline.scala:40)
at monix.execution.schedulers.TrampolineExecutionContext.execute(TrampolineExecutionContext.scala:57)
at monix.execution.schedulers.BatchingScheduler.execute(BatchingScheduler.scala:50)
at monix.execution.schedulers.BatchingScheduler.execute$(BatchingScheduler.scala:47)
at monix.execution.schedulers.AsyncScheduler.execute(AsyncScheduler.scala:31)
at monix.eval.internal.TaskRestartCallback.onSuccess(TaskRestartCallback.scala:72)
at monix.eval.internal.TaskRunLoop$.startFull(TaskRunLoop.scala:183)
at monix.eval.internal.TaskRestartCallback.syncOnSuccess(TaskRestartCallback.scala:101)
at monix.eval.internal.TaskRestartCallback.onSuccess(TaskRestartCallback.scala:74)
at monix.eval.internal.TaskSleep$SleepRunnable.run(TaskSleep.scala:71)
at java.util.concurrent.ForkJoinTask$RunnableExecuteAction.exec(ForkJoinTask.java:1402)
at java.util.concurrent.ForkJoinTask.doExec(ForkJoinTask.java:289)
at java.util.concurrent.ForkJoinPool$WorkQueue.runTask(ForkJoinPool.java:1056)
at java.util.concurrent.ForkJoinPool.runWorker(ForkJoinPool.java:1692)
at java.util.concurrent.ForkJoinWorkerThread.run(ForkJoinWorkerThread.java:157)
Better Task => Future interop when using Local
Running Task isolates Local, which was not available in the Future, resulting in runToFuture.
This release enables it and unblocks compelling use cases, such as reading proper request context in Akka HTTP Directive.
We've created an AkkaHTTP Example that demonstrates it.
Latest behavior is:
implicit val s: Scheduler = Scheduler.Implicits.traced
val local = Local(0)
for {
_ <- Task(local.update(1)).runToFuture
value <- Future(local.get)
} yield println(s"Local value in Future $value")
println(s"Local value on the current thread = $value")
// => Local value on the current thread = 0
// => Local value in Future = 1Task still isolates the Local, but the Future continuation keeps the same reference and can read it.
Before the change, Local would be 0 in the Future.
More information about Local can be found in the new Local documentation.
Relevant updates
- #1205: Observable.mergePrioritizedList
- #1209: Bring back Observable.transform and Transformer alias
- #1198: Fix flatMapIterable calling recursively itself
- #1213: Propagate Local isolation in runToFuture
- #1217: Fix performance regression in bufferSliding
- #1244: Add support for compression: Gzip and deflate
- #1262: Fix bug in Task.runSyncUnsafe related to ContextSwitch
- #1265: Implement Observable#bufferWhile and bufferWhileInclusive
- #1267: Implement Asynchronous Stack Traces for Task
- #1276: Add Task/Coeval convenience methods like .when
- #1282: Add 'as' in Task and Coeval
- #1284: Add left/right builders for Task and Coeval
- #1286: Add none/some builders for Task and Coeval
- #1291: tapEval, tapError methods at Task and Coeval
- #1293: removing no-op onComplete() in Observable.takeByTimespan
- #1299: Fix a bug in Local.value
- #1307: Observable.fromIteratorBuffered
People who made this release possible
- Adrian (@adrian-salajan)
- Alexandru Nedelcu (@alexelcu)
- ctoomey (@ctoomey)
- Dmitro Pochapsky (@pchpsky)
- Georgy Khotyan (@GKhotyan)
- James Yoo (@jyoo980)
- Kasper Kondzielski (@ghostbuster91)
- Pau Alarcón (@paualarco)
- Piotr Gawryś (@Avasil)
- Sandeep Kota (@sandeepkota)
- tafit3 (@tafit3)
- Vladyslav (@VladPodilnyk)
v3.2.2
The release is binary and source compatible with 3.x.x line.
It is released for the following Scala and ScalaJS versions:
- Scala 2.11: ScalaJS 0.6.x
- Scala 2.12: ScalaJS 0.6.x and 1.0.x
- Scala 2.13: ScalaJS 0.6.x and 1.0.x
Relevant updates:
- #1197: Fixes a memory leak in bracket, introduced in 3.2.0
- #1195: Fixes non-deterministic behavior in Observable.zip of sources different size
- #1190: Now Observable.groupBy correctly signals error as a failed stream instead of normal completion
- #1188: Fixes an issue in ForeachAsyncConsumer where it wasn't properly propagaing errors in some cases
- #1187: Fixes an issue where Observable.doAfterSubscribe was not executing its finalizer
- #1186: Observable.interval method now schedules the first tick asynchronously
- #1184: Huge performance improvement in CharsReader, InputStream and LinesReaderObservable
- #1154: Observable.fromInputStream and fromCharsReader now respects the chunkSize
- #1181: Fix MatchError in Iterant.fromReactivePublisher
People who made this release possible:
- Akosh Farkash (@aakoshh)
- Alexander (@ppressives)
- fnqista (@fnqista)
- Kasper Kondzielski (@ghostbuster91)
- Pau Alarcón (@paualarco)
- Piotr Gawryś (@Avasil)
- Vasily Kirichenko (@vasily-kirichenko)
- Viktor Lövgren (@vlovgr)
v3.2.1
v3.2.0
The release is binary and source compatible with 3.x.x line.
It is released for the following Scala and ScalaJS versions:
- Scala 2.11: ScalaJS 0.6.x
- Scala 2.12: ScalaJS 0.6.x and 1.0.x
- Scala 2.13: ScalaJS 0.6.x and 1.0.x
Relevant updates:
- #1087: Bracket should not evaluate "use" if Task was canceled during "acquire"
- #1098: Allow to pass Long in Observable.drop(n)
- #1101: Canceled tasks in Half-Open state should return to Open state in CircuitBreaker
- #1107: Add CommutativeApplicative[Task.Par] instance
- #1106 and #1125: Add Observable.concatMapIterable
- #1117: SyncEffect instance for Coeval
- #1120: Cancel should always wait for the finalizer
- #1126: bufferIntrospective should signal Stop upstream when it is back-pressured
- #1135: Observable.intervalAtFixedRate under-millisecond interval fix
- #1132: Add Iterant.withFilter
- #1129: Add Observable.withFilter
- #1145: Deprecate gather, gatherN, gatherUnordered in favor of parSequence, parSequenceN, parSequenceUnordered
- #1152: Add Consumer.toList
People that made this release possible:
- Allan Timothy Leong (@allantl)
- Eugene Platonov (@jozic)
- Fabien Chaillou (@fchaillou)
- Gabriel Claramunt (@gclaramunt)
- Mantas Indrašius (@mantasindrasius)
- TapanVaishnav (@TapanVaishnav)
- najder-k (@najder-k)
- Oleg Pyzhcov (@oleg-py)
- Pau Alarcón (@paualarco)
- Piotr Gawryś (@Avasil)
- Ross A. Baker (@rossabaker)
- Viet Yen Nguyen (@nguyenvietyen)
- Viktor Dychko (@dychko)
v3.1.0
Version 3.1.0 (November 8, 2019)
The release is binary and source compatible with 3.0.0.
Important updates:
- #1008: Fixed stack safety issue of Observable.combineLatestList for big lists
- #1010: flatMapLoop for Task and Coeval
- #1012: ConcurrentQueue.isEmpty
- #1014: Observable.timeoutOnSlowDownstreamTo
- #1016: Observable.takeUntilEval
- #1057: Fix default scheduleOnce implementation
- #1062: Solves a memory leak which sometimes occurred when using Task with localContextPropagation and non-TracingScheduler
- #1063: Ensure async boundary in TaskCreate if LCP is enabled
- #1064 and #1070: Earlier cancelation in Observable.mapParallel if any task fails
- #1065: Add mapAccumulate to Observable
People that made this release possible:
- Alexandru Nedelcu (@alexandru)
- Allan Timothy Leong (@allantl)
- fdilg (@fdilg)
- Jan Bracker (@jbracker)
- Moritz Bust (@busti)
- mudsam (@mudsam)
- Oleg Pyzhcov (@oleg-py)
- Paweł Kiersznowski (@pk044)
- Piotr Gawryś (@Avasil)
- tanaka takaya (@takayahilton)
- TapanVaishnav (@TapanVaishnav)