AutoFixture
是一個(gè).NET庫,旨在簡化單元測試中的數(shù)據(jù)設(shè)置過程。通過自動(dòng)生成測試數(shù)據(jù),它幫助開發(fā)者減少測試代碼的編寫量,使得單元測試更加簡潔、易讀和易維護(hù)。AutoFixture可以用于任何.NET測試框架,如xUnit、NUnit或MSTest。
默認(rèn)情況下AutoFixture生成的字段值很多時(shí)候都滿足不了測試需求,比如:
public class User
{
public int Id { get; set; }
public string Name { get; set; } = null!;
[EmailAddress]
public string? Email { get; set; }
[StringLength(512)]
public string? Address { get; set; }
public DateTime CreatedAt { get; set; } = DateTime.Now;
}
如果直接使用 Create<T>()
生成的User對(duì)象,他會(huì)默認(rèn)給你填充Id為隨機(jī)整數(shù),Name和Email為一串Guid,顯然這里的郵箱地址生成就不能滿足要求,并不是一個(gè)有效的郵箱格式
那么如何讓AutoFixture按需生成有效的測試數(shù)據(jù)呢?方法其實(shí)有好幾種:
方法1:直接定制
var fixture = new Fixture();
fixture.Customize<User>(c => c
.With(x => x.Email, "特定值")
.Without(x => x.Id));
這里,With方法用于指定屬性的具體值,而Without方法用于排除某些屬性不被自動(dòng)填充。
方法2:使用匿名函數(shù)
這在需要對(duì)生成的數(shù)據(jù)進(jìn)行更復(fù)雜的操作時(shí)非常有用。
var fixture = new Fixture();
fixture.Customize<User>(c => c.FromFactory(() => new User
{
Email = "通過工廠方法生成",
}));
方法3:實(shí)現(xiàn)ICustomization接口
對(duì)于更復(fù)雜的定制需求,可以通過實(shí)現(xiàn)ICustomization接口來創(chuàng)建一個(gè)定制化類。這種方法的好處是可以重用定制邏輯,并且使得測試代碼更加整潔。
public class MyCustomClassCustomization : ICustomization
{
public void Customize(IFixture fixture)
{
fixture.Customize<User>(c => c
.With(x => x.Email, "自定義值")
.Without(x => x.Id));
}
}
// 使用定制化
var fixture = new Fixture();
fixture.Customize(new MyCustomClassCustomization());
方法4:使用Build<T>
方法
Build<T>
方法提供了一種鏈?zhǔn)秸{(diào)用的方式來定制類型的生成規(guī)則,這在只需要對(duì)單個(gè)對(duì)象進(jìn)行簡單定制時(shí)非常方便。
var myCustomObject = fixture.Build<User>()
.With(x => x.Email, $"{Guid.NewId()}@example.com")
.Without(x => x.Id)
.Create();
最佳實(shí)踐:
這里以xunit
測試框架為例,
我們需要提前引用AutoFixture
,AutoFixture.Xunit2
庫,實(shí)現(xiàn)一個(gè)UserAutoDataAttribute
類,繼承自InlineAutoDataAttribute
重寫GetData
方法,大致代碼如下:
public class UserAutoDataAttribute : InlineAutoDataAttribute
{
public UserAutoDataAttribute(params object[] values) : base(values)
{
ArgumentNullException.ThrowIfNull(values[0]);
}
public override IEnumerable<object[]> GetData(MethodInfo testMethod)
{
var fixture = new Fixture();
//這里使用上面的4種方式的一種,亦或者根據(jù)自身情況定制!
var user = fixture.Build<User>()
//.With(x => x.Id, 0)
.Without(x => x.Id) //ID需要排除因?yàn)镋FCore需要插入時(shí)自動(dòng)生成
.With(x => x.Email, $"{Uuid7.NewUuid7()}@example.com") //郵箱地址,需要照規(guī)則生成
.Create();
yield return new object[] { Values[0], user };
}
}
下面是一個(gè)測試用例,需要填充db,和一個(gè)自動(dòng)生成的User參數(shù)
public class UnitOfWorkTests(ITestOutputHelper output)
{
[Theory]
[UserAutoData(1)]
[UserAutoData(2)]
public async Task MyUnitOfWorkTest(int db, User user)
{
var services = new ServiceCollection();
services.AddLogging();
services.AddDbContext<TestDbContext>(options =>
{
options.UseInMemoryDatabase($"test-{db}");
});
services.AddUnitOfWork<TestDbContext>();
var provider = services.BuildServiceProvider();
var uow = provider.GetRequiredService<IUnitOfWork<TestDbContext>>();
//add user
await uow.GetRepository<User>().InsertAsync(user);
await uow.SaveChangesAsync();
// select user
var user2 = await uow.GetRepository<User>().FindAsync(1);
Assert.NotNull(user2);
// delete user
uow.GetRepository<User>().Delete(1);
var row = await uow.SaveChangesAsync();
Assert.Equal(1, row);
// select user
user2 = await uow.GetRepository<User>().GetFirstOrDefaultAsync(x => x.Id == 1);
Assert.Null(user2);
}
}
如果你已經(jīng)習(xí)慣編寫單元測試,但還沒有使用AutoFixture
,那么推薦你嘗試一下,也許你也會(huì)喜歡上TA
轉(zhuǎn)自https://www.cnblogs.com/vipwan/p/18311419 作者萬雅虎
該文章在 2024/7/22 10:29:20 編輯過