autoglm-gui 1.5.0__py3-none-any.whl → 1.5.1__py3-none-any.whl

phone_agent/config/timing.py

@@ -1,167 +0,0 @@
-"""Timing configuration for Phone Agent.
-
-This module defines all configurable waiting times used throughout the application.
-Users can customize these values by modifying this file or by setting environment variables.
-"""
-
-import os
-from dataclasses import dataclass
-
-
-@dataclass
-class ActionTimingConfig:
-    """Configuration for action handler timing delays."""
-
-    # Text input related delays (in seconds)
-    keyboard_switch_delay: float = 1.0  # Delay after switching to ADB keyboard
-    text_clear_delay: float = 1.0  # Delay after clearing text
-    text_input_delay: float = 1.0  # Delay after typing text
-    keyboard_restore_delay: float = 1.0  # Delay after restoring original keyboard
-
-    def __post_init__(self):
-        """Load values from environment variables if present."""
-        self.keyboard_switch_delay = float(
-            os.getenv("PHONE_AGENT_KEYBOARD_SWITCH_DELAY", self.keyboard_switch_delay)
-        )
-        self.text_clear_delay = float(
-            os.getenv("PHONE_AGENT_TEXT_CLEAR_DELAY", self.text_clear_delay)
-        )
-        self.text_input_delay = float(
-            os.getenv("PHONE_AGENT_TEXT_INPUT_DELAY", self.text_input_delay)
-        )
-        self.keyboard_restore_delay = float(
-            os.getenv("PHONE_AGENT_KEYBOARD_RESTORE_DELAY", self.keyboard_restore_delay)
-        )
-
-
-@dataclass
-class DeviceTimingConfig:
-    """Configuration for device operation timing delays."""
-
-    # Default delays for various device operations (in seconds)
-    default_tap_delay: float = 1.0  # Default delay after tap
-    default_double_tap_delay: float = 1.0  # Default delay after double tap
-    double_tap_interval: float = 0.1  # Interval between two taps in double tap
-    default_long_press_delay: float = 1.0  # Default delay after long press
-    default_swipe_delay: float = 1.0  # Default delay after swipe
-    default_back_delay: float = 1.0  # Default delay after back button
-    default_home_delay: float = 1.0  # Default delay after home button
-    default_launch_delay: float = 1.0  # Default delay after launching app
-
-    def __post_init__(self):
-        """Load values from environment variables if present."""
-        self.default_tap_delay = float(
-            os.getenv("PHONE_AGENT_TAP_DELAY", self.default_tap_delay)
-        )
-        self.default_double_tap_delay = float(
-            os.getenv("PHONE_AGENT_DOUBLE_TAP_DELAY", self.default_double_tap_delay)
-        )
-        self.double_tap_interval = float(
-            os.getenv("PHONE_AGENT_DOUBLE_TAP_INTERVAL", self.double_tap_interval)
-        )
-        self.default_long_press_delay = float(
-            os.getenv("PHONE_AGENT_LONG_PRESS_DELAY", self.default_long_press_delay)
-        )
-        self.default_swipe_delay = float(
-            os.getenv("PHONE_AGENT_SWIPE_DELAY", self.default_swipe_delay)
-        )
-        self.default_back_delay = float(
-            os.getenv("PHONE_AGENT_BACK_DELAY", self.default_back_delay)
-        )
-        self.default_home_delay = float(
-            os.getenv("PHONE_AGENT_HOME_DELAY", self.default_home_delay)
-        )
-        self.default_launch_delay = float(
-            os.getenv("PHONE_AGENT_LAUNCH_DELAY", self.default_launch_delay)
-        )
-
-
-@dataclass
-class ConnectionTimingConfig:
-    """Configuration for ADB connection timing delays."""
-
-    # ADB server and connection delays (in seconds)
-    adb_restart_delay: float = 2.0  # Wait time after enabling TCP/IP mode
-    server_restart_delay: float = (
-        1.0  # Wait time between killing and starting ADB server
-    )
-
-    def __post_init__(self):
-        """Load values from environment variables if present."""
-        self.adb_restart_delay = float(
-            os.getenv("PHONE_AGENT_ADB_RESTART_DELAY", self.adb_restart_delay)
-        )
-        self.server_restart_delay = float(
-            os.getenv("PHONE_AGENT_SERVER_RESTART_DELAY", self.server_restart_delay)
-        )
-
-
-@dataclass
-class TimingConfig:
-    """Master timing configuration combining all timing settings."""
-
-    action: ActionTimingConfig
-    device: DeviceTimingConfig
-    connection: ConnectionTimingConfig
-
-    def __init__(self):
-        """Initialize all timing configurations."""
-        self.action = ActionTimingConfig()
-        self.device = DeviceTimingConfig()
-        self.connection = ConnectionTimingConfig()
-
-
-# Global timing configuration instance
-# Users can modify these values at runtime or through environment variables
-TIMING_CONFIG = TimingConfig()
-
-
-def get_timing_config() -> TimingConfig:
-    """
-    Get the global timing configuration.
-
-    Returns:
-        The global TimingConfig instance.
-    """
-    return TIMING_CONFIG
-
-
-def update_timing_config(
-    action: ActionTimingConfig | None = None,
-    device: DeviceTimingConfig | None = None,
-    connection: ConnectionTimingConfig | None = None,
-) -> None:
-    """
-    Update the global timing configuration.
-
-    Args:
-        action: New action timing configuration.
-        device: New device timing configuration.
-        connection: New connection timing configuration.
-
-    Example:
-        >>> from phone_agent.config.timing import update_timing_config, ActionTimingConfig
-        >>> custom_action = ActionTimingConfig(
-        ...     keyboard_switch_delay=0.5,
-        ...     text_input_delay=0.5
-        ... )
-        >>> update_timing_config(action=custom_action)
-    """
-    global TIMING_CONFIG
-    if action is not None:
-        TIMING_CONFIG.action = action
-    if device is not None:
-        TIMING_CONFIG.device = device
-    if connection is not None:
-        TIMING_CONFIG.connection = connection
-
-
-__all__ = [
-    "ActionTimingConfig",
-    "DeviceTimingConfig",
-    "ConnectionTimingConfig",
-    "TimingConfig",
-    "TIMING_CONFIG",
-    "get_timing_config",
-    "update_timing_config",
-]

phone_agent/device_factory.py

@@ -1,166 +0,0 @@
-"""Device factory for selecting ADB or HDC based on device type."""
-
-from enum import Enum
-
-
-class DeviceType(Enum):
-    """Type of device connection tool."""
-
-    ADB = "adb"
-    HDC = "hdc"
-    IOS = "ios"
-
-
-class DeviceFactory:
-    """
-    Factory class for getting device-specific implementations.
-
-    This allows the system to work with both Android (ADB) and HarmonyOS (HDC) devices.
-    """
-
-    def __init__(self, device_type: DeviceType = DeviceType.ADB):
-        """
-        Initialize the device factory.
-
-        Args:
-            device_type: The type of device to use (ADB or HDC).
-        """
-        self.device_type = device_type
-        self._module = None
-
-    @property
-    def module(self):
-        """Get the appropriate device module (adb or hdc)."""
-        if self._module is None:
-            if self.device_type == DeviceType.ADB:
-                from phone_agent import adb
-
-                self._module = adb
-            elif self.device_type == DeviceType.HDC:
-                from phone_agent import hdc
-
-                self._module = hdc
-            else:
-                raise ValueError(f"Unknown device type: {self.device_type}")
-        return self._module
-
-    def get_screenshot(self, device_id: str | None = None, timeout: int = 10):
-        """Get screenshot from device."""
-        return self.module.get_screenshot(device_id, timeout)
-
-    def get_current_app(self, device_id: str | None = None) -> str:
-        """Get current app name."""
-        return self.module.get_current_app(device_id)
-
-    def tap(
-        self, x: int, y: int, device_id: str | None = None, delay: float | None = None
-    ):
-        """Tap at coordinates."""
-        return self.module.tap(x, y, device_id, delay)
-
-    def double_tap(
-        self, x: int, y: int, device_id: str | None = None, delay: float | None = None
-    ):
-        """Double tap at coordinates."""
-        return self.module.double_tap(x, y, device_id, delay)
-
-    def long_press(
-        self,
-        x: int,
-        y: int,
-        duration_ms: int = 3000,
-        device_id: str | None = None,
-        delay: float | None = None,
-    ):
-        """Long press at coordinates."""
-        return self.module.long_press(x, y, duration_ms, device_id, delay)
-
-    def swipe(
-        self,
-        start_x: int,
-        start_y: int,
-        end_x: int,
-        end_y: int,
-        duration_ms: int | None = None,
-        device_id: str | None = None,
-        delay: float | None = None,
-    ):
-        """Swipe from start to end."""
-        return self.module.swipe(
-            start_x, start_y, end_x, end_y, duration_ms, device_id, delay
-        )
-
-    def back(self, device_id: str | None = None, delay: float | None = None):
-        """Press back button."""
-        return self.module.back(device_id, delay)
-
-    def home(self, device_id: str | None = None, delay: float | None = None):
-        """Press home button."""
-        return self.module.home(device_id, delay)
-
-    def launch_app(
-        self, app_name: str, device_id: str | None = None, delay: float | None = None
-    ) -> bool:
-        """Launch an app."""
-        return self.module.launch_app(app_name, device_id, delay)
-
-    def type_text(self, text: str, device_id: str | None = None):
-        """Type text."""
-        return self.module.type_text(text, device_id)
-
-    def clear_text(self, device_id: str | None = None):
-        """Clear text."""
-        return self.module.clear_text(device_id)
-
-    def detect_and_set_adb_keyboard(self, device_id: str | None = None) -> str:
-        """Detect and set keyboard."""
-        return self.module.detect_and_set_adb_keyboard(device_id)
-
-    def restore_keyboard(self, ime: str, device_id: str | None = None):
-        """Restore keyboard."""
-        return self.module.restore_keyboard(ime, device_id)
-
-    def list_devices(self):
-        """List connected devices."""
-        return self.module.list_devices()
-
-    def get_connection_class(self):
-        """Get the connection class (ADBConnection or HDCConnection)."""
-        if self.device_type == DeviceType.ADB:
-            from phone_agent.adb import ADBConnection
-
-            return ADBConnection
-        elif self.device_type == DeviceType.HDC:
-            from phone_agent.hdc import HDCConnection
-
-            return HDCConnection
-        else:
-            raise ValueError(f"Unknown device type: {self.device_type}")
-
-
-# Global device factory instance
-_device_factory: DeviceFactory | None = None
-
-
-def set_device_type(device_type: DeviceType):
-    """
-    Set the global device type.
-
-    Args:
-        device_type: The device type to use (ADB or HDC).
-    """
-    global _device_factory
-    _device_factory = DeviceFactory(device_type)
-
-
-def get_device_factory() -> DeviceFactory:
-    """
-    Get the global device factory instance.
-
-    Returns:
-        The device factory instance.
-    """
-    global _device_factory
-    if _device_factory is None:
-        _device_factory = DeviceFactory(DeviceType.ADB)  # Default to ADB
-    return _device_factory

phone_agent/hdc/__init__.py

@@ -1,53 +0,0 @@
-"""HDC utilities for HarmonyOS device interaction."""
-
-from phone_agent.hdc.connection import (
-    HDCConnection,
-    ConnectionType,
-    DeviceInfo,
-    list_devices,
-    quick_connect,
-    set_hdc_verbose,
-)
-from phone_agent.hdc.device import (
-    back,
-    double_tap,
-    get_current_app,
-    home,
-    launch_app,
-    long_press,
-    swipe,
-    tap,
-)
-from phone_agent.hdc.input import (
-    clear_text,
-    detect_and_set_adb_keyboard,
-    restore_keyboard,
-    type_text,
-)
-from phone_agent.hdc.screenshot import get_screenshot
-
-__all__ = [
-    # Screenshot
-    "get_screenshot",
-    # Input
-    "type_text",
-    "clear_text",
-    "detect_and_set_adb_keyboard",
-    "restore_keyboard",
-    # Device control
-    "get_current_app",
-    "tap",
-    "swipe",
-    "back",
-    "home",
-    "double_tap",
-    "long_press",
-    "launch_app",
-    # Connection management
-    "HDCConnection",
-    "DeviceInfo",
-    "ConnectionType",
-    "quick_connect",
-    "list_devices",
-    "set_hdc_verbose",
-]