GitHub

WorkerRunner

API reference for WorkerRunner.

class WorkerRunner[O = Any, I = Any]

The worker's end: run a handler for the parent's messages, send it replies. disconnects gives the ports that went away, on platforms with several (None otherwise).

Attributes

AttributeTypeDescription
disconnects= disconnects

Functions

__init__

__init__(*, run, send_unsafe, disconnects=None) -> None
ParameterTypeDescription
runCallable[[Handler], Effect[None, WorkerError, Any]]
send_unsafeCallable[[int, Any, Transfers], None]
disconnectsDequeue[int, Never] | None = None
def __init__(
    self,
    *,
    run: Callable[[Handler], Effect[None, WorkerError, Any]],
    send_unsafe: Callable[[int, Any, Transfers], None],
    disconnects: Dequeue[int, Never] | None = None,
) -> None:
    self._run = run
    self._send_unsafe = send_unsafe
    self.disconnects = disconnects

run

run[A, E = Never, R = Never](handler) -> Effect[None, WorkerError, R]

Handle the parent's messages until it closes the worker. A handler's failure is logged, not propagated.

ParameterTypeDescription
handlerCallable[[int, I], Effect[A, E, R] | None]

Returns Effect[None, WorkerError, R]

def run[A, E = Never, R = Never](
    self, handler: Callable[[int, I], Effect[A, E, R] | None]
) -> Effect[None, WorkerError, R]:
    """Handle the parent's messages until it closes the worker. A
    handler's failure is logged, not propagated."""
    return cast("Effect[None, WorkerError, R]", self._run(handler))

send

send(port_id, message, transfers=()) -> Effect[None]
ParameterTypeDescription
port_idint
messageO
transfersTransfers = ()

Returns Effect[None]

def send(self, port_id: int, message: O, transfers: Transfers = ()) -> Effect[None]:
    return sync(lambda: self._send_unsafe(port_id, message, transfers))

send_unsafe

send_unsafe(port_id, message, transfers=()) -> None
ParameterTypeDescription
port_idint
messageO
transfersTransfers = ()
def send_unsafe(self, port_id: int, message: O, transfers: Transfers = ()) -> None:
    self._send_unsafe(port_id, message, transfers)