CI / Build and test (SQLite) (pull_request) Successful in 45s
CI / PostgreSQL 16 integration (pull_request) Skipped
CI / PostgreSQL 17 integration (pull_request) Skipped
CI / YAML check (pull_request) Successful in 3s
CI / Docker image (pull_request) Successful in 51s
Every later milestone stores its data through this layer, so it has to behave the same on both engines and be safe by construction: - Khaemhat.Data: explicit entity maps, typed queries over a safe expression subset, SqlFragment where every interpolated value becomes a parameter, unit of work with transactions, repositories with audit columns and optimistic concurrency on row_version, retries on transient errors. - SQLite provider (STRICT tables, WAL, exact decimals as integers scaled by 10^6, Unicode case-insensitive LIKE, serialised writes) and PostgreSQL 16+ provider (numeric(19,6), timestamptz, jsonb, advisory locks, database creation and server info). Databases are configured from postgres:// and sqlite:// URLs whose password never appears in messages. - C# migrations with system and company catalogues, schema_version with checksums, one transaction per migration under a lock, refusal of unknown applied versions; first system tables sys_companies and sys_settings. - CompanyRegistry stores each company's database URL encrypted with the instance key (AES-256-GCM, HKDF-derived key, purpose as associated data), so a copied row cannot be read for another company. - tools/Khaemhat.DataModelTool, scripts/gen-datamodel.sh and scripts/new-migration.sh: the current schema section of docs/DATA-MODEL.md is generated from the migrations and a test fails when it is stale. - C# 14 binds array.Contains to MemoryExtensions over spans; the query translator unwraps the span conversion. - Tests run every data scenario on SQLite and PostgreSQL (PostgreSQL in CI); ADR 0018 records where the contracts differ from SPEC 5.1. Docs, wiki, changelog and status updated. Closes #7, #8, #9, #10, #11, #12, #13, #14 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
94 lines
3.3 KiB
C#
94 lines
3.3 KiB
C#
using System.Data.Common;
|
|
using Khaemhat.Data.Execution;
|
|
using Khaemhat.Data.Mapping;
|
|
using Khaemhat.Data.PostgreSql;
|
|
using Khaemhat.Data.Sqlite;
|
|
using Khaemhat.Data.SystemDatabase;
|
|
|
|
namespace Khaemhat.Data.Tests.Support;
|
|
|
|
/// <summary>
|
|
/// A fresh, empty database for one test: SQLite in memory, or a temporary PostgreSQL database on the server of
|
|
/// <c>KHAEMHAT_TEST_PG</c> (dropped at the end). PostgreSQL tests are inconclusive (skipped) when the variable is unset.
|
|
/// </summary>
|
|
internal sealed class TestDatabase : IAsyncDisposable
|
|
{
|
|
public const string Sqlite = "Sqlite";
|
|
public const string Postgres = "PostgreSql";
|
|
public const string TestUser = "tester";
|
|
|
|
private readonly DbConnection? _keeper;
|
|
|
|
private TestDatabase(DatabaseUrl url, DatabaseTarget target, DbProviderCatalog providers, DbConnection? keeper)
|
|
{
|
|
Url = url;
|
|
Target = target;
|
|
Providers = providers;
|
|
_keeper = keeper;
|
|
}
|
|
|
|
public static string? PostgresServer => Environment.GetEnvironmentVariable("KHAEMHAT_TEST_PG") is { Length: > 0 } value ? value : null;
|
|
|
|
public DatabaseUrl Url { get; }
|
|
|
|
public DatabaseTarget Target { get; }
|
|
|
|
public DbProviderCatalog Providers { get; }
|
|
|
|
public IDbProvider Provider => Target.Provider;
|
|
|
|
public ISqlDialect Dialect => Provider.Dialect;
|
|
|
|
public MapRegistry Maps { get; } = new MapRegistry().AddFromAssembly(typeof(CompanyMap).Assembly).Add(new TestItemMap());
|
|
|
|
public DataAccessContext Context { get; } = new(TimeProvider.System, () => TestUser);
|
|
|
|
public static DbProviderCatalog AllProviders() => new(new SqliteProvider(), new PostgresProvider());
|
|
|
|
public static async Task<TestDatabase> CreateAsync(string engine)
|
|
{
|
|
var providers = AllProviders();
|
|
if (engine == Sqlite)
|
|
{
|
|
var url = DatabaseUrl.Parse("sqlite://memory/t" + Guid.NewGuid().ToString("N"));
|
|
var target = providers.Resolve(url);
|
|
var keeper = target.Provider.CreateConnection(target.ConnectionString);
|
|
await keeper.OpenAsync();
|
|
return new TestDatabase(url, target, providers, keeper);
|
|
}
|
|
|
|
if (PostgresServer is null)
|
|
{
|
|
Assert.Inconclusive("KHAEMHAT_TEST_PG is not set: PostgreSQL test skipped.");
|
|
}
|
|
|
|
var pgUrl = DatabaseUrl.Parse(PostgresServer!).WithDatabase("khaemhat_t_" + Guid.NewGuid().ToString("N")[..12]);
|
|
var pgTarget = providers.Resolve(pgUrl);
|
|
await pgTarget.Provider.EnsureDatabaseExistsAsync(pgTarget.ConnectionString);
|
|
return new TestDatabase(pgUrl, pgTarget, providers, keeper: null);
|
|
}
|
|
|
|
public Task<UnitOfWork> OpenAsync() => UnitOfWork.OpenAsync(Target, Maps, Context);
|
|
|
|
/// <summary>Creates the <c>test_items</c> table used by the repository and dialect tests.</summary>
|
|
public async Task CreateTestTableAsync()
|
|
{
|
|
await using var unitOfWork = await OpenAsync();
|
|
foreach (var statement in Provider.Ddl.Generate(TestItemMap.Schema()))
|
|
{
|
|
await unitOfWork.ExecuteAsync(SqlFragment.Literal(statement));
|
|
}
|
|
}
|
|
|
|
public async ValueTask DisposeAsync()
|
|
{
|
|
if (_keeper is not null)
|
|
{
|
|
await _keeper.DisposeAsync();
|
|
return;
|
|
}
|
|
|
|
await Provider.DropDatabaseAsync(Target.ConnectionString);
|
|
}
|
|
}
|