qmi.core.context_singleton.get_task

qmi.core.context_singleton.get_task(task_name: str, auto_connect: bool = False, host_port: str | None = None) → Any

Return a proxy for the specified task.

The task may exist either in the local context, or in a peer context.

Parameters:

  • task_name – Task name, formatted as "<context_name>.<task_name>".

  • auto_connect – if True, connect automatically to the task peer.

  • host_port – Optional host:port string pattern to guide the auto_connect.

Returns:

A proxy for the specified task.

Raises:

QMI_NoActiveContextException – If there is no active QMI context present.