JaCraig/TestFountain
GitHub: JaCraig/TestFountain
一个基于 .NET 的 xUnit 测试随机数据生成库，通过注解驱动的方式自动创建多样化测试输入并支持数据持久化与重放。
Stars: 1 | Forks: 0
# TestFountain
[](https://github.com/JaCraig/TestFountain/actions/workflows/dotnet-publish.yml) [](https://coveralls.io/github/JaCraig/TestFountain?branch=master)
TestFountain 是一个 C# 库，它为 [xUnit.Net](https://xunit.net/) 提供了一个特性（attribute），用于生成随机测试数据。它旨在通过自动为你的 xUnit.Net 测试创建随机输入值，简化生成多样且全面测试用例的过程。
## 功能特性
- **随机数据生成**：TestFountain 允许你轻松地为 xUnit.Net 测试生成随机测试数据。通过使用 `FountainDataAttribute`，你可以注解你的测试方法，并让它们自动接收随机化的输入参数。
- **自定义设置**：你可以使用 TestFountain 提供的各种选项，通过指定数据类型、范围、长度和其他属性来自定义生成的数据。
- **简化测试用例**：有了 TestFountain，你不再需要手动定义和管理多个测试用例。它会自动生成广泛的测试输入，让你能够专注于编写断言和验证代码的行为。
## 入门指南
### 前置条件
- .NET 8.0 或更高版本
### 安装说明
你可以通过 NuGet 包管理器安装 TestFountain，或者通过将引用添加到你的项目文件中来安装。
#### 使用 NuGet 包管理器
1. 在 Visual Studio 中打开 NuGet 包管理器控制台。
2. 执行以下命令：
Install-Package TestFountain
#### 添加引用
1. 在 Visual Studio 中右键点击你的项目。
2. 选择“管理 NuGet 程序包”。
3. 搜索“TestFountain”并点击“安装”。
### 用法
要你的 xUnit.Net 测试中使用 TestFountain，请按照以下步骤操作：
1. 使用 `RandomDataAttribute` 注解你的测试方法，并指定所需的选项：
[Theory]
[FountainData]
public void MyRandomTestMethod(int randomNumber, string randomString)
{
// Use the random values for testing
}
在这个例子中，每次运行测试时，`randomNumber` 和 `randomString` 都会被自动填充为随机值。
2. 使用可用选项自定义生成的数据。例如：
[Theory]
[FountainData(10)]
public void MyRandomTestMethod(int randomNumber)
{
// Use the random integer value between 0 and 100 for testing
}
3. 像往常一样运行你的 xUnit.Net 测试，TestFountain 将为你注解的测试方法生成随机测试数据。
标签：Mirage, .NET 8, NuGet包, pocsuite3, Quality Assurance, SOC Prime, TestFountain, xUnit, 单元测试, 开发工具, 开源库, 搜索引擎爬虫, 数据注解, 数据驱动测试, 测试数据生成, 软件测试, 随机数据