mirror of
https://github.com/shadowsocks/ShadowsocksX-NG.git
synced 2026-11-22 13:34:00 +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。
171 lines
7.2 KiB
Swift
171 lines
7.2 KiB
Swift
import Foundation
|
||
import XCTest
|
||
|
||
@testable import ShadowsocksX_NG2
|
||
|
||
/// 自定义规则合并进 ACL(issue #66 AC3):两种规则子模式按各自内置来源与
|
||
/// 自定义规则合并;全局和直连模式不加载自定义规则。
|
||
final class CustomRuleMergeTests: XCTestCase {
|
||
|
||
private func custom(_ action: RuleAction, _ match: RuleMatch) -> CustomRule {
|
||
CustomRule(action: action, match: match)
|
||
}
|
||
|
||
func testACLIdentityDoesNotDependOnRuleOrderOrDuplicates() {
|
||
let first = ProxyRule(action: .direct, match: .domainSuffix("z.example"))
|
||
let equivalent = ProxyRule(
|
||
action: .direct, match: .domainSuffix("z.example"))
|
||
let second = ProxyRule(action: .proxy, match: .domainExact("a.example"))
|
||
let url = URL(fileURLWithPath: "/tmp/rules-order.acl")
|
||
for action in RuleDefaultAction.allCases {
|
||
let expected = ProxyACLDocument.rule(at: url, defaultAction: action, rules: [first, second])
|
||
let reordered = ProxyACLDocument.rule(
|
||
at: url, defaultAction: action, rules: [second, equivalent, first])
|
||
XCTAssertEqual(expected.content, reordered.content)
|
||
XCTAssertEqual(expected.sha256, reordered.sha256)
|
||
}
|
||
}
|
||
|
||
/// 「未匹配时代理」:中国直连候选 + 自定义直连进 bypass_list;自定义代理
|
||
/// 不写 proxy_list(默认已代理)。
|
||
func testProxyWhenUnmatchedMergesChinaDirectAndCustomDirect() throws {
|
||
let builtIn = [
|
||
ProxyRule(
|
||
action: .direct, match: try RuleMatch(nationalDomainSuffix: "cn")),
|
||
ProxyRule(
|
||
action: .direct, match: try RuleMatch(ipv4CIDR: "203.0.113.0/24")),
|
||
]
|
||
let customRules = [
|
||
custom(.direct, try RuleMatch(domainSuffix: "internal.example")),
|
||
custom(.proxy, try RuleMatch(domainSuffix: "always-proxy.example")),
|
||
]
|
||
|
||
let result = CustomRuleValidator.validate(
|
||
custom: customRules, builtIn: builtIn, defaultAction: .proxyWhenUnmatched)
|
||
let merged = builtIn + result.accepted
|
||
|
||
XCTAssertTrue(result.rejected.isEmpty)
|
||
XCTAssertEqual(merged.count, 4)
|
||
let acl = ProxyACLDocument.rule(
|
||
at: URL(fileURLWithPath: "/tmp/ssxng-test/sslocal-active.acl"),
|
||
defaultAction: .proxyWhenUnmatched,
|
||
rules: merged)
|
||
XCTAssertTrue(acl.content.contains("||cn\n"))
|
||
XCTAssertTrue(acl.content.contains("203.0.113.0/24\n"))
|
||
XCTAssertTrue(acl.content.contains("||internal.example\n"))
|
||
XCTAssertFalse(
|
||
acl.content.contains("||always-proxy.example\n"),
|
||
"未匹配时代理骨架不写 proxy_list;代理动作默认已覆盖")
|
||
XCTAssertTrue(acl.content.hasPrefix("[proxy_all]"))
|
||
}
|
||
|
||
/// 「未匹配时直连」:GFWList 代理候选 + 自定义代理进 proxy_list;自定义
|
||
/// 未遮蔽直连进 bypass_list。
|
||
func testDirectWhenUnmatchedMergesGFWListAndCustomRules() throws {
|
||
let builtIn = [
|
||
ProxyRule(
|
||
action: .proxy, match: try RuleMatch(domainSuffix: "blocked.example"))
|
||
]
|
||
let customRules = [
|
||
custom(.proxy, try RuleMatch(domainSuffix: "also-blocked.example")),
|
||
custom(.direct, try RuleMatch(domainSuffix: "unshadowed.example")),
|
||
]
|
||
|
||
let result = CustomRuleValidator.validate(
|
||
custom: customRules, builtIn: builtIn, defaultAction: .directWhenUnmatched)
|
||
let merged = builtIn + result.accepted
|
||
|
||
XCTAssertTrue(result.rejected.isEmpty)
|
||
let acl = ProxyACLDocument.rule(
|
||
at: URL(fileURLWithPath: "/tmp/ssxng-test/sslocal-active.acl"),
|
||
defaultAction: .directWhenUnmatched,
|
||
rules: merged)
|
||
XCTAssertTrue(acl.content.contains("[proxy_list]\n"))
|
||
XCTAssertTrue(acl.content.contains("||blocked.example\n"))
|
||
XCTAssertTrue(acl.content.contains("||also-blocked.example\n"))
|
||
XCTAssertTrue(acl.content.contains("||unshadowed.example\n"))
|
||
XCTAssertTrue(acl.content.hasPrefix("[bypass_all]"))
|
||
}
|
||
|
||
/// 被遮蔽条目保留;ACL 优先级决定其实际作用。
|
||
func testShadowedCustomDirectIsRetainedAndExplained() throws {
|
||
let builtIn = [
|
||
ProxyRule(
|
||
action: .proxy, match: try RuleMatch(domainSuffix: "blocked.example"))
|
||
]
|
||
let customRules = [
|
||
custom(.direct, try RuleMatch(domainExact: "sub.blocked.example"))
|
||
]
|
||
|
||
let result = CustomRuleValidator.validate(
|
||
custom: customRules, builtIn: builtIn, defaultAction: .directWhenUnmatched)
|
||
let merged = builtIn + result.accepted
|
||
|
||
XCTAssertTrue(result.rejected.isEmpty)
|
||
XCTAssertEqual(result.relationships.first?.extent, .full)
|
||
let acl = ProxyACLDocument.rule(
|
||
at: URL(fileURLWithPath: "/tmp/ssxng-test/sslocal-active.acl"),
|
||
defaultAction: .directWhenUnmatched,
|
||
rules: merged)
|
||
XCTAssertTrue(acl.content.contains("sub.blocked.example"), "保留可表达意图,路由由 sslocal 优先级决定")
|
||
}
|
||
|
||
/// 单模式遮蔽:在「未匹配时代理」下有效(不被遮蔽),在「未匹配时直连」下
|
||
/// 被 GFWList 代理遮蔽并返回原因。保存允许(另一模式可生效),编译按当前
|
||
/// 模式解释。
|
||
func testOneModeShadowedRuleIsValidInTheOtherMode() throws {
|
||
let gfwBuiltIn = [
|
||
ProxyRule(
|
||
action: .proxy, match: try RuleMatch(domainSuffix: "blocked.example"))
|
||
]
|
||
let chinaBuiltIn = [
|
||
ProxyRule(
|
||
action: .direct, match: try RuleMatch(nationalDomainSuffix: "cn"))
|
||
]
|
||
let customRules = [
|
||
custom(.direct, try RuleMatch(domainExact: "sub.blocked.example"))
|
||
]
|
||
|
||
let proxyDefault = CustomRuleValidator.validate(
|
||
custom: customRules, builtIn: chinaBuiltIn, defaultAction: .proxyWhenUnmatched)
|
||
XCTAssertTrue(
|
||
proxyDefault.rejected.isEmpty,
|
||
"未匹配时代理骨架无域名代理表,自定义直连不被遮蔽")
|
||
|
||
let directDefault = CustomRuleValidator.validate(
|
||
custom: customRules, builtIn: gfwBuiltIn, defaultAction: .directWhenUnmatched)
|
||
XCTAssertTrue(directDefault.rejected.isEmpty)
|
||
XCTAssertEqual(directDefault.relationships.first?.kind, .shadowing)
|
||
XCTAssertEqual(directDefault.accepted.count, 1)
|
||
}
|
||
|
||
/// 全局模式 ACL 不加载自定义规则(issue #66 AC3)。
|
||
func testGlobalACLDoesNotLoadCustomRules() throws {
|
||
let customRules = [
|
||
custom(.direct, try RuleMatch(domainSuffix: "internal.example")),
|
||
custom(.proxy, try RuleMatch(ipv4CIDR: "203.0.113.0/24")),
|
||
]
|
||
// 全局模式的 runtimeDocument 路径不加载自定义规则集合;此处
|
||
// 验证全局 ACL 文档本身不含自定义痕迹。
|
||
let acl = ProxyACLDocument.global(
|
||
at: URL(fileURLWithPath: "/tmp/ssxng-test/sslocal-active.acl"))
|
||
XCTAssertFalse(acl.content.contains("internal.example"))
|
||
XCTAssertFalse(acl.content.contains("203.0.113.0/24"))
|
||
XCTAssertEqual(
|
||
Array(acl.content.split(separator: "\n").map(String.init).dropFirst(2)),
|
||
FixedLocalProxyRanges.aclBypassRules)
|
||
// 自定义规则集合本身不参与全局编译(调用方不传入)。
|
||
XCTAssertTrue(customRules.allSatisfy { $0.source.kind == .custom })
|
||
}
|
||
|
||
/// 直连模式 ACL 不加载自定义规则。
|
||
func testDirectACLDoesNotLoadCustomRules() {
|
||
let acl = ProxyACLDocument.direct(
|
||
at: URL(fileURLWithPath: "/tmp/ssxng-test/sslocal-active.acl"))
|
||
XCTAssertFalse(acl.content.contains("[proxy_list]"))
|
||
XCTAssertEqual(
|
||
Array(acl.content.split(separator: "\n").map(String.init).dropFirst(2)),
|
||
FixedLocalProxyRanges.aclBypassRules)
|
||
}
|
||
}
|