/// <summary>
/// Registers a provider to use in PostgreSQL databases in unit tests. Use the [PostgreSqlTest]-attribute on class- or method-level to use that provider.
/// </summary>
/// <param name="configuration">The config where the provider should be registered on.</param>
/// <param name="connectionString">The connection string points to the postgres database. You don't know the name of the test DB in this context. The provider takes care of that.</param>
/// <param name="dbNamePrefix">All test databases are created with the prefix (ie. `YourProjectTest`). Use the branch name or sth. like that when running in a CI pipeline.</param>
/// <param name="templateDb">When a template is defined, the test database will initially be copied from it (ie. `YourProjectTest_Template`). When a template is set, migrations won't be executed.
/// The template is expected to be up to date. Use <see cref="PostgreSqlUtil" /> for template creation support.</param>
/// <param name="seed">The seed that should be executed when this provider is used.</param>
/// <param name="npgsqlOptions">
/// The options builder for Npgsql if the context requires one. Gets used in DbContextOptionsBuilder{TDbContext}().UseNpgsql().
/// Example: o => o.UseNodaTime().
/// Note: UseNpgSql() has already been called on this builder.</param>
/// <param name="dbContextOptions">The <see cref="DbContextOptionsBuilder{TDbContext}"/> which can be used for further configuration. Example: o => o.AddInterceptors(...).</param>
public static DatabaseFixtureConfiguration <TDbContext> UsePostgreSqlDatabase <TDbContext>(
this DatabaseFixtureConfiguration <TDbContext> configuration,
string connectionString,
string dbNamePrefix,
string?templateDb = null,
Func <TDbContext, Task>?seed = null,
Action <NpgsqlDbContextOptionsBuilder>?npgsqlOptions = null,
Action <DbContextOptionsBuilder <TDbContext> >?dbContextOptions = null)
where TDbContext : DbContext
{
configuration.RegisterProvider(typeof(PostgreSqlTestAttribute),
attr =>
{
var attribute = (PostgreSqlTestAttribute)attr;
return(new PostgreSqlDatabaseProvider <TDbContext>(connectionString, dbNamePrefix, templateDb, attribute.EnableLogging, seed, npgsqlOptions, dbContextOptions));
});
return(configuration);
}
/// <summary>
/// Registers a provider to use in memory databases in unit tests. Use the [InMemoryTest]-attribute on class- or method-level to use that provider.
/// </summary>
public static DatabaseFixtureConfiguration <TDbContext> UseInMemoryDatabase <TDbContext>(this DatabaseFixtureConfiguration <TDbContext> configuration, Func <TDbContext, Task>?seed = null)
where TDbContext : DbContext
{
configuration.RegisterProvider(typeof(InMemoryTestAttribute), _ => new InMemoryDatabaseProvider <TDbContext>(seed));
return(configuration);
}