mirror of
https://github.com/shadowsocks/ShadowsocksX-NG.git
synced 2026-11-22 05:25:41 +00:00
Tests/ 根层原有 138 个平铺测试文件,无法从目录读出测试覆盖的功能领域。 按功能领域重组为 17 个目录(Catalog/Workflow 与 Rules/Custom 两处嵌套,分别 对应 App/Application/CatalogWorkflow 与 Domain/Rules/Custom):Architecture / Support / Agent / Activation / Catalog / Subscription / Rules / ProxyRuntime / ProxyControl / Runtime / Settings / SystemProxy / Plugin / Diagnostics / Credentials / Workspace / Servers;Smoke/ 保持独立 target 不动。138 个移动中 132 个是 100% 相似度的纯重命名,其余 6 个在重命名之上带路径反推改写(见下)。 本次不是纯搬移:测试代码比生产代码多一层位置耦合,有 7 处用固定层数的 deletingLastPathComponent() 从 #filePath 反推仓库路径(都假定文件就在 Tests/ 根层)。这 7 处改走新增的 Tests/Support/TestSourceTree.swift——从调用点沿父 目录上溯找到含 project.yml 的目录,因此不再依赖父目录层数,以后移动测试文件 也不会静默指错。 配套改动: - 新增 Tests 布局守卫 TestsLayoutTests,断言 Tests/ 根层无平铺 .swift。比 Domain 那条弱一档——根层的 Info.plist(info.path 生成物)与 Fixtures/RuleSnapshots 下的 JSON(folder resource)都必须保留,不能用 「树下只有 .swift」覆盖。 - project.yml:Smoke target 按文件引用的 Tests/AppArtifact.swift 改指 Tests/Support/;两处注释里写死的 Tests/SkeletonTests.swift 随移动更新。 excludes 的裸名 "Smoke" / "Fixtures" 仍匹配 Tests/ 直属子目录,无需改动。 - README 的 Tests 条目展开为目录说明,并修掉 Domain 条目里写死的 Tests/SkeletonTests.swift。 - 顺带删去 DomainLayoutTests 文档注释里「整理前 62 个文件」这类易漂移的数字。 验证:xcodegen generate 后单测 target 为 139 个源文件(全部非 Smoke 文件,0 个 Smoke 文件混入)且仍以 Fixtures/RuleSnapshots 为资源,Smoke target 为 8 个 Smoke 文件加 AppArtifact;依赖路径反推的 6 个测试类全绿(路径指错即失败); task format 未改写任何被移动文件;task lint 与整理前同为 21 条内容型 warning; build 0 error;task test 1025 用例全通过(整理前 1024,+1 为新守卫); TestsLayoutTests 经变异验证(根层投放探针即失败);packaging-gate ALL CHECKS PASSED。
207 lines
8.1 KiB
Swift
207 lines
8.1 KiB
Swift
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,
|
||
systemProxyApprovalRequired: Bool = false,
|
||
mode: ProxyMode = .rule,
|
||
activeTarget: ProxyActiveTargetFacts? = nil
|
||
) -> ProxyControlSnapshot {
|
||
ProxyControlSnapshot(
|
||
runtime: facts,
|
||
agentIntentEnabled: agentIntent,
|
||
activationFailure: activationFailure,
|
||
systemProxyIntentEnabled: systemProxyIntent,
|
||
systemProxyApplication: systemProxyApplication,
|
||
systemProxyApprovalRequired: systemProxyApprovalRequired,
|
||
proxyMode: mode,
|
||
ruleDefaultAction: .proxyWhenUnmatched,
|
||
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;"),
|
||
commandAddressPicker: TerminalCommandAddressPicker(
|
||
isVisible: false,
|
||
candidates: [
|
||
TerminalCommandAddress(bsdName: "lo0", address: "127.0.0.1", displayName: "lo0")
|
||
],
|
||
selected: TerminalCommandAddress(bsdName: "lo0", address: "127.0.0.1", displayName: "lo0")),
|
||
terminalProxyEnvironmentCommands: TerminalProxyEnvironmentCommands(
|
||
listen: RuntimeListenFacts(listen: SslocalListenSettings()),
|
||
commandAddress: TerminalCommandAddress(
|
||
bsdName: "lo0", address: "127.0.0.1", displayName: "lo0")))
|
||
}
|
||
|
||
// 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 approvalPending = StatusMenuModel.summary(
|
||
from: makeSnapshot(
|
||
facts: ProxyRuntimeFacts(status: .running, isOn: true),
|
||
systemProxyIntent: true,
|
||
systemProxyApplication: .pending,
|
||
systemProxyApprovalRequired: true))
|
||
XCTAssertEqual(approvalPending.systemProxyStatus, "系统代理:待批准")
|
||
XCTAssertNil(approvalPending.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(.operation(.applyFailed))))
|
||
XCTAssertEqual(failed.systemProxyStatus, "系统代理:应用失败")
|
||
XCTAssertEqual(
|
||
failed.systemProxyDetail,
|
||
AppPresentation.message(
|
||
for: RuntimeFailureFacts.systemProxy(.operation(.applyFailed))))
|
||
}
|
||
|
||
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)
|
||
}
|
||
}
|