Function build_launch_command

launcher/process.py:53–92

Build the command-line arguments for launching the internal Camoufox process. This is a pure function (no I/O) that can be easily unit tested. Args: final_launch_mode: The launch mode (headless, virtual_headless, debug) effective_active_auth_json_path: Path to auth fil

(
    final_launch_mode: str,
    effective_active_auth_json_path: Optional[str],
    simulated_os_for_camoufox: str,
    camoufox_debug_port: int,
    internal_camoufox_proxy: Optional[str],
)

def build_launch_command(
    final_launch_mode: str,
    effective_active_auth_json_path: Optional[str],
    simulated_os_for_camoufox: str,
    camoufox_debug_port: int,
    internal_camoufox_proxy: Optional[str],
) -> list[str]:
    """
    Build the command-line arguments for launching the internal Camoufox process.

    This is a pure function (no I/O) that can be easily unit tested.

    Args:
        final_launch_mode: The launch mode (headless, virtual_headless, debug)
        effective_active_auth_json_path: Path to auth file, or None
        simulated_os_for_camoufox: OS to simulate (linux, windows, macos)
        camoufox_debug_port: Debug port for Camoufox
        internal_camoufox_proxy: Proxy configuration, or None

    Returns:
        List of command-line arguments for subprocess.Popen
    """
    cmd = [
        PYTHON_EXECUTABLE,
        "-u",
        sys.argv[0],
        "--internal-launch-mode",
        final_launch_mode,
    ]

    if effective_active_auth_json_path:
        cmd.extend(["--internal-auth-file", effective_active_auth_json_path])

    cmd.extend(["--internal-camoufox-os", simulated_os_for_camoufox])
    cmd.extend(["--internal-camoufox-port", str(camoufox_debug_port)])

    if internal_camoufox_proxy is not None:
        cmd.extend(["--internal-camoufox-proxy", internal_camoufox_proxy])

    return cmd


class CamoufoxProcessManager: