def execution_request(
self,
products: Sequence[type],
subjects: Sequence[Any | Params],
poll: bool = False,
poll_delay: float | None = None,
timeout: float | None = None,
) -> ExecutionRequest:
"""Create and return an ExecutionRequest for the given products and subjects.
The resulting ExecutionRequest object will contain keys tied to this scheduler's product
Graph, and so it will not be directly usable with other scheduler instances without being
re-created.
NB: This method does a "cross product", mapping all subjects to all products.
:param products: A list of product types to request for the roots.
:param subjects: A list of singleton input parameters or Params instances.
:param poll: True to wait for _all_ of the given roots to
have changed since their last observed values in this SchedulerSession.
:param poll_delay: A delay (in seconds) to wait after observing a change, and before
beginning to compute a new value.
:param timeout: An optional timeout to wait for the request to complete (in seconds). If the
request has not completed before the timeout has elapsed, ExecutionTimeoutError is raised.
:returns: An ExecutionRequest for the given products and subjects.
"""
request_specs = tuple((s, p) for s in subjects for p in products)
native_execution_request = PyExecutionRequest(
poll=poll,
poll_delay_in_ms=int(poll_delay * 1000) if poll_delay else None,
timeout_in_ms=int(timeout * 1000) if timeout else None,
)
for subject, product in request_specs:
self._scheduler.execution_add_root_select(native_execution_request,
subject, product)
return ExecutionRequest(request_specs, native_execution_request)
def new_execution_request(self) -> PyExecutionRequest:
return PyExecutionRequest()