_images/pythonring.png

Warning

execnet currently is in maintenance-only mode, mostly because it is still the backend of the pytest-xdist plugin. Do not use in new projects.

Python is a mature dynamic language whose interpreters can interact with all major computing platforms today.

execnet provides a share-nothing model with channel-send/receive communication for distributing execution across many Python interpreters across version, platform and network barriers. It has a minimal and fast API targeting the following uses:

  • Distribute tasks to (many) local or remote CPUs

  • Write and deploy hybrid multi-process applications

  • Write scripts to administer multiple environments

Features

  • Automatic bootstrapping: no manual remote installation.

  • Safe and simple serialization of Python builtin types for sending/receiving structured data messages. (New in 1.1) execnet offers a new dumps/loads API which allows cross-interpreter compatible serialization of Python builtin types.

  • Flexible communication: synchronous send/receive as well as callback/queue mechanisms supported

  • Easy creation, handling and termination of multiple processes

  • Well tested interactions between CPython 2.5-2.7, CPython-3.3, Jython 2.5.1 and PyPy interpreters.

  • Fully interoperable between Windows and Unix-ish systems.

  • Many tested examples

Known uses

Project status

The project is currently in maintenance-only mode, with PRs fixing bugs being gracefully accepted.

Currently there are no plans to improve the project further, being maintained mostly because it is used as backend of the popular pytest-xdist plugin.

execnet was conceived originally by Holger Krekel and is licensed under the MIT license since version 1.2.