Files
ShadowsocksX-NG/ShadowsocksX-NG2/Tests/ProxyControl/ProxyPortSemanticsTests.swift
T
Qiu Yuzhou 20a62117f2 refactor(tests): 按功能领域重组 Tests/ 目录
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。
2026-10-05 20:37:35 +08:00

205 lines
7.3 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 Darwin
import XCTest
@testable import ShadowsocksX_NG2
/// 端口语义(spec #21 D8,issue #30)主缝测试:出厂默认、占用校验、建议端口
/// 算法与点名错误。bind 探测覆盖真实回环 socket;lsof 输出解析为纯函数夹具。
final class ProxyPortSemanticsTests: XCTestCase {
// MARK: 出厂默认(与 Legacy 隔离,任何路径不静默改端口)
func testFactoryDefaultsAvoidLegacyPortsAndValidateClean() {
let settings = SslocalListenSettings()
XCTAssertEqual(settings.socksPort, 11086)
XCTAssertEqual(settings.httpPort, 11087)
XCTAssertTrue(settings.portValidationErrors().isEmpty)
}
// MARK: 配置校验与点名错误
func testOutOfRangePortsAreRejectedNamingEndpointAndPort() {
var settings = SslocalListenSettings()
settings.socksPort = 0
settings.httpPort = 65536
XCTAssertEqual(
settings.portValidationErrors(),
[
.portOutOfRange(endpoint: .socks, port: 0),
.portOutOfRange(endpoint: .http, port: 65536),
])
}
func testDuplicateConfiguredPortsAreRejectedNamingBothEndpoints() {
let settings = SslocalListenSettings(
socksPort: 1086,
httpPort: 1086)
XCTAssertEqual(
settings.portValidationErrors(),
[.duplicatePort(endpoint: .socks, otherEndpoint: .http, port: 1086)],
"两个端点的配置值都必须互异")
}
func testPresentationNamesEndpointAndPort() {
XCTAssertEqual(
AppPresentation.message(
for: PortSettingError.portOutOfRange(endpoint: .http, port: 70000)),
"HTTP 端口 70000 无效,必须是 1000–65535 之间的整数")
XCTAssertEqual(
AppPresentation.message(
for: PortSettingError.duplicatePort(
endpoint: .socks, otherEndpoint: .http, port: 1086)),
"SOCKS5 端口与 HTTP 端口冲突(都是 1086),请为每个端点配置不同的端口")
}
// MARK: 建议端口算法(D8:32768–65535 高位段,空闲且与另两端点配置值互异)
func testSuggestionScansHighRangeAscendingSkippingExcludedAndOccupied() {
var probed: [Int] = []
let suggested = PortSuggestion.firstFree(
excluding: [32768],
isFree: { port in
probed.append(port)
return port != 32769
})
XCTAssertEqual(suggested, 32770)
XCTAssertEqual(probed, [32769, 32770], "被排除的 32768 不探测;占用端口跳过")
}
func testSuggestionReturnsNilWhenWholeRangeExhausted() {
XCTAssertNil(PortSuggestion.firstFree(excluding: [], isFree: { _ in false }))
}
func testSuggestedPortForEndpointExcludesOtherConfiguredValues() {
let settings = SslocalListenSettings(
socksPort: 40000, httpPort: 40001)
var probed: [Int] = []
let suggested = settings.suggestedPort(for: .http) { port in
probed.append(port)
return port == 40002
}
XCTAssertEqual(suggested, 40002)
XCTAssertFalse(probed.contains(40000), "另个端点的配置值无论启用与否都排除")
}
// MARK: 占用探测(设置区即时校验的 I/O 缝;激活仍以 runtime 实际绑定的
// 健康门禁为准,本探测只是编辑期尽力而为的提示)
func testBindProbeReportsOccupiedThenFreeOnRealLoopbackSocket() throws {
let held = try ListenerFixture()
let port = held.port
let probe = SystemPortOccupancyProbe()
guard case .occupied = probe.occupancy(port: port, listenerMode: .localhost) else {
return XCTFail("已被本测试进程监听的端口必须判为占用")
}
held.close()
guard case .free = probe.occupancy(port: port, listenerMode: .localhost) else {
return XCTFail("关闭监听后同一端口必须判为空闲")
}
}
func testBindProbeReportsUnknownForUnresolvableAddress() {
let outcome = SystemPortOccupancyProbe().occupancy(port: 1086, bindAddress: "not-an-ip")
guard case .unknown = outcome else {
return XCTFail("地址不可解析时不得冒充空闲或占用,实际 \(outcome)")
}
}
func testIPv6OnlyBindCanShareAnIPv4PortWhileDualStackCannot() throws {
let held = try ListenerFixture(listenerMode: .allIPv4Interfaces)
defer { held.close() }
let probe = SystemPortOccupancyProbe()
guard case .free = probe.occupancy(port: held.port, listenerMode: .allIPv6Interfaces) else {
return XCTFail("IPv6-only 探测不应与 IPv4 通配监听冲突")
}
guard
case .occupied = probe.occupancy(
port: held.port, listenerMode: .allIPv4AndIPv6Interfaces)
else {
return XCTFail("双栈探测必须覆盖 IPv4,因而与 IPv4 通配监听冲突")
}
}
func testOccupierNameParsedFromLsofOutputFixture() {
let output = """
COMMAND PID USER FD TYPE DEVICE SIZE/OFF NODE NAME
sslocal 12345 qiu 7u IPv4 0xabcd 0t0 TCP 127.0.0.1:1086 (LISTEN)
TestApp 12346 qiu 8u IPv4 0xabce 0t0 TCP 127.0.0.1:1086 (LISTEN)
"""
XCTAssertEqual(SystemPortOccupancyProbe.occupierProcessName(fromLsofOutput: output), "sslocal")
XCTAssertEqual(
SystemPortOccupancyProbe.occupierProcessIDs(fromLsofOutput: output), [12345, 12346])
XCTAssertEqual(
SystemPortOccupancyProbe.lsofArguments(port: 1086, addressFamily: .ipv4),
["-nP", "-i4TCP:1086", "-sTCP:LISTEN"])
XCTAssertEqual(
SystemPortOccupancyProbe.lsofArguments(port: 1086, addressFamily: .ipv6),
["-nP", "-i6TCP:1086", "-sTCP:LISTEN"])
XCTAssertNil(SystemPortOccupancyProbe.occupierProcessName(fromLsofOutput: " \n"))
XCTAssertNil(
SystemPortOccupancyProbe.occupierProcessName(fromLsofOutput: "COMMAND PID USER FD"),
"只有表头(无占用进程)时解析为 nil")
}
}
/// 测试专用回环监听器:占用一个内核分配端口,供占用探测断言真实占用。
private final class ListenerFixture {
let descriptor: Int32
let port: Int
init(listenerMode: ListenerMode = .localhost) throws {
let listenerFD = socket(AF_INET, SOCK_STREAM, 0)
guard listenerFD >= 0 else { throw POSIXError(.ENOTSOCK) }
var address = sockaddr_in()
address.sin_len = UInt8(MemoryLayout<sockaddr_in>.size)
address.sin_family = sa_family_t(AF_INET)
address.sin_port = 0
guard inet_pton(AF_INET, listenerMode.bindAddress, &address.sin_addr) == 1 else {
Darwin.close(listenerFD)
throw POSIXError(.EADDRNOTAVAIL)
}
let bindResult = withUnsafePointer(to: &address) { pointer in
pointer.withMemoryRebound(to: sockaddr.self, capacity: 1) {
bind(listenerFD, $0, socklen_t(MemoryLayout<sockaddr_in>.size))
}
}
guard bindResult == 0 else {
let error = errno
Darwin.close(listenerFD)
throw POSIXError(POSIXErrorCode(rawValue: error)!)
}
guard listen(listenerFD, 1) == 0 else {
let error = errno
Darwin.close(listenerFD)
throw POSIXError(POSIXErrorCode(rawValue: error)!)
}
var bound = sockaddr_in()
var length = socklen_t(MemoryLayout<sockaddr_in>.size)
let nameResult = withUnsafeMutablePointer(to: &bound) { pointer in
pointer.withMemoryRebound(to: sockaddr.self, capacity: 1) {
getsockname(listenerFD, $0, &length)
}
}
guard nameResult == 0 else {
let error = errno
Darwin.close(listenerFD)
throw POSIXError(POSIXErrorCode(rawValue: error)!)
}
descriptor = listenerFD
port = Int(CFSwapInt16BigToHost(bound.sin_port))
}
func close() {
Darwin.close(descriptor)
}
}