Skip to main content

Patterns for reactive background tasks

Project description

Traits Futures allows a TraitsUI-based GUI application to execute one or more background tasks without blocking the main GUI, and provides a mechanism for that application to safely update the GUI in response to full or partial results from the background tasks.

Detailed description

GUI applications that want to perform a long-running task in response to user interactions (for example, running a time-consuming calculation, or submitting a complex search query to a remote database) face two major issues:

  • If the task is executed directly on the main thread, it blocks the GUI event loop, making the entire application appear unresponsive to the user.

  • It’s not generally safe to update a GUI directly from a worker thread, so a task run on a worker thread needs to find a way to safely communicate events back to the main GUI thread.

For TraitsUI-based applications, Traits Futures provides a solution to these issues, similar in principle to the Python standard library concurrent.futures package. Tasks are submitted to an executor, and on task submission the executor immediately returns a “future” object. That “future” object has observable attributes (“traits”) representing the application’s view of the state of the background task. Rather than waiting on the future’s state, an interested observer can listen to updates to those traits and update the GUI state as necessary when changes occur. The Traits Futures machinery ensures that updates to the future’s traits always occur on the main thread, freeing observers from thread-safety concerns.

For further information, see the documentation pages at https://docs.enthought.com/traits-futures/.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

traits_futures-0.3.1.tar.gz (1.4 MB view details)

Uploaded Source

Built Distribution

traits_futures-0.3.1-py3-none-any.whl (110.1 kB view details)

Uploaded Python 3

File details

Details for the file traits_futures-0.3.1.tar.gz.

File metadata

  • Download URL: traits_futures-0.3.1.tar.gz
  • Upload date:
  • Size: 1.4 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.2 importlib_metadata/4.6.1 pkginfo/1.7.1 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.61.2 CPython/3.8.11

File hashes

Hashes for traits_futures-0.3.1.tar.gz
Algorithm Hash digest
SHA256 47f414541cf2ebbba5c0a8595aec76083a4fa16d441f05bde8b7436ece19c71d
MD5 cd0c9662f1487698008246b8e044318d
BLAKE2b-256 c49fbe70d6a45b3646e9700236761d8fe9ca227994a80c2ab29e1d2f1a8c63d0

See more details on using hashes here.

File details

Details for the file traits_futures-0.3.1-py3-none-any.whl.

File metadata

  • Download URL: traits_futures-0.3.1-py3-none-any.whl
  • Upload date:
  • Size: 110.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.2 importlib_metadata/4.6.1 pkginfo/1.7.1 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.61.2 CPython/3.8.11

File hashes

Hashes for traits_futures-0.3.1-py3-none-any.whl
Algorithm Hash digest
SHA256 0b57a1cb40c528e17afc3bdd606ca7cc0340b715334085e425626231295e78e8
MD5 0a7c24c3e3baf98e70753b08ab1b3eba
BLAKE2b-256 c6a75b8fbf9208c59252a0d336f8ec8cfe07dda199ff5659b6fac62bf15fdbca

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page