Wolfgang.DbContextBuilder.Abstractions 0.8.1

DbContextBuilder

Uses the Builder pattern to create Entity Framework Core and classic Entity Framework DbContext instances using an in-memory database for testing purposes. With DbContextBuilder, you can easily set up a DbContext with predefined data, making it ideal for unit tests and integration tests without having to rely on an actual database whose data can be changed or deleted over time.

📦 Installation

DbContextBuilder ships as a family of packages — install the one that matches your EF flavor:

Random-data and shared add-on packages (install alongside your EF Core package):

# Pick whichever matches your project's EF version, plus a random-data provider
dotnet add package Wolfgang.DbContextBuilder-Core-EF8
dotnet add package Wolfgang.DbContextBuilder.AutoFixture   # or .Bogus

🎯 Supported Frameworks

Each package targets the .NET runtimes its EF version requires:

📄 License

This project is licensed under the MIT License. See the LICENSE file for details.

📚 Documentation

• GitHub Repository: https://github.com/Chris-Wolfgang/DbContextBuilder
• API Documentation: https://Chris-Wolfgang.github.io/DbContextBuilder/
• CHANGELOG: CHANGELOG.md
• Contributing Guide: CONTRIBUTING.md
• DocFX Version Picker Troubleshooting: docs/DOCFX-VERSION-PICKER.md

✨ Features

• In-memory DbContext for tests. By default, DbContextBuilder uses the EF Core InMemory provider. Pass your own DbContextOptionsBuilder to switch to SQLite in-memory or any other provider.

• Seed with your own data using .SeedWith<T>(...) — accepts an IEnumerable<T> or a params T[].

• Seed with random data using .SeedWithRandom<T>(count) to simulate real-world databases where additional rows beyond your test fixtures exist. Choose a random-data provider — .UseAutoFixture() (the Wolfgang.DbContextBuilder.AutoFixture package) or .UseBogus() (Wolfgang.DbContextBuilder.Bogus) — or plug in your own ICreateRandomEntities via .UseCustomRandomEntityCreator(...).

• Composable. Chain SeedWith, SeedWithRandom, and provider options in any order, then call .BuildAsync() to materialize the DbContext.

🚀 Usage

// Create a DbContext with seeded random data and your test data
var context = await new DbContextBuilder<YourDbContext>()
    // Pick a random-data provider (or .UseBogus()) so SeedWithRandom has a generator
    .UseAutoFixture()

    // Seed with 10 random entities
    .SeedWithRandom<YourEntity>(10)

    // Seed with specific data
    .SeedWith
    (
        new YourEntity
        {
            Id = 1,
            Name = "Test Entity"
        }
    )

    // Seed with 5 more random entities
    .SeedWithRandom<YourEntity>(5)

    // Build the DbContext instance
    .BuildAsync();

// Use the context in your tests
var sut = new YourService(context);

📖 API surface

The Core package exposes a small, focused surface. The full reference is on the docs site; the most-used entry points are: