using System.ComponentModel;
using XNet;
namespace XCoder.Tests;
/// <summary>API 发现目标地址解析器</summary>
public class ApiTargetParserTests
{
[Fact]
[DisplayName("留空表示不指定目标地址")]
public void Parse_Empty()
{
Assert.Empty(ApiTargetParser.Parse(null));
Assert.Empty(ApiTargetParser.Parse(""));
Assert.Empty(ApiTargetParser.Parse(" "));
}
[Fact]
[DisplayName("支持单个 IP、CIDR 网段与 IP 范围")]
public void Parse_Cases()
{
var single = ApiTargetParser.Parse("192.168.1.5");
Assert.Equal("192.168.1.5", Assert.Single(single).ToString());
// /30 去掉网络地址与广播地址后剩两个可用地址
var cidr = ApiTargetParser.Parse("192.168.1.0/30").Select(e => e.ToString()).ToArray();
Assert.Equal(["192.168.1.1", "192.168.1.2"], cidr);
// 带主机位的网段按掩码对齐,10.0.0.12/24 等价于 10.0.0.0/24
var hostBits = ApiTargetParser.Parse("10.0.0.12/24");
Assert.Equal(254, hostBits.Count);
Assert.Equal("10.0.0.1", hostBits[0].ToString());
Assert.Equal("10.0.0.254", hostBits[^1].ToString());
// /30 同理,192.168.1.5 落在 192.168.1.4/30 内
Assert.Equal(["192.168.1.5", "192.168.1.6"], ApiTargetParser.Parse("192.168.1.5/30").Select(e => e.ToString()).ToArray());
// /32 就是一个地址
Assert.Equal("10.0.0.7", Assert.Single(ApiTargetParser.Parse("10.0.0.7/32")).ToString());
var range = ApiTargetParser.Parse("10.0.0.1-10.0.0.3").Select(e => e.ToString()).ToArray();
Assert.Equal(["10.0.0.1", "10.0.0.2", "10.0.0.3"], range);
}
[Fact]
[DisplayName("多项输入去重且保持顺序")]
public void Parse_Distinct()
{
var list = ApiTargetParser.Parse("192.168.1.1, 192.168.1.1;192.168.1.2").Select(e => e.ToString()).ToArray();
Assert.Equal(["192.168.1.1", "192.168.1.2"], list);
}
[Fact]
[DisplayName("非法输入给出明确异常")]
public void Parse_Invalid()
{
Assert.Throws<ArgumentException>(() => ApiTargetParser.Parse("abc"));
Assert.Throws<ArgumentException>(() => ApiTargetParser.Parse("::1"));
Assert.Throws<ArgumentException>(() => ApiTargetParser.Parse("10.0.0.1-10.0.0.0"));
Assert.Throws<ArgumentException>(() => ApiTargetParser.Parse("10.0.0.0/8"));
Assert.Throws<ArgumentException>(() => ApiTargetParser.Parse("192.168.1.0/24/1"));
}
[Fact]
[DisplayName("目标数量不超过上限")]
public void Parse_MaxTargets()
{
// /22 有 1022 个可用地址,未超上限
Assert.Equal(1022, ApiTargetParser.Parse("10.0.0.0/22").Count);
// /21 有 2046 个可用地址,超上限
Assert.Throws<ArgumentException>(() => ApiTargetParser.Parse("10.0.0.0/21"));
}
}
|