using System;
using System.Linq;
using System.Threading;
using System.Threading.Tasks;
using DotNet.Testcontainers.Builders;
using Jellyfin.Database.Implementations;
using Jellyfin.Database.Implementations.DbConfiguration;
using Jellyfin.Database.Implementations.Entities;
using Jellyfin.Database.Implementations.Locking;
using Jellyfin.Database.Providers.PostgreSQL;
using Microsoft.EntityFrameworkCore;
using Microsoft.Extensions.Logging.Abstractions;
using Npgsql;
using Testcontainers.PostgreSql;
using Xunit;
namespace Jellyfin.Database.Tests.PostgreSQL;
///
/// Integration tests for CRUD operations, optimisation, and purge against a real PostgreSQL 16 container.
///
[Xunit.Trait("Category", "RequiresDocker")]
public sealed class PostgreSqlProviderTests : IAsyncLifetime
{
private readonly PostgreSqlContainer _container;
private NpgsqlDataSource? _dataSource;
private PostgreSqlDatabaseProvider? _provider;
///
/// Initializes a new instance of the class.
///
public PostgreSqlProviderTests()
{
_container = new PostgreSqlBuilder("postgres:16-alpine")
.WithWaitStrategy(Wait.ForUnixContainer().UntilCommandIsCompleted("pg_isready"))
.Build();
}
///
/// Starts the PostgreSQL container and applies migrations before any tests in the class run.
///
/// A representing the asynchronous operation.
public async ValueTask InitializeAsync()
{
await _container.StartAsync().ConfigureAwait(false);
_dataSource = new NpgsqlDataSourceBuilder(_container.GetConnectionString()).Build();
_provider = new PostgreSqlDatabaseProvider(_dataSource);
// Apply migrations once for the whole test class.
var context = CreateContext();
await using (context.ConfigureAwait(false))
{
await context.Database.MigrateAsync().ConfigureAwait(false);
}
}
///
/// Stops and removes the PostgreSQL container after all tests in the class have run.
///
/// A representing the asynchronous operation.
public async ValueTask DisposeAsync()
{
if (_dataSource is not null)
{
await _dataSource.DisposeAsync().ConfigureAwait(false);
}
await _container.DisposeAsync().ConfigureAwait(false);
}
///
/// Verifies Create/Read/Update/Delete operations on .
///
/// A representing the asynchronous operation.
[Fact]
public async Task Crud_User()
{
var ctx = CreateContext();
await using (ctx)
{
// Create
var user = new User("testuser", "Jellyfin.Server.Implementations.Users.DefaultAuthenticationProvider", "Jellyfin.Server.Implementations.Users.DefaultPasswordResetProvider");
ctx.Users.Add(user);
await ctx.SaveChangesAsync(TestContext.Current.CancellationToken);
var userId = user.Id;
// Read
var read = await ctx.Users.FindAsync([userId], TestContext.Current.CancellationToken);
Assert.NotNull(read);
Assert.Equal("testuser", read.Username);
// Update
read.Username = "updateduser";
await ctx.SaveChangesAsync(TestContext.Current.CancellationToken);
var updated = await ctx.Users.FindAsync([userId], TestContext.Current.CancellationToken);
Assert.Equal("updateduser", updated!.Username);
// Delete
ctx.Users.Remove(updated);
await ctx.SaveChangesAsync(TestContext.Current.CancellationToken);
var deleted = await ctx.Users.FindAsync([userId], TestContext.Current.CancellationToken);
Assert.Null(deleted);
}
}
///
/// Verifies Create/Read/Update/Delete operations on .
///
/// A representing the asynchronous operation.
[Fact]
public async Task Crud_ActivityLog()
{
var ctx = CreateContext();
await using (ctx)
{
// Create
var log = new ActivityLog("Test activity", "TestType", Guid.Empty);
ctx.ActivityLogs.Add(log);
await ctx.SaveChangesAsync(TestContext.Current.CancellationToken);
var logId = log.Id;
// Read
var read = await ctx.ActivityLogs.FindAsync([logId], TestContext.Current.CancellationToken);
Assert.NotNull(read);
Assert.Equal("Test activity", read.Name);
// Update
read.Overview = "Updated overview";
await ctx.SaveChangesAsync(TestContext.Current.CancellationToken);
var updated = await ctx.ActivityLogs.FindAsync([logId], TestContext.Current.CancellationToken);
Assert.Equal("Updated overview", updated!.Overview);
// Delete
ctx.ActivityLogs.Remove(updated);
await ctx.SaveChangesAsync(TestContext.Current.CancellationToken);
var deleted = await ctx.ActivityLogs.FindAsync([logId], TestContext.Current.CancellationToken);
Assert.Null(deleted);
}
}
///
/// Verifies Create/Read/Update/Delete operations on .
///
/// A representing the asynchronous operation.
[Fact]
public async Task Crud_DisplayPreferences()
{
var ctx = CreateContext();
await using (ctx)
{
var userId = Guid.NewGuid();
var itemId = Guid.NewGuid();
// Create
var prefs = new DisplayPreferences(userId, itemId, "TestClient");
ctx.DisplayPreferences.Add(prefs);
await ctx.SaveChangesAsync(TestContext.Current.CancellationToken);
var prefsId = prefs.Id;
// Read
var read = await ctx.DisplayPreferences.FindAsync([prefsId], TestContext.Current.CancellationToken);
Assert.NotNull(read);
Assert.Equal("TestClient", read.Client);
// Update
read.ShowSidebar = true;
await ctx.SaveChangesAsync(TestContext.Current.CancellationToken);
var updated = await ctx.DisplayPreferences.FindAsync([prefsId], TestContext.Current.CancellationToken);
Assert.True(updated!.ShowSidebar);
// Delete
ctx.DisplayPreferences.Remove(updated);
await ctx.SaveChangesAsync(TestContext.Current.CancellationToken);
var deleted = await ctx.DisplayPreferences.FindAsync([prefsId], TestContext.Current.CancellationToken);
Assert.Null(deleted);
}
}
///
/// Verifies Create/Read/Update/Delete operations on , , and .
///
/// A representing the asynchronous operation.
[Fact]
public async Task Crud_BaseItem_Chapter_MediaStream()
{
var ctx = CreateContext();
await using (ctx)
{
var itemId = Guid.NewGuid();
// Create BaseItem
var item = new BaseItemEntity { Id = itemId, Type = "Movie", Name = "Test Movie" };
ctx.BaseItems.Add(item);
await ctx.SaveChangesAsync(TestContext.Current.CancellationToken);
// Create Chapter linked to BaseItem
var chapter = new Chapter { ItemId = itemId, Item = item, ChapterIndex = 0, StartPositionTicks = 0, Name = "Intro" };
ctx.Chapters.Add(chapter);
// Create MediaStreamInfo linked to BaseItem
var stream = new MediaStreamInfo { ItemId = itemId, Item = item, StreamIndex = 0, StreamType = MediaStreamTypeEntity.Video };
ctx.MediaStreamInfos.Add(stream);
await ctx.SaveChangesAsync(TestContext.Current.CancellationToken);
// Read
var readItem = await ctx.BaseItems
.Include(i => i.Chapters)
.Include(i => i.MediaStreams)
.FirstOrDefaultAsync(i => i.Id.Equals(itemId), TestContext.Current.CancellationToken);
Assert.NotNull(readItem);
Assert.Equal("Test Movie", readItem.Name);
Assert.Single(readItem.Chapters!);
Assert.Single(readItem.MediaStreams!);
// Update
readItem.Name = "Updated Movie";
await ctx.SaveChangesAsync(TestContext.Current.CancellationToken);
var updated = await ctx.BaseItems.FindAsync([itemId], TestContext.Current.CancellationToken);
Assert.Equal("Updated Movie", updated!.Name);
// Delete (cascades to Chapter and MediaStreamInfo)
ctx.BaseItems.Remove(updated);
await ctx.SaveChangesAsync(TestContext.Current.CancellationToken);
var deleted = await ctx.BaseItems.FindAsync([itemId], TestContext.Current.CancellationToken);
Assert.Null(deleted);
}
}
///
/// Verifies that executes ANALYZE without error.
///
/// A representing the asynchronous operation.
[Fact]
public async Task RunScheduledOptimisation_ExecutesWithoutError()
{
var ctx = CreateContext();
await using (ctx)
{
var factory = new TestDbContextFactory(ctx);
_provider!.DbContextFactory = factory;
await _provider.RunScheduledOptimisation(CancellationToken.None);
}
}
///
/// Verifies that empties tables and resets session_replication_role.
///
/// A representing the asynchronous operation.
[Fact]
public async Task PurgeDatabase_EmptiesTablesAndResetsFkRole()
{
var ctx = CreateContext();
await using (ctx)
{
// Seed a row
ctx.ActivityLogs.Add(new ActivityLog("Purge test", "TestType", Guid.Empty));
await ctx.SaveChangesAsync(TestContext.Current.CancellationToken);
Assert.True(await ctx.ActivityLogs.AnyAsync(TestContext.Current.CancellationToken));
// Purge
await _provider!.PurgeDatabase(ctx, ["ActivityLogs"]);
// session_replication_role should be reset to 'origin' (default)
var role = await ctx.Database
.SqlQueryRaw("SELECT current_setting('session_replication_role')")
.FirstAsync(TestContext.Current.CancellationToken);
Assert.Equal("origin", role);
}
// Verify table is empty via a fresh context
var freshCtx = CreateContext();
await using (freshCtx)
{
Assert.False(await freshCtx.ActivityLogs.AnyAsync(TestContext.Current.CancellationToken));
}
}
private JellyfinDbContext CreateContext()
{
var optionsBuilder = new DbContextOptionsBuilder();
_provider!.Initialise(optionsBuilder, new DatabaseConfigurationOptions { DatabaseType = "PostgreSQL" });
return new JellyfinDbContext(
optionsBuilder.Options,
NullLogger.Instance,
_provider,
new NoLockBehavior(NullLogger.Instance));
}
///
/// A minimal wrapper that returns a pre-existing context.
///
private sealed class TestDbContextFactory : IDbContextFactory
{
private readonly JellyfinDbContext _context;
///
/// Initializes a new instance of the class.
///
/// The context to return from .
public TestDbContextFactory(JellyfinDbContext context)
{
_context = context;
}
///
/// Returns the pre-existing instance.
///
/// The pre-existing instance.
public JellyfinDbContext CreateDbContext() => _context;
///
/// Returns the pre-existing instance as a completed task.
///
/// A cancellation token (unused).
/// A containing the pre-existing instance.
public Task CreateDbContextAsync(CancellationToken cancellationToken = default)
=> Task.FromResult(_context);
}
}