promesa.exec — funcool/promesa 9.0.518

Executors & Schedulers facilities.

*default-executor* clj/s

*default-scheduler* clj/s

cached-executor clj

(cached-executor & {:keys [factory]})

A cached thread executor pool constructor.

cached-pool clj deprecated

(cached-pool)

(cached-pool opts)

A cached thread pool constructor.

configure-default-executor! clj

(configure-default-executor! & params)

counter clj

default-executor clj/s

A global, default executor service.

default-forkjoin-thread-factory clj

(default-forkjoin-thread-factory &
                                 {:keys [name daemon]
                                  :or {name "promesa/forkjoin/%s" daemon true}})

default-scheduler clj/s

A global, default scheduler executor service.

default-thread-factory clj

(default-thread-factory
  &
  {:keys [name daemon priority]
   :or {daemon true priority Thread/NORM_PRIORITY name "promesa/thread/%s"}})

executor? clj/s

(executor? o)

fixed-executor clj

(fixed-executor & {:keys [parallelism factory]})

A fixed thread executor pool constructor.

fixed-pool clj deprecated

(fixed-pool n)

(fixed-pool n opts)

A fixed thread pool constructor.

forkjoin-executor clj

(forkjoin-executor & {:keys [factory async? parallelism] :or {async? true}})

forkjoin-pool clj deprecated

(forkjoin-pool {:keys [factory async? parallelism] :or {async? true} :as opts})

noop clj/s

pmap clj

(pmap f coll)

(pmap f coll & colls)

Analogous to the clojure.core/pmap with the excetion that it allows use a custom executor (binded to default-executor var) The default clojure chunk size (32) is used for evaluation and the real parallelism is determined by the provided executor.

EXPERIMENTAL API: This function should be considered EXPERIMENTAL and may be changed or removed in future versions until this notification is removed.

resolve-executor clj/s

(resolve-executor)

(resolve-executor executor)

resolve-scheduler clj/s

(resolve-scheduler)

(resolve-scheduler scheduler)

run! clj/s

(run! f)

(run! executor f)

Run the task in the provided executor.

same-thread-executor clj/s

A global thread executor that uses the same thread to run the code.

schedule! clj/s

(schedule! ms f)

(schedule! scheduler ms f)

Schedule a callable to be executed after the ms delay is reached.

In JVM it uses a scheduled executor service and in JS it uses the setTimeout function.

scheduled-executor clj

(scheduled-executor & {:keys [parallelism factory] :or {parallelism 1}})

A scheduled thread pool constructor.

scheduled-pool clj deprecated

(scheduled-pool)

(scheduled-pool n)

(scheduled-pool n opts)

A scheduled thread pool constructor.

shutdown! clj/s

(shutdown! executor)

Shutdowns the executor service.

shutdown-now! clj/s

(shutdown-now! executor)

Shutdowns and interrupts the executor service.

single-executor clj

(single-executor & {:keys [factory]})

A single thread executor pool constructor.

single-pool clj deprecated

(single-pool)

(single-pool opts)

A single thread pool constructor.

submit! clj/s

(submit! f)

(submit! executor f)

Submit a task to be executed in a provided executor and return a promise that will be completed with the return value of a task.

A task is a plain clojure function.

thread-executor clj/s

A global, thread per task executor service.

thread-factory? clj

(thread-factory? o)

vthread-executor clj/s

A global, virtual thread per task executor service.

vthreads-supported? clj/s

with-dispatch clj/s macro

(with-dispatch executor & body)

Helper macro for dispatch execution of the body to an executor service. The returned promise is not cancellable (the body will be executed independently of the cancellation).

with-executor clj/s macro

(with-executor executor & body)

Binds the default-executor var with the provided executor, executes the macro body. It also can optionally shutdown or shutdown and interrupt on termination if you provide ^:shutdown and ^:interrupt metadata.

EXPERIMENTAL API: This function should be considered EXPERIMENTAL and may be changed or removed in future versions until this notification is removed.

work-stealing-executor clj

(work-stealing-executor & params)

An alias for the forkjoin-executor.

work-stealing-pool clj deprecated

(work-stealing-pool)

(work-stealing-pool n)

Creates a work-stealing thread pool.

wrap-bindings clj/s

(wrap-bindings f)