Install

pip install ezFutures

Getting started

First, we need to import the class:

from ezFutures import ezFutures

In order to start working with ezFutures, you must instantiate the class object. The most important parameter to set is the n_procs parameter which defines the number of processes to run in parallel.

ez = ezFutures(n_procs=19)

From there, you can submit jobs in a sequential manner, just as you do with concurrent futures. However, because ezFutures default parallelism backend is not concurrent futures, merely submitting a task will not start the job. You have the option of using concurrent futures process pool as the parallelism backend (we will update documentation in the future to describe this)

def some_task(elem):
    return(elem)

for i in range(10):
    ez.submit(some_task, i)

You can start the jobs by invoking results method, just as you would with the concurrent futures API.

ez.results()

# Progress: |██████████████████████████████████████████████████| 100.0%
# [1, 2, 7, 0, 8, 3, 5, 4, 9, 6]

The 10 tasks submitted are done in parallel asynchronously, which is why the returned results order is jumbled.

In case there are errors, you can retrieve the stacktrace by invoking errors method.

ez.errors()

The default parallelism backend will try the tasks 3 times (configurable using n_retries parameter when initializing ezFutures) before marking the task as a “failed” task.