AsyncCpsMonad

zio.blocks.async.internal.AsyncCpsMonad
object AsyncCpsMonad extends CpsTryMonadInstanceContext[Async]

The dotty-cps-async monad instance for Async. This is the single bridge between the DCA macro and our encoding: the macro emits cps.block / cps.async nodes that drive these six methods, all of which delegate to the zero-cost inline Async surface (map / flatMap / catchAll).

It is an object (not an anonymous given) so the zio.blocks.async macro can reference it by a stable fully-qualified name when it splices the generated cps.async[Async] { ... } block. The companion given below makes the same instance available for ordinary implicit search (e.g. DCA's summon[CpsMonad[Async]]).

CpsTryMonadInstanceContext provides the Context type and the apply method for free; we only implement the five primitives DCA needs: pure, map, flatMap, error, and flatMapTry.

Attributes

Source
AsyncCpsMonad.scala
Graph
Supertypes
trait CpsTryMonadInstanceContext[Async]
trait CpsTryMonad[Async]
trait CpsTrySupport[Async]
trait CpsThrowMonad[Async]
trait CpsThrowSupport[Async]
trait CpsMonad[Async]
class Object
trait Matchable
class Any
Show all
Self type

Members list

Type members

Inherited types

override type Context = CpsTryMonadInstanceContextBody[Async]

Attributes

Inherited from:
CpsTryMonadInstanceContext
Source
CpsMonadContext.scala

Inherited and Abstract types

type WF[X] <: Async[X]

Attributes

Inherited from:
CpsMonad
Source
CpsMonad.scala

Value members

Concrete methods

override def apply[T](op: Context => encoding.Async[T]): encoding.Async[T]

run op in the context environment.

run op in the context environment.

Attributes

Definition Classes
CpsTryMonadInstanceContext -> CpsMonad
Source
AsyncCpsMonad.scala
def error[A](e: Throwable): encoding.Async[A]

represent error e in monadic context.

represent error e in monadic context.

Attributes

Source
AsyncCpsMonad.scala
def flatMap[A, B](fa: encoding.Async[A])(f: A => encoding.Async[B]): encoding.Async[B]

bind combinator, which compose f over fa

bind combinator, which compose f over fa

Attributes

Source
AsyncCpsMonad.scala
def flatMapTry[A, B](fa: encoding.Async[A])(f: Try[A] => encoding.Async[B]): encoding.Async[B]

Run f against the Try-shaped outcome of fa. A ready value or a Failure is dispatched directly (no Pollable allocation); a suspended input is reified to Async[Try[A]] via map/catchAll and then handed to f. Exceptions thrown by f itself are captured as Async.fail so the DCA try/catch rewrite observes them as monadic failures.

Run f against the Try-shaped outcome of fa. A ready value or a Failure is dispatched directly (no Pollable allocation); a suspended input is reified to Async[Try[A]] via map/catchAll and then handed to f. Exceptions thrown by f itself are captured as Async.fail so the DCA try/catch rewrite observes them as monadic failures.

Attributes

Source
AsyncCpsMonad.scala
def map[A, B](fa: encoding.Async[A])(f: A => B): encoding.Async[B]

map a function f over fa

map a function f over fa

Attributes

Source
AsyncCpsMonad.scala
def pure[A](a: A): encoding.Async[A]

Pure - wrap value t inside monad.

Pure - wrap value t inside monad.

Note, that pure use eager evaluation, which is different from Haskell.

Attributes

Source
AsyncCpsMonad.scala
override def withAction[A](fa: encoding.Async[A])(action: => Unit): encoding.Async[A]

ensure that action will run before getting value from fa

ensure that action will run before getting value from fa

Attributes

Definition Classes
CpsTryMonad
Source
AsyncCpsMonad.scala
override def withAsyncAction[A](fa: encoding.Async[A])(action: => encoding.Async[Unit]): encoding.Async[A]

return result of fa after completition of action.

return result of fa after completition of action.

Attributes

Definition Classes
CpsTryMonad
Source
AsyncCpsMonad.scala

Inherited methods

def flatWrap[T](op: => Async[T]): Async[T]

Wrap and flatten of monadic expression..

Wrap and flatten of monadic expression..

Attributes

Inherited from:
CpsMonad
Source
CpsMonad.scala
def flatten[T](ffa: Async[Async[T]]): Async[T]

Attributes

Inherited from:
CpsMonad
Source
CpsMonad.scala
def fromTry[A](r: Try[A]): Async[A]

transform r into pure value or error.

transform r into pure value or error.

Attributes

Inherited from:
CpsTryMonad
Source
CpsMonad.scala
def mapTry[A, B](fa: Async[A])(f: Try[A] => B): Async[B]

map over result of checked evaluation of A

map over result of checked evaluation of A

Attributes

Inherited from:
CpsTryMonad
Source
CpsMonad.scala
def mapTryAsync[A, B](fa: Async[A])(f: Try[A] => Async[B]): Async[B]

synonym for flatMapTry needed for processing awaits inside mapTry.

synonym for flatMapTry needed for processing awaits inside mapTry.

Attributes

Inherited from:
CpsTryMonad
Source
CpsMonad.scala
def restore[A](fa: Async[A])(fx: Throwable => Async[A]): Async[A]

restore fa, ie if fa sucessful - return fa, otherwise apply fx to received error.

restore fa, ie if fa sucessful - return fa, otherwise apply fx to received error.

Attributes

Inherited from:
CpsTryMonad
Source
CpsMonad.scala
def tailRecM[A, B](a: A)(f: A => Async[Either[A, B]]): Async[B]

Stack-safe monadic recursion.

Stack-safe monadic recursion.

Iterates f until it returns Right(b).

  • Left(a1) means continue with new state a1
  • Right(b) means done with result b

The default implementation uses flatMap recursively, which is stack-safe for monads with internal trampolining (TailRec, IO, Future, etc.) but NOT for identity-like monads. Override for those cases.

Attributes

Inherited from:
CpsMonad
Source
CpsMonad.scala
def tryImpure[A](a: => Async[A]): Async[A]

try to evaluate async operation and wrap successful or failed result into F.

try to evaluate async operation and wrap successful or failed result into F.

Attributes

Inherited from:
CpsTryMonad
Source
CpsMonad.scala
def tryPure[A](a: => A): Async[A]

try to evaluate synchonious operation and wrap successful or failed result into F.

try to evaluate synchonious operation and wrap successful or failed result into F.

Attributes

Inherited from:
CpsTryMonad
Source
CpsMonad.scala
def tryPureAsync[A](a: () => Async[A]): Async[A]

async shift of tryPure.

async shift of tryPure.

Attributes

Inherited from:
CpsTryMonad
Source
CpsMonad.scala
def withActionAsync[A](fa: Async[A])(action: () => Async[Unit]): Async[A]

async shift of withAction.

async shift of withAction.

This method is substituted instead withAction, when we use await inside withAction argument.

Attributes

Inherited from:
CpsTryMonad
Source
CpsMonad.scala
def withAsyncErrorHandler[A](fa: => Async[A])(f: Throwable => Async[A]): Async[A]

Attributes

Inherited from:
CpsTrySupport
Source
CpsMonad.scala
def withAsyncFinalizer[A](fa: => Async[A])(f: => Async[Unit]): Async[A]

Attributes

Inherited from:
CpsTrySupport
Source
CpsMonad.scala
def wrap[T](op: => T): Async[T]

Create monadic expression according to the default operation of choosen monad types. (i.e. delaying for effect monads, starting for eager monand, pure by default)

Create monadic expression according to the default operation of choosen monad types. (i.e. delaying for effect monads, starting for eager monand, pure by default)

Attributes

Inherited from:
CpsMonad
Source
CpsMonad.scala