github-such-software/adaptive-multi-protocol-browser
1
0
Fork 0
mirror of https://github.com/Such-Software/adaptive-multi-protocol-browser.git synced 2026-10-17 14:31:46 +02:00
Code Issues Packages Projects Releases Wiki Activity
Files
main
adaptive-multi-protocol-bro…/tests/test_launch.py
T

382 lines
17 KiB
Python
Raw Permalink Blame History

from __future__ import annotations
import unittest
from unittest.mock import patch
import tempfile
from pathlib import Path
from ampbrowser.config import AppConfig
from ampbrowser.launch import RouteHelperLaunch, _route_helper_command, execute_open, prepare_open
from ampbrowser.transports import TransportStatus
class PrepareOpenTest(unittest.TestCase):
def test_route_helper_command_preserves_selected_config(self) -> None:
command = _route_helper_command(
root=Path("/tmp/ampb-root"),
port=44001,
token="test-token",
watch_pid=9876,
config_path=Path("/tmp/ampb-config.toml"),
)
self.assertEqual(("--config", "/tmp/ampb-config.toml"), command[-2:])
def test_clearnet_is_ready_without_consent(self) -> None:
config = AppConfig(runtime_path="/opt/ampb/firefox", transport_modes={})
plan = prepare_open("wownero.org", config=config)
self.assertEqual("ready", plan.status)
self.assertFalse(plan.browse_plan.requires_consent)
self.assertEqual(".ampb/profiles/clearnet", plan.profile_path)
self.assertEqual("-", plan.proxy)
self.assertIsNotNone(plan.launch_spec)
self.assertEqual("/opt/ampb/firefox", plan.launch_spec.runtime_path)
self.assertEqual(".ampb/profiles/clearnet/user.js", plan.launch_spec.user_js_path)
self.assertEqual(
("/opt/ampb/firefox", "--new-instance", "--profile", ".ampb/profiles/clearnet", "https://wownero.org"),
plan.launch_spec.command,
)
def test_missing_i2p_requires_consent_before_setup(self) -> None:
status = TransportStatus(
transport="i2p",
installed=False,
running=False,
endpoint="http://127.0.0.1:4444",
adoptable=False,
manage_supported=True,
note="I2P HTTP proxy",
)
with patch("ampbrowser.plan.inspect_transport", return_value=status):
plan = prepare_open("http://example.b32.i2p/")
self.assertEqual("consent-required", plan.status)
self.assertFalse(plan.consent_granted)
self.assertEqual(
("install I2P provider", "start managed I2P router", "wait for http://127.0.0.1:4444"),
plan.setup_steps,
)
self.assertIn("install and start", plan.message)
self.assertEqual("Set up I2P?", plan.setup_prompt_title)
self.assertIn("I2P is not installed or running.", plan.setup_prompt_body)
self.assertIn("http://example.b32.i2p/", plan.setup_prompt_body)
self.assertEqual("Start I2P and open", plan.setup_prompt_approve_label)
self.assertEqual(
"ampbrowser open http://example.b32.i2p/ --yes --launch",
plan.setup_prompt_approval_command,
)
def test_yes_approves_setup_without_executing_it(self) -> None:
status = TransportStatus(
transport="tor",
installed=True,
running=False,
endpoint="socks5://127.0.0.1:9050",
adoptable=False,
manage_supported=True,
note="Tor SOCKS proxy",
)
with patch("ampbrowser.plan.inspect_transport", return_value=status):
plan = prepare_open("http://example.onion/", consent=True)
self.assertEqual("setup-approved", plan.status)
self.assertTrue(plan.dry_run)
self.assertTrue(plan.consent_granted)
self.assertEqual(("start managed Arti SOCKS proxy", "wait for socks5://127.0.0.1:9050"), plan.setup_steps)
self.assertEqual("Set up Tor?", plan.setup_prompt_title)
self.assertIn("Tor is not running.", plan.setup_prompt_body)
self.assertEqual("Start Tor and open", plan.setup_prompt_approve_label)
def test_adopted_tor_launch_spec_sets_socks_remote_dns(self) -> None:
status = TransportStatus(
transport="tor",
installed=True,
running=True,
endpoint="socks5://127.0.0.1:9050",
adoptable=True,
manage_supported=True,
note="Tor SOCKS proxy",
)
config = AppConfig(runtime_path="/opt/ampb/firefox", transport_modes={})
with patch("ampbrowser.plan.inspect_transport", return_value=status):
plan = prepare_open("http://example.onion/", config=config)
self.assertEqual("ready", plan.status)
self.assertIsNotNone(plan.launch_spec)
self.assertIn('user_pref("network.proxy.socks", "127.0.0.1");', plan.launch_spec.prefs)
self.assertIn('user_pref("network.proxy.socks_port", 9050);', plan.launch_spec.prefs)
self.assertIn('user_pref("network.proxy.socks_remote_dns", true);', plan.launch_spec.prefs)
def test_execute_open_writes_profile_and_launches_when_ready(self) -> None:
with tempfile.TemporaryDirectory() as tmp:
root = Path(tmp)
runtime = root / "firefox"
runtime.write_text("#!/bin/sh\n", encoding="utf-8")
config = AppConfig(runtime_path=str(runtime), transport_modes={})
plan = prepare_open("wownero.org", config=config)
with patch("ampbrowser.launch.subprocess.Popen") as popen:
launched = execute_open(plan, root=root)
self.assertEqual("launched", launched.status)
self.assertFalse(launched.dry_run)
self.assertEqual(popen.return_value.pid, launched.browser_pid)
popen.assert_called_once_with(
(
str(runtime),
"--new-instance",
"--profile",
str(root / ".ampb/profiles/clearnet"),
"https://wownero.org",
),
cwd=str(root),
start_new_session=True,
)
user_js = root / ".ampb/profiles/clearnet/user.js"
self.assertTrue(user_js.exists())
self.assertIn('user_pref("network.proxy.type", 0);', user_js.read_text(encoding="utf-8"))
def test_broker_open_writes_single_window_container_router(self) -> None:
with tempfile.TemporaryDirectory() as tmp:
root = Path(tmp)
runtime = root / "firefox"
runtime.write_text("#!/bin/sh\n", encoding="utf-8")
config = AppConfig(runtime_path=str(runtime), transport_modes={})
plan = prepare_open("https://ampgateway.site/", config=config, broker=True)
self.assertEqual(".ampb/profiles/broker", plan.profile_path)
self.assertIsNotNone(plan.launch_spec)
self.assertTrue(plan.launch_spec.broker)
self.assertIn('user_pref("network.proxy.type", 0);', plan.launch_spec.prefs)
self.assertIn('user_pref("media.peerconnection.enabled", false);', plan.launch_spec.prefs)
planned_helper = RouteHelperLaunch("planned", endpoint="http://127.0.0.1:44001/", token="test-token")
helper = RouteHelperLaunch("started", endpoint="http://127.0.0.1:44001/", token="test-token", pid=4321)
with patch("ampbrowser.launch._route_helper_launch_plan", return_value=planned_helper):
with patch("ampbrowser.launch._start_route_helper", return_value=helper):
with patch("ampbrowser.launch.subprocess.Popen") as popen:
launched = execute_open(plan, root=root)
self.assertEqual("launched", launched.status)
self.assertEqual("started", launched.route_helper_status)
self.assertEqual("http://127.0.0.1:44001/", launched.route_helper_endpoint)
self.assertEqual(4321, launched.route_helper_pid)
popen.assert_called_once_with(
(
str(runtime),
"--new-instance",
"--profile",
str(root / ".ampb/profiles/broker"),
"https://ampgateway.site/",
),
cwd=str(root),
start_new_session=True,
)
profile = root / ".ampb/profiles/broker"
user_js = (profile / "user.js").read_text(encoding="utf-8")
self.assertIn('user_pref("network.proxy.type", 0);', user_js)
self.assertFalse((profile / "ampb-proxy.pac").exists())
extension = profile / "extensions/ampb-route-helper@such.software"
manifest = (extension / "manifest.json").read_text(encoding="utf-8")
background = (extension / "background.js").read_text(encoding="utf-8")
setup = (extension / "setup.html").read_text(encoding="utf-8")
self.assertIn("webRequestBlocking", manifest)
self.assertIn("contextualIdentities", manifest)
self.assertIn('"proxy"', manifest)
self.assertIn("<all_urls>", manifest)
self.assertIn("cancel: true", background)
self.assertIn("browser.proxy.onRequest", background)
self.assertIn("cookieStoreId", background)
self.assertIn("browser.tabs.create", background)
self.assertIn("proxyDNS: true", background)
self.assertIn("'<torS0X>0'", background)
self.assertIn("connectionIsolationKey", background)
self.assertIn("blockedProxy", background)
self.assertIn("isHelperRequest", background)
self.assertIn("details.tabId < 0", background)
self.assertIn("helper('status'", background)
self.assertIn("helper('ensure'", background)
self.assertNotIn("helper('open'", background)
self.assertIn("install_command", background)
self.assertIn("http://127.0.0.1:", background)
self.assertNotIn("__AMPB_ROUTE_HELPER_URL__", background)
self.assertNotIn("__AMPB_ROUTE_HELPER_TOKEN__", background)
self.assertIn("Set Up Transport", setup)
self.assertIn("install-command", setup)
self.assertFalse((extension / "handoff.html").exists())
def test_broker_entry_rejects_alternate_transport_url(self) -> None:
plan = prepare_open("http://example.onion/", broker=True)
self.assertEqual("blocked", plan.status)
self.assertEqual(".ampb/profiles/broker", plan.profile_path)
self.assertIn("broker entry URLs must use clearnet", plan.message)
def test_execute_open_blocks_when_runtime_is_missing(self) -> None:
config = AppConfig(runtime_path="/missing/ampb/firefox", transport_modes={})
plan = prepare_open("wownero.org", config=config)
launched = execute_open(plan, root=Path("/tmp"))
self.assertEqual("runtime-missing", launched.status)
self.assertIn("browser runtime not found", launched.message)
def test_execute_open_reuses_recorded_profile_process(self) -> None:
with tempfile.TemporaryDirectory() as tmp:
root = Path(tmp)
runtime = root / "firefox"
runtime.write_text("#!/bin/sh\n", encoding="utf-8")
config = AppConfig(runtime_path=str(runtime), transport_modes={})
plan = prepare_open("https://example.com/", config=config)
with patch("ampbrowser.launch._active_profile_session", return_value=4321):
with patch("ampbrowser.launch.subprocess.Popen") as popen:
popen.return_value.poll.return_value = 0
opened = execute_open(plan, root=root)
self.assertEqual("opened-existing", opened.status)
self.assertEqual(4321, opened.browser_pid)
popen.assert_called_once_with(
(
str(runtime),
"--profile",
str(root / ".ampb/profiles/clearnet"),
"--new-tab",
"https://example.com/",
),
cwd=str(root),
start_new_session=True,
)
def test_broker_launch_stops_helper_when_browser_exits_immediately(self) -> None:
with tempfile.TemporaryDirectory() as tmp:
root = Path(tmp)
runtime = root / "firefox"
runtime.write_text("#!/bin/sh\n", encoding="utf-8")
config = AppConfig(runtime_path=str(runtime), transport_modes={})
plan = prepare_open("https://ampgateway.site/", config=config, broker=True)
planned_helper = RouteHelperLaunch("planned", endpoint="http://127.0.0.1:44001/", token="test-token")
helper = RouteHelperLaunch("started", endpoint="http://127.0.0.1:44001/", token="test-token", pid=4321)
with patch("ampbrowser.launch._route_helper_launch_plan", return_value=planned_helper):
with patch("ampbrowser.launch._start_route_helper", return_value=helper):
with patch("ampbrowser.launch._stop_route_helper", return_value="stopped") as stop_helper:
with patch("ampbrowser.launch.subprocess.Popen") as popen:
popen.return_value.pid = 9876
popen.return_value.poll.return_value = 1
launched = execute_open(plan, root=root)
self.assertEqual("browser-exited", launched.status)
self.assertEqual(9876, launched.browser_pid)
self.assertEqual("stopped", launched.route_helper_status)
self.assertIn("browser exited immediately", launched.message)
stop_helper.assert_called_once_with(helper)
def test_broker_launch_starts_helper_with_browser_pid(self) -> None:
with tempfile.TemporaryDirectory() as tmp:
root = Path(tmp)
runtime = root / "firefox"
runtime.write_text("#!/bin/sh\n", encoding="utf-8")
config = AppConfig(runtime_path=str(runtime), transport_modes={})
plan = prepare_open("https://ampgateway.site/", config=config, broker=True)
planned_helper = RouteHelperLaunch("planned", endpoint="http://127.0.0.1:44001/", token="test-token")
helper = RouteHelperLaunch("started", endpoint="http://127.0.0.1:44001/", token="test-token", pid=4321)
with patch("ampbrowser.launch._route_helper_launch_plan", return_value=planned_helper):
with patch("ampbrowser.launch._start_route_helper", return_value=helper) as start_helper:
with patch("ampbrowser.launch.subprocess.Popen") as popen:
popen.return_value.pid = 9876
popen.return_value.poll.return_value = None
launched = execute_open(plan, root=root)
self.assertEqual("launched", launched.status)
start_helper.assert_called_once()
self.assertEqual(9876, start_helper.call_args.kwargs["watch_pid"])
self.assertEqual("planned", start_helper.call_args.kwargs["planned"].status)
def test_custom_state_dir_changes_profile_path(self) -> None:
config = AppConfig(state_dir=".local/ampb", transport_modes={})
plan = prepare_open("wownero.org", config=config)
self.assertEqual(".local/ampb/profiles/clearnet", plan.profile_path)
def test_android_setup_steps_include_foreground_service(self) -> None:
status = TransportStatus(
transport="i2p",
installed=False,
running=False,
endpoint="http://127.0.0.1:4444",
adoptable=False,
manage_supported=True,
note="I2P HTTP proxy",
)
with patch("ampbrowser.plan.inspect_transport", return_value=status):
plan = prepare_open("http://example.b32.i2p/", platform="android")
self.assertEqual("android", plan.browse_plan.platform_capability.platform)
self.assertEqual(
(
"install or enable Android i2p provider",
"start visible Android foreground service for i2p",
"start managed Android i2p transport",
"wait for http://127.0.0.1:4444",
),
plan.setup_steps,
)
def test_ipfs_desktop_setup_uses_gateway_adapter(self) -> None:
status = TransportStatus(
transport="ipfs",
installed=False,
running=False,
endpoint="http://127.0.0.1:8080",
adoptable=False,
manage_supported=True,
note="IPFS local gateway",
)
with patch("ampbrowser.plan.inspect_transport", return_value=status):
plan = prepare_open("ipfs://bafyexample", consent=True)
self.assertEqual("setup-approved", plan.status)
self.assertEqual(
("install IPFS/Kubo provider", "start managed IPFS gateway", "wait for http://127.0.0.1:8080"),
plan.setup_steps,
)
def test_ios_tor_setup_uses_bundled_arti_runtime(self) -> None:
status = TransportStatus(
transport="tor",
installed=False,
running=False,
endpoint="socks5://127.0.0.1:9050",
adoptable=False,
manage_supported=True,
note="Tor SOCKS proxy",
)
with patch("ampbrowser.plan.inspect_transport", return_value=status):
plan = prepare_open("http://example.onion/", platform="ios")
self.assertEqual("consent-required", plan.status)
self.assertEqual(
(
"enable bundled iOS Arti Tor runtime",
"start foreground-only iOS Arti client session",
"attach in-app onion networking bridge",
"wait for in-app Tor readiness",
),
plan.setup_steps,
)
if __name__ == "__main__":
unittest.main()
Reference in New Issue View Git Blame Copy Permalink