GenFu项目技术文档

1. 安装指南

GenFu 是一个可以帮助生成真实测试数据的库。您可以通过 NuGet 包管理器轻松地将 GenFu 添加到您的项目中：

install-package GenFu 

确保您的项目环境支持 AspNetCore50 或更高版本，因为 GenFu 在这些环境中运行。

2. 项目的使用说明

GenFu 提供了静态方法，可以用来创建新的对象实例，并用看似真实的数据填充对象的属性，这对于测试或原型设计非常有用。

例如，假设您有一个 Person 类：

class Person
{
    public string FirstName { get; set; }
    public string LastName { get; set; }
    public string Title { get; set; }
    public int Age { get; set; }
    public int NumberOfKids { get; set; }
    private string _middleName;
    public void SetMiddleName(string name){ _middleName = name; }
}

要创建一个填充了数据的 Person 实例，您可以使用：

var person = A.New<Person>();

如果您需要一个 Person 对象列表，可以使用：

var people = A.ListOf<Person>();

默认情况下，这将生成一个包含 25 个 Person 对象的列表。

如果您需要自定义某些属性的填充范围，比如年龄：

GenFu.Configure<Person>()
    .Fill(p => p.Age)
    .WithinRange(19, 25);
var people = A.ListOf<Person>();

3. 项目API使用文档

GenFu 提供了多种配置选项来控制属性填充。

• Fill<TProperty>: 用于指定如何填充特定属性。
• WithinRange(int min, int max): 用于设置整数值的填充范围。
• MethodFill<TProperty>: 用于填充具有一个参数的设置方法。

例如，如果您想为 BlogPost 类的 Title 属性指定一个固定的值：

var blogTitle = "GenFu";
GenFu.Configure<BlogPost>()
    .Fill(b => b.Title, () => blogTitle);
var post = A.New<BlogPost>();

如果您想使用自定义的方法填充器：

GenFu.Configure<Person>()
    .MethodFill<string>(x => x.SetMiddleName(null));
var post = A.New<Person>();

请注意，GenFu 不会自动填充它找到的任何方法。您需要明确指定您希望填充的每个方法。

4. 项目安装方式

如前所述，您可以通过 NuGet 包管理器安装 GenFu。在您的项目目录中打开命令提示符或终端，然后执行以下命令：

install-package GenFu 

这将在您的项目中添加 GenFu 及其依赖项。随后您可以按照示例使用 GenFu 生成测试数据。