Class XCTestConnection

phone_agent/xctest/connection.py:28–348

Manages connections to iOS devices via libimobiledevice and WebDriverAgent. Requires: - libimobiledevice (idevice_id, ideviceinfo) - WebDriverAgent running on the iOS device - ios-deploy (optional, for app installation) Example: >>> conn = XCTestConnect

class XCTestConnection:
    """
    Manages connections to iOS devices via libimobiledevice and WebDriverAgent.

    Requires:
        - libimobiledevice (idevice_id, ideviceinfo)
        - WebDriverAgent running on the iOS device
        - ios-deploy (optional, for app installation)

    Example:
        >>> conn = XCTestConnection()
        >>> # List connected devices
        >>> devices = conn.list_devices()
        >>> # Get device info
        >>> info = conn.get_device_info()
        >>> # Check if WDA is running
        >>> is_ready = conn.is_wda_ready()
    """

    def __init__(self, wda_url: str = "http://localhost:8100"):
        """
        Initialize iOS connection manager.

        Args:
            wda_url: WebDriverAgent URL (default: http://localhost:8100).
                     For network devices, use http://<device-ip>:8100
        """
        self.wda_url = wda_url.rstrip("/")

    def list_devices(self) -> list[DeviceInfo]:
        """
        List all connected iOS devices.

        Returns:
            List of DeviceInfo objects.

        Note:
            Requires libimobiledevice to be installed.
            Install on macOS: brew install libimobiledevice
        """
        try:
            # Get list of device UDIDs
            result = subprocess.run(
                ["idevice_id", "-ln"],
                capture_output=True,
                text=True,
                timeout=5,
            )

            devices = []
            for line in result.stdout.strip().split("\n"):
                udid = line.strip()
                if not udid:
                    continue

                # Determine connection type (network devices have specific format)
                conn_type = (
                    ConnectionType.NETWORK