futurist

What it is and what it does

Futurist is a futures library that extends Python's standard concurrent.futures with additional executors and observability features. It provides a synchronous executor for testing, an eventlet-based executor for greenlet-based concurrency, and built-in statistics gathering to monitor how asynchronous work executes. The library aims to make concurrent execution patterns more transparent and easier to reason about, particularly in OpenStack environments where it originated.

The package depends only on debtcollector for deprecation handling, keeping its footprint minimal. It supports Python 3.11 through 3.14 and is actively maintained. Developers use it when they need drop-in executor replacements with visibility into task execution patterns, or when working with eventlet-based concurrency models.

Use it for:

• Replace standard executors with versions that gather execution statistics for monitoring and debugging.
• Use eventlet executor for greenlet-based concurrency in I/O-bound workloads.
• Test async code paths using the synchronous executor without managing threads.
• Monitor task execution patterns in distributed systems.
• Gather metrics on executor performance and task completion times.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Futurist provides futures utilities and executors that add transparency and statistics gathering to asynchronous work execution, including eventlet and synchronous executor implementations.

Yes, if you need executor alternatives with built-in statistics or eventlet support. The low install friction, permissive Apache-2.0 license, active maintenance, and zero known vulnerabilities make it a safe choice. Install only if your use case specifically requires the statistics gathering, eventlet executor, or synchronous executor—standard concurrent.futures covers most cases.

Install

futurist on PyPI

pip install futurist

uv add futurist

poetry add futurist

Installing futurist

Before you install

Low install friction with a single runtime dependency. Actively maintained as of June 2026, supporting current Python versions (3.11–3.14).

License in practice

Licensed under Apache-2.0 (permissive), allowing commercial and private use with minimal restrictions; suitable for most projects.

Quickstart

pip install futurist

from futurist import ThreadPoolExecutor

executor = ThreadPoolExecutor(max_workers=4)
future = executor.submit(lambda: x)
result = future.result()

Requires Python 3.11 or later.

Verify before relying

• Whether eventlet executor requires eventlet as an optional dependency or if it's bundled.
• Specific statistics gathering capabilities and output format.
• Whether synchronous executor is suitable for testing or production use.
• Concrete performance characteristics and typical use patterns in production.

Package facts

Evidence: futurist-3.4.0-py3-none-any.whl

Tags

More Distributed Computing packages