ae.utils.promise

An implementation of promises.

Modules

await module ae.utils.promise.await: async/await-like API for asynchronous tasks combining promises and fibers.
concurrency module ae.utils.promise.concurrency: Promise concurrency tools.
range module ae.utils.promise.range: Promise range tools.
timing module ae.utils.promise.timing: Promise-based timing utilities.

Promise class Promise(T, E : Throwable = Exception): A promise for a value T or error E.

all Promise!(AllResult!Promises.ResultType) all(Promises promises): Heterogeneous variant, which resolves to a tuple. void promises' values are omitted from the result tuple. If all promises are void, then so is the result.
all PromiseValueTransform!(P, x => [x]) all(P[] promises): Wait for all promises to be resolved, or for any to be rejected.
reject Promise!(T, E) reject(E reason): Returns a new Promise which is rejected with the given reason.
require Promise!(T, E) require(Promise!(T, E) p, Promise!(T, E) lp): Undocumented in source. Be warned that the author may not have intended to support it.
resolve Promise!void resolve(): Returns a new Promise!void which is resolved.
resolve Promise!T resolve(T value): Returns a new Promise which is resolved with the given value.

PromiseQueue struct PromiseQueue(T, E = Exception): Ordered promise queue, supporting asynchronous enqueuing / fulfillment.

PromiseError template PromiseError(P): Get the error type of the promise P, i.e. its E parameter.
PromiseValue template PromiseValue(P): Get the value type of the promise P, i.e. its T parameter.
PromiseValueTransform template PromiseValueTransform(P, alias transform): Construct a new Promise type based on P, if the given transformation was applied on the value type. If P is a void Promise, then the returned promise will also be void.
isPromise template isPromise(P): Return true if P is a Promise instantiation.