SwissWebApplicationFactory 0.1.0

SwissWebApplicationFactory is a library that extends the capabilities of WebApplicationFactory.

📥 Installation

You can install SwissWebApplicationFactory via NuGet:

Install-Package SwissWebApplicationFactory

Or through the .NET Core command-line interface:

dotnet add package SwissWebApplicationFactory

🔧 Possibilities

Mock

SwissWebApplicationFactory provides the functionality to replace services using mock objects as follows:

private readonly IDateTimeProvider DateTimeProviderMock;
private readonly AbstractExternalService AbstractServiceMock;

SwissWebApplicationFactory.MockServices(GetMocks());

public IEnumerable<object> GetMocks()
{
    yield return DateTimeProviderMock;
    yield return AbstractServiceMock;
}

Removing services

Specify in the appsettings.json file which services we want to exclude during testing:

{
  "RemoveServicesOption": {
    "Pairs": {
      "ITracer": "First",
      "ILogger": "All",
    }
  }
}

SwissWebApplicationFactory.RemoveServicesByOption()

or through an attribute if there is access to the class or interface:

[Remove(RemoveOrder.First)]
public class Tracer : ITracer

[Remove(RemoveOrder.All)]
public class Logger : ILogger

SwissWebApplicationFactory.RemoveServicesByAttribute();

Database

To replace an existing database, you can use the following method:

private readonly SqliteConnection memorySqliteConnection;

SwissWebApplicationFactory.AddDbContext<TestableDbContext, Program>(builder => builder.UseSqlite(memorySqliteConnection));

Or

private readonly SqliteConnection memorySqliteConnection;

SwissWebApplicationFactory.AddDbContextPool<TestableDbContext, Program>(builder => builder.UseSqlite(memorySqliteConnection));

Entities can be added in the following way:

await SwissWebApplicationFactory.AddEntitiesAsync<TestableDbContext, Program, Item>(items);

Or

await SwissWebApplicationFactory.ManipulateDbContextAsync<TestableDbContext, Program>(static async db =>
{
    (await db.Items.SingleAsync()).Value = expected;
});

Authentication

To replace authentication, you call the following methods:

SwissWebApplicationFactory.MockAuth().SetFakeBearerAuthenticationHeader();

If you need to configure permissions for a user:

SwissWebApplicationFactory.ClaimsConfig.Roles = new[]{ "Admin" };
SwissWebApplicationFactory.ClaimsConfig.Name = "Admin";

📝 License

The MIT License (MIT)

Made with love by Kataane 💜