Useful AutoFixture Customizations
Get Started
$ dotnet add package AutoFixture.Community.CustomizationsReadme
AutoFixture Community Customizations
IgnoreAutoFixture Attribute
The IgnoreAutoFixture attribute can be added to properties in a model to instruct AutoFixture to ignore/omit the property during building, unless explicitly instructed to be created.
This is especially useful for standing up models used by Entity Framework. Most of these models utilize circular dependencies, which would cause an exception to be raised by AutoFixture normally.
An example of this can be found below:
public class TestModel
{
public InnerModel? IncludedModel { get; set; } // Will be instantiated by AutoFixture
[IgnoreAutoFixture]
public InnerModel? OmittedModel { get; set; } // Will be omitted by AutoFixture
[IgnoreAutoFixture]
public InnerModel? ExplicitlyIncludedModel { get; set; } // Will also be omitted by AutoFixture, but will be explicitly included (see below)
}
public class Tests
{
[Test]
public void AutoFixtureTests()
{
var fixture = new Fixture();
fixture.AddIgnorePropertiesCustomization();
var model = fixture.Build<TestModel>()
.With(x => x.ExplicitlyIncludedModel, new InnerModel()) // Tells AutoFixture to set this property, instead of ignoring it.
.Create();
Assert.That(model.IncludedModel, Is.Not.Null);
Assert.That(model.OmittedModel, Is.Null);
Assert.That(model.ExplicitlyIncludedModel, Is.Not.Null);
}
}
DateOnly/TimeOnly Customization
AutoFixture customizations are provided to handle DateOnly and TimeOnly properties. By default, AutoFixture doesn't handle these types and will throw exceptions.
An example of this can be found below: