PANiXiDA.DataGenerator 1.0.0

PANiXiDA.DataGenerator

PANiXiDA.DataGenerator is a library for generating realistic test and sample data based on Bogus and AutoFixture.
It can automatically populate models (including nested objects and collections), control how data is mutated, and produce consistent results using scoped deterministic seeds.

The library can be used in:

• integration tests
• load testing
• prototyping
• demos and mock environments
• any scenario requiring meaningful sample data

Installation

dotnet add package PANiXiDA.DataGenerator

Quick Start

var data = new DataFacade(locale: "en", seed: 123);

var user = data.Create<User>();   // fully generated model
var modifiedUser = data.Mutate(user);   // original object with several values changed

Features

• Automatic model population with realistic values

The generator provides meaningful data for common model fields (e.g. Emails, Names, Dates, Addresses).

• Full support for nested models and collections

List<T>, T[], Dictionary<TKey, TValue>, inner class models — are all populated recursively.

• Nullable fields are handled naturally

Nullable properties (string?, int?, DateTime?, etc.) are left null with a small probability.

• Deterministic output

Providing the same seed (optionally combined with scope) produces the same result across runs.

Supported Types and Property Rules

Strings (string)

Numbers (int, long, decimal, float, double, etc.)

Boolean (bool)

• Fields like IsActive, IsEnabled, HasAccess → mostly true
• Fields like IsDeleted, IsBlocked, IsDisabled → mostly false

Date and Time

Collections

Other types

Mutation

var mutated = data.Mutate(user, minChanges: 1, maxChanges: 3);

Mutation will:

• clone the object
• randomly change several writable properties
• preserve nullable behavior
• work recursively for nested objects

Fields excluded from mutation (never changed)

By default, the following fields are never mutated:

Id
CreatedAt
UpdatedAt
DeletedAt

Fields always mutated

The following fields are always mutated, even if no others change:

Login
Password

You can also explicitly exclude properties:

var mutated = data.Mutate(user, excludeProperties: new[] { nameof(User.Email) });

Deterministic Output and Scopes

var a = new DataFacade(seed: 42);
var b = new DataFacade(seed: 42);

a.Create<User>().Should().BeEquivalentTo(b.Create<User>()); // true

Scopes allow independent data streams:

var authData = new DataFacade(scope: "auth");
var orderData = new DataFacade(scope: "orders");

License

Apache 2.0 — free for commercial and open use.

Summary