Bogus, AutoFixture, others(?): How to fill a nested model with fake data and set rules for specific properties?
Bogus has a community extension called AutoBogus written by Nick Dodd that lets you auto-generate rules for your models.
You can also override auto-generated rules that AutoBogus created with specific values for specific tests. Check out the AutoBogus readme for more info.
Also, you don't have to choose one or the other. You can use both. Bogus has a Faker
class (not Faker<T>
) that you can use without a fluent setup and without having to define a model T
. The Faker
class gives you access to all the datasets for realistic data generation. So, you can use Bogus' Faker
object in combination with AutoFixture's conventions. :)
Hope that helps!
Brian
AutoFixture enables you to establish rules for properties, either in a property-by-property basis, or by convention.
Customise a specific property
You can use Customize
to change the behaviour for a particular type, including properties:
[Fact]
public void CustomizeSpecificProperty()
{
var fixture = new Fixture();
fixture.Customize<MyClass>(c => c.With(mo => mo.Number, 42));
var actual = fixture.Create<MyClass>();
Assert.Equal(42, actual.Number);
}
This particular customization changes the rule for all MyClass.Number
properties; the value will always be exactly 42.
Customize by convention
You can also match various properties by convention, often by looking at a combination of property type and name:
[Fact]
public void CustomizeTextPropertyByConvention()
{
var fixture = new Fixture();
fixture.Customizations.Add(new TextPropertyBuilder());
var actual = fixture.Create<MyClass>();
Assert.Equal("Foo", actual.Text);
}
This option also requires that you write a custom TextPropertyBuilder
class:
public class TextPropertyBuilder : ISpecimenBuilder
{
public object Create(object request, ISpecimenContext context)
{
var pi = request as PropertyInfo;
if (pi == null || pi.Name != "Text" || pi.PropertyType != typeof(string))
return new NoSpecimen();
return "Foo";
}
}
This rule will apply to all string
properties called "Text"
, no matter on which class they're defined.
AutoFixture comes with a rich API that will enable you express many of such rules in a more succinct manner, but these are the main building blocks.
Both the above examples use this MyClass
:
public class MyClass
{
public int Number { get; set; }
public string Text { get; set; }
}