This is a helper connect objects for providing dotty-cps-async CpsAsyncMonad typeclasses for common effect stacks and streaming libraries.
libraryDependencies += "com.github.rssh" %%% "cps-async-connect-cats-effect" % version
And if you want to use JDK-21 virtual threads for translation of high-order function arguments:
libraryDependencies += "com.github.rssh" %%% "cps-async-connect-cats-effect-loom" % version
If you use scala lts versinm then use artefacts with lts suffix:
libraryDependencies += "com.github.rssh" %%% "cps-async-connect-cats-effect-lts" % version
Usage:
import cps._
import cps.monads.catsEffect.given
...
def doSomething(): IO[T] = async[IO] {
...
}
or import specific class to allow compiler to deduce given monad automatically.
- IO - catsIO (implements CpsConcurrentEffectMonad with conversion to Future)
- Generic
F[_]:Async
- catsAsync (implements CpsAsyncMonad) - Generic
F[_]:MonadThrow
- catsMonadThrow (implements CpsTryMonad) - Generic
F[_]:Monad
- catsMonad (implements CpsMonad)
Also implemented pseudo-synchronious interface for resources, i.e. for r:Resource[F,A]
it is possible to write:
async[F] {
.......
Resource.using(r1,r2){ file1, file2 =>
val data = await(fetchData(url))
file1.write(data)
file1.write(s"data fetched from $url")
}
}
or
async[F] {
....
r.useOn{file =>
val data = await(fetchData())
file.write(data)
}
}
instead
await(r.use{
fetchData().map(data => f.write(data))
})
libraryDependencies += "com.github.rssh" %%% "cps-async-connect-monix" % version
(or with '-lts' for scala-lts version)
Usage:
import cps.*
import cps.monads.monix.given
import monix.eval.Task
...
def doSomething(): Task[T] = async[Task] {
...
}
import cps.*
import monix.*
import monix.reactive.*
import cps.monads.monix.given
import cps.stream.monix.given
def intStream() = asyncStream[Observable[Int]] { out =>
for(i <- 1 to N) {
out.emit(i)
}
}
libraryDependencies += "com.github.rssh" %%% "cps-async-connect-scalaz" % version
- IO - cps.monads.scalaz.scalazIO (implements CpsTryMonad)
for 1.x:
libraryDependencies += "com.github.rssh" %%% "cps-async-connect-zio" % version
for 2.x:
libraryDependencies += "com.github.rssh" %%% "cps-async-connect-zio2" % version
and for loom support on JDK21+ :
libraryDependencies += "com.github.rssh" %%% "cps-async-connect-zio2-loom" % version
Usage:
import cps.*
import cps.monads.zio.{given,*}
val program = asyncRIO[R] {
.....
}
or for task:
val program = async[Task] {
....
}
- ZIO -
asyncZIO[R,E]
as shortcat forasync[[X]=>>ZIO[R,E,X]]
(implementsCpsAsyncMonad
with conversion toFuture
if we have givenRuntime
in scope.) - RIO - use asyncRIO[R] (implements CpsAsyncMonad with conversion)
- Task - use async[Task] (implements CpsAsyncMonad with conversion)
- URIO - use asyncURIO[R] (implements CpsMonad)
Also implement using
pseudo-syntax for ZManaged:
asyncRIO[R] {
val managedResource = Managed.make(Queue.unbounded[Int])(_.shutdown)
ZManaged.using(managedResource, secondResource) { queue =>
doSomething() // can use awaits inside.
}
}
And generator syntax for ZStream:
val stream = asyncStream[Stream[Throwable,Int]] { out =>
for(i <- 1 to N) {
out.emit(i)
}
}
libraryDependencies += "com.github.rssh" %%% "cps-async-connect-akka-stream" % version
Generator syntax for akka source.
libraryDependencies += "com.github.rssh" %%% "cps-async-connect-fs2" % version
Generator syntax for fs2
libraryDependencies += "com.github.rssh" %%% "cps-async-connect-pekko-stream" % version
Generator syntax for pekko source.
libraryDependencies += "com.github.rssh" %%% "cps-async-connect-probability-monad" % version
CpsTryMonad instance for Distribution monad.