promesa.exec — funcool/promesa 12.0.0-RC2

Executors & Schedulers facilities.

*default-executor* clj/s

*default-scheduler* clj/s

cached-executor clj

(cached-executor &
                 {:keys [max-size keepalive]
                  :or {keepalive 60000 max-size Integer/MAX_VALUE}
                  :as options})

A cached thread executor pool constructor.

configure-default-executor clj

(configure-default-executor & params)

current-thread clj

(current-thread)

Return the current thread.

current-thread-executor clj/s

(current-thread-executor)

Creates an executor instance that run tasks in the same thread.

default-current-thread-executor clj/s

Default Executor instance that runs the task in the same thread.

default-executor clj/s

Default executor instance, ForkJoinPool/commonPool in JVM, MicrotaskExecutor on JS.

default-scheduler clj/s

Default scheduled executor instance.

default-thread-factory clj

default-vthread-factory clj

exec clj/s

(exec f)

(exec executor f)

Run the task in the provided executor, returns Promise<nil>. Analogous to the (.execute executor f). Fire and forget.

executor? clj/s

(executor? o)

Returns true if o is an instane of Executor or satisfies IExecutor protocol.

fixed-executor clj

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

A fixed thread executor pool constructor.

fn->thread clj

(fn->thread f & {:keys [start] :or {start true} :as options})

forkjoin-executor clj

(forkjoin-executor &
                   {:keys [factory async parallelism keepalive core-size
                           max-size]
                    :or {max-size 32767 async true keepalive 60000}})

forkjoin-thread-factory clj

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

get-available-processors clj

(get-available-processors)

get-name clj

(get-name)

(get-name thread)

Retrieve thread name

get-thread-id clj

(get-thread-id)

(get-thread-id thread)

Retrieves the thread ID.

interrupt clj

(interrupt)

(interrupt thread)

Interrupt a thread.

interrupted? clj

(interrupted?)

(interrupted? thread)

Check if the thread has the interrupted flag set.

There are two special cases:

Using the :current keyword as argument will check the interrupted flag on the current thread.

Using the arity 0 (passing no arguments), then the current thread will be checked and WARNING the interrupted flag reset to false.

invoke clj

(invoke context f)

(invoke context f ms-or-duration)

Execute a function f in a provided context. Optional timeout can be provided. If timeout is reached and the context allows cancellation, the task will be cancelled.

microtask-executor cljs

(microtask-executor)

An IExecutor that schedules tasks to be executed in the MicrotasksQueue.

pmap clj

(pmap f coll)

(pmap f coll & colls)

Analogous to the clojure.core/pmap with the exception 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.

run clj/s

(run f)

(run executor f)

Run the task in the provided executor. Returns a Promise<nil>

schedule clj/s

(schedule ms f)

(schedule scheduler ms f)

Exception safe version of schedule!. It always returns an promise instance.

scheduled-executor clj/s

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

A scheduled thread pool constructor. A ScheduledExecutor (IScheduler in CLJS) instance allows execute asynchronous tasks some time later.

set-thread-name clj

(set-thread-name name)

(set-thread-name thread name)

shutdown clj

(shutdown executor)

Shutdowns the executor service.

shutdown-now clj

(shutdown-now executor)

Shutdowns and interrupts the executor service.

shutdown? clj

(shutdown? executor)

Check if execitor is in shutdown state.

single-executor clj

(single-executor & {:as options})

A single thread executor pool constructor.

sleep clj

(sleep ms)

Turn the current thread to sleep accept a number of milliseconds or Duration instance.

submit clj/s

(submit f)

(submit executor f)

Exception safe version of submit!. It always returns an promise instance.

thread clj macro

(thread opts & body)

A low-level, not-pooled thread constructor, it accepts an optional map as first argument and the body. The options map is interepreted as options if a literal map is provided. The available options are: :name, :priority, :daemon and :virtual. The :virtual option is ignored if you are using a JVM that has no support for Virtual Threads.

thread-call clj

(thread-call f & {:as opts})

Advanced version of p/thread-call that creates and starts a thread configured with opts. No executor service is used, this will start a plain unpooled thread; returns a non-cancellable promise instance

thread-factory clj

(thread-factory & {:keys [name daemon priority prefix virtual]})

Create a new thread factory instance

thread-factory? clj

(thread-factory? o)

Checks if o is an instance of ThreadFactory

thread-per-task-executor clj

(thread-per-task-executor & {:as options})

thread? clj

(thread? t)

Check if provided object is a thread instance.

throw-uncaught clj

(throw-uncaught cause)

Throw an exception to the current uncaught exception handler.

virtual-threads-available? clj/s

Var that indicates the availability of virtual threads.

vthread-per-task-executor clj

(vthread-per-task-executor)

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-dispatch! clj/s macro

(with-dispatch! executor & body)

Blocking version of with-dispatch. Useful when you want to dispatch a blocking operation to a separated thread and join current thread waiting for result; effective when current thread is virtual thread.

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.