parsl.concurrent.ParslPoolExecutor

class parsl.concurrent.ParslPoolExecutor(config: Config | None = None, dfk: DataFlowKernel | None = None, executors: Literal['all'] | list[str] = 'all')

An executor that uses a pool of workers managed by Parsl

Works just like a ProcessPoolExecutor except that tasks are distributed across workers that can be on different machines.

The futures returned by submit() and map() are Parsl futures and will work with the same function chaining mechanisms as when using App-based Parsl.

Parsl does not support canceling tasks. The map() method does not cancel work when one member of the run fails or a timeout is reached and shutdown() does not cancel work on completion.

__init__(config: Config | None = None, dfk: DataFlowKernel | None = None, executors: Literal['all'] | list[str] = 'all')

Create the executor

Parameters:

• config – Configuration for the Parsl Data Flow Kernel (DFK)

• dfk – DataFlowKernel of an already-started parsl

• executors – List of executors to use for supplied functions

Methods

__init__([config, dfk, executors])	Create the executor
get_app(fn)	Create a PythonApp for a function
map(fn, *iterables[, timeout, chunksize, ...])	Returns an iterator equivalent to map(fn, iter).
shutdown([wait, cancel_futures])	Clean-up the resources associated with the Executor.
submit(fn, *args, **kwargs)	Submits a callable to be executed with the given arguments.

Attributes

app_count

Number of functions currently registered with the executor

property app_count

Number of functions currently registered with the executor

get_app(fn: Callable) → PythonApp

Create a PythonApp for a function

Parameters:

fn – Function to be turned into a Parsl app

Returns:

PythonApp version of that function

map(fn: Callable[[...], T], *iterables: Iterable, timeout: float | None = None, chunksize: int = 1, buffersize: int | None = None) → Iterator[T]

Returns an iterator equivalent to map(fn, iter).

Parameters:

• fn – A callable that will take as many arguments as there are passed iterables.

• timeout – The maximum number of seconds to wait. If None, then there is no limit on the wait time.

• chunksize – This parameter is ignored. Caution should be exercised if expecting behaviour as documented in the base concurrent.futures.Executor class.

• buffersize – This parameter is ignored. Caution should be exercised if expecting behaviour as documented in the base concurrent.futures.Executor class.

Returns:

map(func, *iterables) but the calls may be evaluated out-of-order.

Return type:

An iterator equivalent to

Raises:

• TimeoutError – If the entire result iterator could not be generated before the given timeout.

• Exception – If fn(*args) raises for any values.

shutdown(wait: bool = True, *, cancel_futures: bool = False) → None

Clean-up the resources associated with the Executor.

It is safe to call this method several times. Otherwise, no other methods can be called after this one.

Parameters:

• wait – If True then shutdown will not return until all running futures have finished executing and the resources used by the executor have been reclaimed.

• cancel_futures – If True then shutdown will cancel all pending futures. Futures that are completed or running will not be cancelled.

submit(fn, *args, **kwargs)

Submits a callable to be executed with the given arguments.

Schedules the callable to be executed as fn(*args, **kwargs) and returns a Future instance representing the execution of the callable.

Returns:

A Future representing the given call.