Files
ShadowsocksX-NG/ShadowsocksX-NG2/Tests/CatalogViewModelTests.swift
T
Qiu Yuzhou 5e13c1716f feat(ng2): managed plugins end to end (#38)
- 受管插件静态事实表(v2ray-plugin v1.3.2,来源/许可证/版本/重签)与
  BundleManagedPluginProvider:受管集内且 bundle 内可执行文件在位才返回
  绝对路径;与 Vendor 清单双向锚定(D6/D10)
- 服务器编辑器插件区:受管选择器(无 + 受管列表),选中受管项才显示
  供应链事实与参数输入;集外引用显式「本版本未提供」并原样保留
- updateServer 插件落盘语义:「无」整体清除、参数写删钥匙串、集外不漂移
- wrapper 监听建立判定:3 秒未建立本地监听记 error 日志,监管继续(D10)
- 诊断导出新增受管插件清单(名称/版本/提供状态,无参数)
- 功能级兼容实测记录(docs/research/plugin-compat-record.md)与端到端
  冒烟:契约插件路径 → sslocal 拉起 → v2ray-plugin 进程建立 → 停止链
2026-09-21 10:38:30 +08:00

275 lines
12 KiB
Swift

import XCTest
@testable import ShadowsocksX_NG2
/// 主窗口视图模型(issue #32):三入口导入、凭据生命周期、订阅子树只读夹具、
/// 分享互逆与 postCommit 接线。全部走内存凭据存储与临时目录文件存储。
@MainActor
final class CatalogViewModelTests: XCTestCase {
private var workDir: URL!
private var fileURL: URL!
private var credentials: InMemoryCredentialStore!
private var viewModel: CatalogViewModel!
private var commitCounter: CommitCounter!
override func setUp() async throws {
try await super.setUp()
// 专用工作目录:写入器会把父目录强制 0700(不得指向临时根)。
workDir = FileManager.default.temporaryDirectory
.appendingPathComponent("catalog-vm-tests-\(UUID().uuidString)", isDirectory: true)
try FileManager.default.createDirectory(at: workDir, withIntermediateDirectories: true)
fileURL = workDir.appendingPathComponent("catalog.json")
credentials = InMemoryCredentialStore()
commitCounter = CommitCounter()
viewModel = makeViewModel()
}
override func tearDown() async throws {
try? FileManager.default.removeItem(at: workDir)
try await super.tearDown()
}
private func makeViewModel() -> CatalogViewModel {
let model = CatalogViewModel(
fileStore: CatalogFileStore(fileURL: fileURL),
credentials: credentials,
plugins: NoManagedPluginProvider())
let counter = commitCounter!
model.postCommit = { await counter.increment() }
return model
}
private func makeSubscriptionCatalog() throws {
let fixture = try CatalogFixtures.makeSubscriptionFixture()
try CatalogFileStore(fileURL: fileURL).save(CatalogDocument(catalog: fixture.catalog))
viewModel = makeViewModel()
}
private func serverFields(of id: NodeID) -> ServerFields? {
guard case .server(let fields) = viewModel.entry(for: id)?.kind else { return nil }
return fields
}
// MARK: - 三入口导入(共同落点)
func testImportMixedLinesAddsParsedAndReportsFailures() async throws {
let validSIP002 = "ss://YWVzLTI1Ni1nY206cGFzc3dvcmQxMjM@203.0.113.7:8388#香港 01"
let legacy =
"ss://YWVzLTI1Ni1nY206dGVzdEAyMDMuMC4xMTMuNzo4Mzg4"
let outcome = try await viewModel.addServers(
fromURIs: "\(validSIP002)\n垃圾行\n\(legacy)", into: nil)
XCTAssertEqual(outcome.added, 2)
XCTAssertEqual(outcome.failures.count, 1)
let roots = viewModel.catalog.rootChildren
XCTAssertEqual(roots.count, 2)
guard case .server(let first) = viewModel.entry(for: roots[0])?.kind else {
return XCTFail("首个导入应为服务器叶子")
}
XCTAssertEqual(first.remark, "香港 01")
let secret = try credentials.secret(for: first.passwordRef)
XCTAssertEqual(secret, "password123")
// 两个身份均为全新 UUID 形态(不按内容去重)。
XCTAssertNotEqual(roots[0], roots[1])
}
func testImportWithPluginStoresProgramAndOptionsRef() async throws {
let uri =
"ss://YWVzLTI1Ni1nY206cGFzc3dvcmQxMjM@203.0.113.7:8388"
+ "/?plugin=v2ray-plugin%3Bmode%3Dwebsocket%3Bhost%3Dexample.com"
_ = try await viewModel.addServers(fromURIs: uri, into: nil)
guard
case .server(let fields) = viewModel.entry(for: viewModel.catalog.rootChildren[0])?
.kind
else { return XCTFail("应为服务器叶子") }
XCTAssertEqual(fields.pluginProgram, "v2ray-plugin")
let optionsRef = try XCTUnwrap(fields.pluginOptionsRef)
XCTAssertEqual(try credentials.secret(for: optionsRef), "mode=websocket;host=example.com")
}
func testImportIntoSelectedManualGroup() async throws {
let groupID = try await viewModel.addGroup(named: "手动组", into: nil)
let target = try XCTUnwrap(viewModel.importTargetParent(for: groupID))
XCTAssertEqual(target, groupID)
_ = try await viewModel.addServers(
fromURIs: "ss://YWVzLTI1Ni1nY206cGFzc3dvcmQxMjM@203.0.113.7:8388", into: target)
XCTAssertEqual(try viewModel.catalog.children(of: groupID).count, 1)
// 选中服务器时落到其手动父组;无选中落到根。
let serverID = try XCTUnwrap(try viewModel.catalog.children(of: groupID).first)
XCTAssertEqual(viewModel.importTargetParent(for: serverID), groupID)
XCTAssertNil(viewModel.importTargetParent(for: nil))
}
func testImportTargetSkipsSubscriptionSubtree() async throws {
try makeSubscriptionCatalog()
let fixture = try CatalogFixtures.makeSubscriptionFixture()
XCTAssertEqual(viewModel.importTargetParent(for: fixture.groupID), nil)
XCTAssertEqual(viewModel.importTargetParent(for: fixture.serverIDs[0]), nil)
}
// MARK: - 表单编辑与凭据生命周期
func testUpdateServerPersistsFieldsAndPassword() async throws {
_ = try await viewModel.addServers(
fromURIs: "ss://YWVzLTI1Ni1nY206cGFzc3dvcmQxMjM@203.0.113.7:8388", into: nil)
let id = try XCTUnwrap(viewModel.catalog.rootChildren.first)
let oldRef = try XCTUnwrap(serverFields(of: id)?.passwordRef)
try await viewModel.updateServer(
id, address: "198.51.100.9", port: 9999, encryptionMethod: "chacha20-ietf-poly1305",
password: "新密码", remark: "改过的", plugin: .none, pluginOptions: nil)
let fields = try XCTUnwrap(serverFields(of: id))
XCTAssertEqual(fields.address, "198.51.100.9")
XCTAssertEqual(fields.port, 9999)
XCTAssertEqual(fields.remark, "改过的")
XCTAssertEqual(fields.passwordRef, oldRef, "同一引用始终对应最新秘密")
XCTAssertEqual(try credentials.secret(for: oldRef), "新密码")
let commitCount = await commitCounter.count
XCTAssertEqual(commitCount, 2, "导入 + 更新各一次提交")
}
func testUpdateServerRejectsInvalidAddressAndPort() async throws {
_ = try await viewModel.addServers(
fromURIs: "ss://YWVzLTI1Ni1nY206cGFzc3dvcmQxMjM@203.0.113.7:8388", into: nil)
let id = try XCTUnwrap(viewModel.catalog.rootChildren.first)
await expectThrowsAsync(
{
try await viewModel.updateServer(
id, address: " ", port: 8388, encryptionMethod: "aes-256-gcm", password: "p",
remark: "", plugin: .none, pluginOptions: nil)
},
onThrow: { error in
XCTAssertEqual(error as? ServerFormError, .invalidAddress)
})
await expectThrowsAsync(
{
try await viewModel.updateServer(
id, address: "203.0.113.7", port: 0, encryptionMethod: "aes-256-gcm", password: "p",
remark: "", plugin: .none, pluginOptions: nil)
},
onThrow: { error in
XCTAssertEqual(error as? ServerFormError, .invalidPort)
})
}
func testRemoveServerCleansCredentialsAndClearsSelection() async throws {
_ = try await viewModel.addServers(
fromURIs: "ss://YWVzLTI1Ni1nY206cGFzc3dvcmQxMjM@203.0.113.7:8388"
+ "/?plugin=v2ray-plugin%3Bmode%3Dwebsocket", into: nil)
let id = try XCTUnwrap(viewModel.catalog.rootChildren.first)
let refs = serverFields(of: id).map { ($0.passwordRef, $0.pluginOptionsRef) }
let (passwordRef, optionsRef) = try XCTUnwrap(refs)
viewModel.selectedNodeID = id
try await viewModel.remove(id)
XCTAssertFalse(viewModel.catalog.contains(id))
XCTAssertNil(viewModel.selectedNodeID, "删除选中节点后清除选中")
XCTAssertNil(try credentials.secret(for: passwordRef), "密码秘密已清理")
XCTAssertEqual(try credentials.secret(for: try XCTUnwrap(optionsRef)), nil, "插件参数秘密已清理")
}
func testRemoveNonEmptyGroupRemovesWholeSubtree() async throws {
let groupID = try await viewModel.addGroup(named: "组", into: nil)
_ = try await viewModel.addServers(
fromURIs: "ss://YWVzLTI1Ni1nY206cGFzc3dvcmQxMjM@203.0.113.7:8388", into: groupID)
let serverID = try XCTUnwrap(try viewModel.catalog.children(of: groupID).first)
try await viewModel.remove(groupID)
XCTAssertFalse(viewModel.catalog.contains(groupID))
XCTAssertFalse(viewModel.catalog.contains(serverID))
XCTAssertTrue(viewModel.catalog.isEmpty)
}
// MARK: - 订阅子树只读(夹具验证:结构操作被拒、启用开关可用)
func testSubscriptionStructureOperationsRejected() async throws {
try makeSubscriptionCatalog()
let fixture = try CatalogFixtures.makeSubscriptionFixture()
let subscriptionServer = fixture.serverIDs[0]
let manualGroupID = try await viewModel.addGroup(named: "手动组", into: nil)
await expectThrowsAsync { try await viewModel.move(subscriptionServer, to: manualGroupID) }
await expectThrowsAsync { try await viewModel.remove(subscriptionServer) }
await expectThrowsAsync { try await viewModel.renameGroup(fixture.groupID, to: "改名") }
await expectThrowsAsync {
try await viewModel.updateServer(
subscriptionServer, address: "0.0.0.0", port: 1, encryptionMethod: "x", password: "p",
remark: "", plugin: .none, pluginOptions: nil)
}
// 手动节点移进订阅子树同样被拒(跨来源)。
await expectThrowsAsync { try await viewModel.move(manualGroupID, to: fixture.groupID) }
}
func testSubscriptionEnableToggleAllowedAndPersisted() async throws {
try makeSubscriptionCatalog()
let fixture = try CatalogFixtures.makeSubscriptionFixture()
let server = fixture.serverIDs[0]
try await viewModel.setEnabled(server, false)
let entry = try XCTUnwrap(viewModel.entry(for: server))
XCTAssertFalse(entry.enabled, "启用开关是订阅节点唯一可写状态")
let commitCount = await commitCounter.count
XCTAssertEqual(commitCount, 1)
// 持久化到磁盘可读回。
let reloaded = try CatalogFileStore(fileURL: fileURL).load().catalog
XCTAssertFalse(try XCTUnwrap(reloaded.entry(for: server)).enabled)
XCTAssertTrue(try reloaded.isEffectivelyEnabled(fixture.serverIDs[1]), "兄弟节点不受影响")
}
// MARK: - 分享(与添加互逆)
func testShareSsUriRoundTripsBackThroughImport() async throws {
let source =
"ss://YWVzLTI1Ni1nY206cGFzc3dvcmQxMjM@203.0.113.7:8388"
+ "/?plugin=v2ray-plugin%3Bmode%3Dwebsocket%3Bhost%3Dexample.com#分享节点"
_ = try await viewModel.addServers(fromURIs: source, into: nil)
let id = try XCTUnwrap(viewModel.catalog.rootChildren.first)
let shared = try viewModel.ssUri(for: id)
let decoded = try SsUri.decode(shared)
XCTAssertEqual(decoded.method, "aes-256-gcm")
XCTAssertEqual(decoded.password, "password123")
XCTAssertEqual(decoded.host, "203.0.113.7")
XCTAssertEqual(decoded.port, 8388)
XCTAssertEqual(decoded.pluginProgram, "v2ray-plugin")
XCTAssertEqual(decoded.pluginOptions, "mode=websocket;host=example.com")
XCTAssertEqual(decoded.remark, "分享节点")
}
func testShareFailsWhenCredentialMissing() async throws {
var catalog = ConfigurationCatalog()
var fields = CatalogFixtures.serverFields(remark: "无凭据")
fields.passwordRef = CredentialReference.fresh()
try catalog.addServer(fields)
try CatalogFileStore(fileURL: fileURL).save(CatalogDocument(catalog: catalog))
viewModel = makeViewModel()
let id = try XCTUnwrap(viewModel.catalog.rootChildren.first)
await expectThrowsAsync { try viewModel.ssUri(for: id) }
}
// MARK: - 持久化
func testChangesPersistAcrossViewModelInstances() async throws {
let groupID = try await viewModel.addGroup(named: "持久组", into: nil)
let reloaded = makeViewModel()
XCTAssertTrue(reloaded.catalog.contains(groupID))
XCTAssertEqual(reloaded.displayName(for: groupID), "持久组")
}
}
/// postCommit 触发计数。
actor CommitCounter {
private(set) var count = 0
func increment() { count += 1 }
}
/// `XCTAssertThrowsError` 的 async 版本(表达式在 await 之后才能检查)。
func expectThrowsAsync(
_ expression: () async throws -> Void,
onThrow errorHandler: (Error) -> Void = { _ in },
file: StaticString = #filePath,
line: UInt = #line
) async {
do {
_ = try await expression()
XCTFail("预期抛错,但成功返回", file: file, line: line)
} catch {
errorHandler(error)
}
}