ZMQRuntime

Generic ZeroMQ transport, lifecycle, progress, cancellation, viewer-control, and execution-projection primitives.

Important boundary

ZMQServer and ZMQClient are abstract application integration points. They cannot be instantiated directly:

a server implements handle_control_message and handle_data_message;
a client implements _spawn_server_process and send_data.

The package does not provide a generic send_request API or define an application's execution payload. Applications subclass the bases and map their typed domain requests onto the transport.

Transport configuration

from zmqruntime import TransportMode, ZMQConfig
from zmqruntime.transport import get_zmq_transport_url

config = ZMQConfig(control_port_offset=1000)
data_url = get_zmq_transport_url(
    7777,
    host="localhost",
    mode=TransportMode.TCP,
    config=config,
)

Application subclasses can use serve_forever, readiness probes, control port helpers, progress records, cancellation messages, lifecycle engines, and projection adapters without duplicating socket or process machinery.

Execution completion

Execution clients with a registered progress subscription wake on the server's terminal ExecutionStatusSnapshot. The existing callback sequence barrier still waits for every admitted progress callback. Registration replays the latest progress and terminal record; a missing terminal notification recovers through STATUS using the configured wait interval. Clients without progress registration continue to use STATUS.

Applications that enrich successful results override ExecutionServer.finalize_execution_record(record). This record-only hook runs under the lifecycle lock after task completion and before STATUS or terminal publication can observe the record. It must not publish progress or acquire transport resources. The task's recorded end time retains its existing boundary. Already admitted progress is published before the terminal record; new progress admissions after a terminal transition are discarded.

Installation

python -m pip install zmqruntime

Documentation: zmqruntime.readthedocs.io.

For local development, install the documentation dependencies and run a clean, warning-fatal build:

python -m pip install -e ".[dev,docs]"
python -m sphinx -E -W --keep-going -b html docs/source docs/_build/html

Repository: OpenHCSDev/ZMQRuntime.

Metadata

Release files for zmqruntime 0.6.5

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for zmqruntime 0.6.5
File	Size	Uploaded
zmqruntime-0.6.5.tar.gz	728.6 kB	Oct 12, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for zmqruntime 0.6.5
File	Interpreter	ABI	Platform	Reset
zmqruntime-0.6.5-py3-none-any.whl 99.0 kB Oct 12, 2026	Python 3	none	any	Details

Total release size: 827.6 kB

Release files / zmqruntime-0.6.5.tar.gz

Download URL	zmqruntime-0.6.5.tar.gz
Size	728.6 kB
Tags	Source
SHA-256 checksum How to use checksums	`b63cb6d3bd95d522e8db4213cd74a6ccb7058dc7d16bff756e08eb6585b2101b`
BLAKE2b-256 checksum How to use checksums	`42b8fed21fa56ddc7ea1e9d3c517fa54b8aea81cf0e5b8ca6086d477e0bb3de8`
Upload date	Oct 12, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/OpenHCSDev/ZMQRuntime
Publishing commit: github.com/OpenHCSDev/ZMQRuntime/tree/cae648c036b60fae2ffae2c0d67650389f5e9f19

Workflow

Publishing configuration: github.com/OpenHCSDev/ZMQRuntime/blob/cae648c036b60fae2ffae2c0d67650389f5e9f19/.github/workflows/publish.yml
Publishing logs: github.com/OpenHCSDev/ZMQRuntime/actions/runs/38309164194/attempts/1

Artifact

Subject: zmqruntime-0.6.5.tar.gz
SHA-256 checksum: b63cb6d3bd95d522e8db4213cd74a6ccb7058dc7d16bff756e08eb6585b2101b Verifying attestations

Release files / zmqruntime-0.6.5-py3-none-any.whl

Download URL	zmqruntime-0.6.5-py3-none-any.whl
Size	99.0 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`f27f91c4bca10f72985743ae53e05b1557c03380438d226f2714142cd127c76d`
BLAKE2b-256 checksum How to use checksums	`6935428582be6777f5c8be66bdd898597246e98d2cb674c412844d982e187121`
Upload date	Oct 12, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/OpenHCSDev/ZMQRuntime
Publishing commit: github.com/OpenHCSDev/ZMQRuntime/tree/cae648c036b60fae2ffae2c0d67650389f5e9f19

Workflow

Publishing configuration: github.com/OpenHCSDev/ZMQRuntime/blob/cae648c036b60fae2ffae2c0d67650389f5e9f19/.github/workflows/publish.yml
Publishing logs: github.com/OpenHCSDev/ZMQRuntime/actions/runs/38309164194/attempts/1

Artifact

Subject: zmqruntime-0.6.5-py3-none-any.whl
SHA-256 checksum: f27f91c4bca10f72985743ae53e05b1557c03380438d226f2714142cd127c76d Verifying attestations