Method _send_admin_message

unity_cli/client.py:420–449

Send an admin message (LIST_INSTANCES, SET_DEFAULT) without retry. Args: message: Message dict to send. Returns: Response dict from relay server. Raises: ConnectionError: If cannot connect to relay server. ProtocolError: For

(self, message: dict[str, Any])

            self._version_info_called = True

    def _send_admin_message(self, message: dict[str, Any]) -> dict[str, Any]:
        """Send an admin message (LIST_INSTANCES, SET_DEFAULT) without retry.

        Args:
            message: Message dict to send.

        Returns:
            Response dict from relay server.

        Raises:
            ConnectionError: If cannot connect to relay server.
            ProtocolError: For protocol errors.
        """
        sock = socket.socket(socket.AF_INET, socket.SOCK_STREAM)

        try:
            try:
                sock.settimeout(self.timeout)
                sock.connect((self.host, self.port))
            except OSError as e:
                raise ConnectionError(
                    f"Cannot connect to Relay Server at {self.host}:{self.port}",
                    "CONNECTION_FAILED",
                ) from e

            self._write_frame(sock, message)
            return self._read_frame(sock)

        finally:
            sock.close()

    def list_instances(self) -> list[dict[str, Any]]:
        """List all connected Unity instances.