Soenneker.Utils.AutoBogus 2.1.124

Soenneker.Utils.AutoBogus

The .NET Autogenerator

This project is an automatic creator and populator for the fake data generator Bogus. It's a replacement for the abandoned AutoBogus library.

The goals are to be fast, and support the latest types in .NET. It uses the fastest .NET Reflection cache: soenneker.reflection.cache

.NET 6+ is supported.

Installation

dotnet add package Soenneker.Utils.AutoBogus

Usage

• Create an AutoFaker instance:

var optionalConfig = new AutoFakerConfig();
var autoFaker = new AutoFaker(optionalConfig);

• Call Generate<>() on any type you want:

var randomWord = autoFaker.Generate<string>();
var dictionary = autoFaker.Generate<Dictionary<int, string>>();
var order = autoFaker.Generate<Order>();

• It's also possible to generate types via an argument:

var randomWord = autoFaker.Generate(typeof(string));

• Set a faker, configuration, rules, etc:

autoFaker.Config.Faker = new Faker("de");
autoFaker.Config.RepeatCount = 3;
...

AutoFakerOverride can be used for type customization:

public class OrderOverride : AutoFakerOverride<Order>
{
    public override void Generate(AutoFakerOverrideContext context)
    {
        var target = (context.Instance as Order)!;
        target.Id = 123;
        
        // Faker is available
        target.Name = context.Faker.Random.Word();

        // AutoFaker is also available
        target.Customer = context.AutoFaker.Generate<Customer>();
     }
}

Then just add AutoFakerOverride to the AutoFaker.Config instance:

autoFaker.Config.Overrides = new List<AutoFakerGeneratorOverride>();
autoFaker.Config.Overrides.Add(new OrderOverride());

Tips

• ⚠️ Instantiating a Bogus Faker takes a substantial amount of time (almost 1ms). An instance of AutoFaker will create one Faker. Thus, it's recommended that a single instance be used if possible.
• AutoFaker.GenerateStatic<>() is available, but should be avoided (as it creates a new AutoFaker/Faker on each call).

Notes

• This is a work in progress. Contribution is welcomed.

Benchmarks

Soenneker.Utils.AutoBogus

AutoBogus

Bogus