Files
ShadowsocksX-NG/ShadowsocksX-NG2/Tests/StatusMenuModelTests.swift
T
Qiu Yuzhou 398e8d84b6 feat(ng2): split agent and system proxy switches
实现 #60(ACL 1/8):agent 意图与系统代理意图拆为两个独立开关,
首次运行默认 agent 开、系统代理关;显式关闭 agent 持久化并在 GUI
重启后生效;关闭系统代理只恢复 NG2 持有的系统设置,本地 SOCKS/HTTP
继续监听;关闭 agent 先恢复系统设置再停止监听。无活动目标时 agent
以空服务器列表契约提供本地监听(isWellFormed 放行空 servers,上游
sslocal v1.25.0 接受);需要代理出口的模式在活动目标缺失或端点不健
康时系统代理保持待应用,条件恢复后随下次收敛自动应用。首页、状态菜
单与侧栏状态卡经同一代理控制快照展示/操作 agent 意图/运行状态与系
统代理意图/实际应用及 typed 错误。测试覆盖启动顺序、持久化、健康门
禁、ownership 冲突、无效活动目标与 GUI 重同步(含真实 sslocal 空监
听回环证据);替身测试不表述为真实系统写入验证。
2026-09-26 00:38:28 +08:00

184 lines
7.0 KiB
Swift
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
import XCTest
@testable import ShadowsocksX_NG2
/// 状态菜单呈现逻辑(spec #21 D11,issue #31/#47/#60):头部状态摘要从代理
/// 控制工作流的整体 snapshot 派生,agent 与系统代理两个状态面分开呈现。不
/// 持有 AppKit 类型;HTTP 导出行与目标路径摘要分别在代理控制与目录 module
/// 测试覆盖。
final class StatusMenuModelTests: XCTestCase {
private struct RuntimeSummaryCase {
let facts: ProxyRuntimeFacts
let expectedStatus: String
let expectedIsOn: Bool
}
private static let runtimeSummaryCases: [RuntimeSummaryCase] = [
RuntimeSummaryCase(
facts: ProxyRuntimeFacts(status: .starting, isOn: true),
expectedStatus: "正在启动代理…",
expectedIsOn: true),
RuntimeSummaryCase(
facts: ProxyRuntimeFacts(status: .running, isOn: true),
expectedStatus: "代理运行中",
expectedIsOn: true),
RuntimeSummaryCase(
facts: ProxyRuntimeFacts(
status: .firewallBlocked,
isOn: true,
failure: .firewallBlocked(FirewallBlockedFacts(executableName: "sslocal"))),
expectedStatus: "代理运行中(局域网受阻)",
expectedIsOn: true),
RuntimeSummaryCase(
facts: ProxyRuntimeFacts(
status: .launchFailed,
isOn: false,
failure: .launch(
.localEndpoint(
endpoint: "http", host: "127.0.0.1", port: 11087, cause: .refused))),
expectedStatus: "启动失败",
expectedIsOn: false),
RuntimeSummaryCase(
facts: ProxyRuntimeFacts(
status: .requiresApproval, isOn: true, failure: .requiresApproval),
expectedStatus: "等待允许后台代理",
expectedIsOn: true),
RuntimeSummaryCase(
facts: ProxyRuntimeFacts(
status: .serviceFailed,
isOn: false,
failure: .service(.persistence)),
expectedStatus: "服务管理失败",
expectedIsOn: false),
]
/// 从运行时事实构造最小 snapshot(其余字段与本组用例无关)。
private func makeSnapshot(
facts: ProxyRuntimeFacts,
agentIntent: Bool = true,
activationFailure: ActivationFailure? = nil,
systemProxyIntent: Bool = false,
systemProxyApplication: SystemProxyApplicationFacts = .idle,
mode: ProxyMode = .pac,
activeTarget: ProxyActiveTargetFacts? = nil
) -> ProxyControlSnapshot {
ProxyControlSnapshot(
runtime: facts,
agentIntentEnabled: agentIntent,
activationFailure: activationFailure,
systemProxyIntentEnabled: systemProxyIntent,
systemProxyApplication: systemProxyApplication,
proxyMode: mode,
availableModes: ProxyMode.availableModes,
activeTarget: activeTarget,
skippedInvalidServerCount: 0,
httpExport: HTTPExportCapability(
copyableLine:
"export http_proxy=http://127.0.0.1:11087;export https_proxy=http://127.0.0.1:11087;"))
}
// MARK: - 头部状态摘要
func testSummaryRunningStateIsOnWithNoDetail() {
let summary = StatusMenuModel.summary(
from: makeSnapshot(facts: ProxyRuntimeFacts(status: .running, isOn: true)))
XCTAssertTrue(summary.agentIntentEnabled)
XCTAssertTrue(summary.isOn)
XCTAssertEqual(summary.status, "代理运行中")
XCTAssertNil(summary.detail)
}
func testSummaryOffStateIsOff() {
let summary = StatusMenuModel.summary(
from: makeSnapshot(
facts: ProxyRuntimeFacts(status: .off, isOn: false),
agentIntent: false,
mode: .global))
XCTAssertFalse(summary.agentIntentEnabled, "开关意图独立于运行状态")
XCTAssertFalse(summary.isOn)
XCTAssertEqual(summary.status, "代理未运行")
XCTAssertNil(summary.detail)
}
func testSummaryProjectsEveryStableRuntimeStatus() {
for testCase in Self.runtimeSummaryCases {
let summary = StatusMenuModel.summary(from: makeSnapshot(facts: testCase.facts))
XCTAssertEqual(summary.isOn, testCase.expectedIsOn)
XCTAssertEqual(summary.status, testCase.expectedStatus)
XCTAssertEqual(
summary.detail,
testCase.facts.failure.map { AppPresentation.message(for: $0) })
}
}
/// 激活拒绝/目标清除的点名原因独立于运行状态呈现(issue #60):agent 仍
/// 在监听时也必须可读。
func testSummaryCarriesActivationFailureAlongsideRunningState() {
let summary = StatusMenuModel.summary(
from: makeSnapshot(
facts: ProxyRuntimeFacts(status: .running, isOn: true),
activationFailure: .targetNotFound(NodeID(rawValue: "manual:gone"))))
XCTAssertEqual(summary.status, "代理运行中")
XCTAssertEqual(
summary.detail,
AppPresentation.message(
for: ActivationFailure.targetNotFound(
NodeID(rawValue: "manual:gone"))))
}
/// 系统代理状态面(issue #60):意图与实际应用分开,失败携带点名原因。
func testSummaryProjectsSystemProxyApplicationIndependently() {
let idle = StatusMenuModel.summary(
from: makeSnapshot(
facts: ProxyRuntimeFacts(status: .off, isOn: false),
systemProxyIntent: false,
systemProxyApplication: .idle))
XCTAssertFalse(idle.systemProxyIntentEnabled)
XCTAssertEqual(idle.systemProxyStatus, "系统代理:未接管")
XCTAssertNil(idle.systemProxyDetail)
let pending = StatusMenuModel.summary(
from: makeSnapshot(
facts: ProxyRuntimeFacts(status: .running, isOn: true),
systemProxyIntent: true,
systemProxyApplication: .pending))
XCTAssertTrue(pending.systemProxyIntentEnabled)
XCTAssertEqual(pending.systemProxyStatus, "系统代理:待应用")
XCTAssertNil(pending.systemProxyDetail)
let applied = StatusMenuModel.summary(
from: makeSnapshot(
facts: ProxyRuntimeFacts(status: .running, isOn: true),
systemProxyIntent: true,
systemProxyApplication: .applied))
XCTAssertEqual(applied.systemProxyStatus, "系统代理:已应用")
let failed = StatusMenuModel.summary(
from: makeSnapshot(
facts: ProxyRuntimeFacts(status: .running, isOn: true),
systemProxyIntent: true,
systemProxyApplication: .failed(.ownershipConflict)))
XCTAssertEqual(failed.systemProxyStatus, "系统代理:应用失败")
XCTAssertEqual(
failed.systemProxyDetail,
AppPresentation.message(for: RuntimeFailureFacts.systemProxy(.ownershipConflict)))
}
func testSummaryCarriesModeLabelAndTargetPathFromSnapshot() {
let summary = StatusMenuModel.summary(
from: makeSnapshot(
facts: ProxyRuntimeFacts(status: .running, isOn: true),
mode: .global,
activeTarget: ProxyActiveTargetFacts(
id: NodeID(rawValue: "manual:server"), pathSummary: "订阅分组 / 嵌套分组 / 日本 02")))
XCTAssertEqual(summary.modeLabel, "全局")
XCTAssertEqual(summary.targetPath, "订阅分组 / 嵌套分组 / 日本 02")
}
func testSummaryTargetPathIsNilWithoutActiveTarget() {
let summary = StatusMenuModel.summary(
from: makeSnapshot(facts: ProxyRuntimeFacts(status: .off, isOn: false)))
XCTAssertNil(summary.targetPath)
}
}