mirror of
https://github.com/Such-Software/adaptive-multi-protocol-browser.git
synced 2026-10-17 14:31:46 +02:00
369 lines
16 KiB
Python
369 lines
16 KiB
Python
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_direct_profile_and_handoff_extension(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)
|
|
|
|
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("http://*.onion/*", manifest)
|
|
self.assertIn("wss://*.i2p/*", manifest)
|
|
self.assertIn("cancel: true", background)
|
|
self.assertIn("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.assertTrue((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()
|