bluesky_queueserver_api.zmq.REManagerAPI.devices_existing

REManagerAPI.devices_existing(*, reload=False)

Returns the list (dictionary) of existing devices. The function checks devices_existing_uid status parameter and downloads the list of existing devices from the server if UID changed. Otherwise the copy of cached list of existing devices is returned.

Parameters:
reload: boolean

Set the parameter True to force reloading of status from the server before devices_existing_uid is checked. Otherwise cached status is used.

Returns:
response: dict

Dictionary keys:

  • success: boolean - success of the request.

  • msg: str - error message in case the request is rejected by RE Manager or operation failed.

  • devices_existing: dict - list (dictionary) of existing devices.

  • devices_existing_uid: str - UID of the list of existing devices.

Raises:
RequestTimeoutError, RequestFailedError, HTTPRequestError, HTTPClientError, HTTPServerError

All exceptions raised by send_request API.

Examples

# Synchronous code (0MQ, HTTP)
response = RM.devices_existing()
devices_existing = response["devices_existing"]

# Asynchronous code (0MQ, HTTP)
response = await RM.devices_existing()
devices_existing = response["devices_existing"]