Fluentmap

Fluentmap provides a drop-in Python map replacement featuring parallel and batch processing.

Features

• Use executor to run tasks in parallel.
• Use batch_size/chunk_size to send parameters in batches/chunks.
• Use num_prepare to prepare data in advance for better performance.
• Call on_return hook to process the return value of each task.

Installation

Fluentmap requires Python 3.8 or newer, has no runtime dependencies, and is tested on CPython 3.8-3.15, including the free-threaded builds (3.13t-3.15t).

Fluentmap is available on PyPI:

pip install fluentmap

Usage

Drop-in replacement

You can start to use fluentmap just like built-in map:

from typing import Any, List

from fluentmap import map


items: List[str] = [...]


def heavy_task(item: str) -> Any:
    """Suppose this function represents a computationally expensive task."""


def postprocessing(result: Any):
    """Suppose this function represents a postprocessing task."""


for result in map(heavy_task, items):
    postprocessing(result)

Parallel processing

As heavy_task is a computationally expensive task, you can use executor to run it in parallel.

from concurrent.futures import ProcessPoolExecutor

from fluentmap import map

# ......

with ProcessPoolExecutor() as executor:
    # each heavy_task invocation runs in a separate process
    for result in map(heavy_task, items, executor=executor):
        postprocessing(result)

Batch/chunk processing

You can use batch_size/chunk_size to send arguments in batches/chunks.

The difference between them is that batch_size packs multiple arguments into a batch before sending them to the function, therefore the function needs to be modified to handle a list of arguments.

On the other hand, chunk_size packs multiple arguments into a chunks before passing them to executor workers, while workers still process each argument sequentially.

from concurrent.futures import ProcessPoolExecutor
from typing import Any, List

from fluentmap import map


# ......


def heavy_task_in_batch(item: List[str]) -> Any:
    """Note that `item` is a list since when `batch_size` is set,
    fluentmap will concatenate multiple items into a batch before sending them to
    the function which is to be invoked.
    """


# An example of using `batch_size`
with ProcessPoolExecutor() as executor:
    for result in map(
        heavy_task_in_batch,
        items,
        executor=executor,
        batch_size=64,
    ):
        postprocessing(result)

# An example of using `chunk_size` 
with ProcessPoolExecutor() as executor:
    for result in map(
        heavy_task,
        items,
        executor=executor,
        chunk_size=32,
    ):
        postprocessing(result)