Files
ShadowsocksX-NG/ShadowsocksX-NG2/Tests/CustomRuleStoreTests.swift
T
Qiu Yuzhou 9b32400b24 feat(proxy): add custom rule storage, validation, and ACL merge
Persist user custom rules (exact domain, domain suffix, IPv4/IPv6 CIDR)
with stable identity and source metadata. Reject rules that conflict
with the fixed local scope or are shadowed by sslocal domain-proxy /
IP-direct priority, with explainable reasons. Merge valid custom rules
into both rule sub-modes ACL; global and direct modes do not load them.
Rule content changes recompile ACL via full restart with rollback.
Diagnostics expose only count and content-version summary.
2026-09-26 20:27:56 +08:00

103 lines
3.6 KiB
Swift

import Foundation
import XCTest
@testable import ShadowsocksX_NG2
/// 自定义规则持久化(issue #66 AC1/AC5):往返、缺失文件、损坏与诊断摘要。
final class CustomRuleStoreTests: XCTestCase {
private var directory: URL!
private var store: CustomRuleStore!
override func setUpWithError() throws {
try super.setUpWithError()
directory = FileManager.default.temporaryDirectory
.appendingPathComponent("ssxng-custom-rules-\(UUID().uuidString)", isDirectory: true)
try FileManager.default.createDirectory(at: directory, withIntermediateDirectories: true)
store = CustomRuleStore(fileURL: directory.appendingPathComponent("custom-rules.json"))
}
override func tearDownWithError() throws {
try? FileManager.default.removeItem(at: directory)
try super.tearDownWithError()
}
func testMissingFileLoadsAsEmpty() throws {
XCTAssertEqual(try store.load(), [])
}
func testRoundTripPersistsActionMatchAndSourceMetadata() throws {
let match = try RuleMatch(domainSuffix: "example.com")
let rule = CustomRule(action: .direct, match: match)
try store.save([rule])
let loaded = try store.load()
XCTAssertEqual(loaded.count, 1)
XCTAssertEqual(loaded[0].id, rule.id)
XCTAssertEqual(loaded[0].action, .direct)
XCTAssertEqual(loaded[0].match, match)
XCTAssertEqual(loaded[0].source.kind, .custom)
XCTAssertFalse(loaded[0].source.label.isEmpty)
}
func testRoundTripKeepsMultipleRuleKinds() throws {
let rules = [
CustomRule(action: .proxy, match: try RuleMatch(domainExact: "a.example.com")),
CustomRule(action: .direct, match: try RuleMatch(ipv4CIDR: "203.0.113.0/24")),
CustomRule(action: .proxy, match: try RuleMatch(ipv6CIDR: "2001:db8::/32")),
]
try store.save(rules)
XCTAssertEqual(try store.load(), rules)
}
func testCorruptFileThrowsCorrupt() throws {
try Data("not-json".utf8).write(to: store.fileURL)
XCTAssertThrowsError(try store.load()) { error in
guard case .corrupt = error as? CustomRuleStoreError else {
return XCTFail("应点名 corrupt,实际 \(error)")
}
}
}
func testSchemaVersionMismatchIsRejected() throws {
let payload = """
{"schemaVersion": 99, "rules": []}
"""
try Data(payload.utf8).write(to: store.fileURL)
XCTAssertThrowsError(try store.load()) { error in
guard case .schemaVersionMismatch(let found, let expected)? = error as? CustomRuleStoreError
else {
return XCTFail("应点名 schema 版本不匹配,实际 \(error)")
}
XCTAssertEqual(found, 99)
XCTAssertEqual(expected, CustomRuleDocument.currentSchemaVersion)
}
}
func testSummaryExposesCountAndStableContentVersionWithoutRawDomains() throws {
let rules = [
CustomRule(action: .proxy, match: try RuleMatch(domainSuffix: "secret-internal.example")),
CustomRule(action: .direct, match: try RuleMatch(ipv4CIDR: "203.0.113.0/24")),
]
try store.save(rules)
let summary = try store.summary()
XCTAssertEqual(summary.count, 2)
XCTAssertEqual(summary.contentVersion.count, 12)
XCTAssertFalse(summary.contentVersion.contains("secret"))
// 重排不改内容版本。
let reordered = CustomRuleSummary.summarizing(Array(rules.reversed()))
XCTAssertEqual(reordered.contentVersion, summary.contentVersion)
// 内容变化改版本。
let changed = CustomRuleSummary.summarizing([
CustomRule(action: .proxy, match: try RuleMatch(domainSuffix: "other.example"))
])
XCTAssertNotEqual(changed.contentVersion, summary.contentVersion)
}
}