using System.Net; using System.Text.RegularExpressions; using Chronos.Data; using Chronos.Server.Configuration; using Chronos.Server.Hosting; using Chronos.Testing; namespace Chronos.Server.Tests.Hosting; [Category("server")] public sealed class StartupTests(TestContext context) { [Test] public void TheServerRefusesToStartWithoutTheArchiveModule() { var root = context.CreateTempDirectory("bare"); var options = new ServerOptions { DataPath = Path.Combine(root, "data"), ArchivePath = Path.Combine(root, "archive"), HttpPort = 0, HttpsPort = 0, Database = DatabaseKind.Sqlite, Discovery = false, }; var error = Assert.Throws(() => ServerHost.Build(options, [])); Assert.Contains("IArchiveIngest", error.Message); Assert.Contains("IFrameAssetLocator", error.Message); } [Test] public void ChronosDbAcceptsAConnectionString() { var root = context.CreateTempDirectory("env"); var options = ServerOptions.Load(new Dictionary { ["CHRONOS_DATA_PATH"] = root, ["CHRONOS_DB"] = "Host=db.lan;Port=6543;Database=archive;Username=chronos;Password=secret", }); Assert.Equal(DatabaseKind.Postgres, options.Database); var database = options.ToDatabaseOptions(); Assert.Equal(Dialect.Postgres, database.Dialect); Assert.Equal(6543, Chronos.Data.Postgres.PostgresSettings.Parse(database.ConnectionString).Port); } [Test] public void PartsBuildAQuotedPostgresConnectionString() { var options = new ServerOptions { Database = DatabaseKind.Postgres, // the Windows default is SQLite DbHost = "postgres", DbName = "chronos", DbUser = "chronos", DbPassword = "it's;secret", DbSslMode = "disable", }; var settings = Chronos.Data.Postgres.PostgresSettings.Parse(options.ToDatabaseOptions().ConnectionString); Assert.Equal(("postgres", "chronos", "it's;secret"), (settings.Host, settings.Database, settings.Password)); Assert.Equal(Chronos.Data.Postgres.SslMode.Disable, settings.SslMode); } [Test] public void EnvironmentVariablesLockTheirSettings() { var root = context.CreateTempDirectory("locked"); var options = ServerOptions.Load(new Dictionary { ["CHRONOS_DATA_PATH"] = root, ["CHRONOS_DB"] = "postgres", ["CHRONOS_HTTP_PORT"] = "9090", ["CHRONOS_DISCOVERY"] = "false", }); Assert.SequenceEqual(["Database", "HttpPort", "Discovery"], options.Locked); Assert.Throws(() => ServerOptions.Load(new Dictionary { ["CHRONOS_DATA_PATH"] = root, ["CHRONOS_DB"] = "postgres", ["CHRONOS_WORKERS"] = "many" })); } [Test] public void TheFormerWorkersSettingStillSetsTheParallelism() { // Owner review 1: "workers" (jobs at once) became the parallelism (photos the running job processes at once). var root = context.CreateTempDirectory("workers"); File.WriteAllText(Path.Combine(root, "server.json"), """{ "Workers": 6 }"""); Assert.Equal(6, ServerOptions.Load(new Dictionary { ["CHRONOS_DATA_PATH"] = root, ["CHRONOS_DB"] = "postgres" }).Parallelism); var former = ServerOptions.Load(new Dictionary { ["CHRONOS_DATA_PATH"] = root, ["CHRONOS_DB"] = "postgres", ["CHRONOS_WORKERS"] = "5" }); Assert.Equal((5, true), (former.Parallelism, former.FormerWorkersVariable)); Assert.SequenceEqual(["Database", "Parallelism"], former.Locked); var both = ServerOptions.Load(new Dictionary { ["CHRONOS_DATA_PATH"] = root, ["CHRONOS_DB"] = "postgres", ["CHRONOS_WORKERS"] = "5", ["CHRONOS_PARALLELISM"] = "7", ["CHRONOS_PRIORITY_QUEUE"] = "true", }); Assert.Equal((7, true), (both.Parallelism, both.PriorityQueue)); Assert.SequenceEqual(["Database", "Parallelism", "PriorityQueue"], both.Locked); Assert.False(ServerOptions.Load(new Dictionary { ["CHRONOS_DATA_PATH"] = root, ["CHRONOS_DB"] = "postgres", ["CHRONOS_PARALLELISM"] = "2" }) .FormerWorkersVariable); Assert.Throws(() => ServerOptions.Load(new Dictionary { ["CHRONOS_DATA_PATH"] = root, ["CHRONOS_DB"] = "postgres", ["CHRONOS_PRIORITY_QUEUE"] = "often" })); // A value the admin panel would refuse is brought within its range, so the panel can still save the other settings. Assert.Equal(ServerOptions.MaxParallelism, ServerOptions.Load(new Dictionary { ["CHRONOS_DATA_PATH"] = root, ["CHRONOS_DB"] = "postgres", ["CHRONOS_PARALLELISM"] = "96" }).Parallelism); Assert.Equal(1, ServerOptions.Load(new Dictionary { ["CHRONOS_DATA_PATH"] = root, ["CHRONOS_DB"] = "postgres", ["CHRONOS_WORKERS"] = "0" }).Parallelism); Assert.InRange(new ServerOptions().Parallelism, 1, ServerOptions.MaxParallelism); } [Test] public void TrustedProxiesAreAddressesOrNetworks() { var root = context.CreateTempDirectory("proxies"); // Loopback only: machines of the home network reach the HTTP port directly from private addresses. var defaults = ServerOptions.Load(new Dictionary { ["CHRONOS_DATA_PATH"] = root, ["CHRONOS_DB"] = "postgres" }).TrustedProxyNetworks(); foreach (var address in new[] { "127.0.0.1", "127.0.0.53", "::1" }) Assert.True(defaults.Any(n => n.Contains(IPAddress.Parse(address))), address); foreach (var address in new[] { "10.20.30.40", "172.18.0.3", "192.168.1.2", "fd00::7", "203.0.113.5" }) Assert.False(defaults.Any(n => n.Contains(IPAddress.Parse(address))), address); var options = ServerOptions.Load(new Dictionary { ["CHRONOS_DATA_PATH"] = root, ["CHRONOS_DB"] = "postgres", ["CHRONOS_TRUSTED_PROXIES"] = "10.1.2.3, 2001:db8::/32;172.20.0.5/16", }); Assert.Contains("TrustedProxies", options.Locked); Assert.SequenceEqual(["10.1.2.3/32", "2001:db8::/32", "172.20.0.0/16"], options.TrustedProxyNetworks().Select(n => n.ToString())); foreach (var invalid in new[] { "proxy.lan", "10.0.0.0/33", "fe80::1%2" }) { var error = Assert.Throws(() => ServerOptions.Load(new Dictionary { ["CHRONOS_DATA_PATH"] = root, ["CHRONOS_DB"] = "postgres", ["CHRONOS_TRUSTED_PROXIES"] = "127.0.0.1," + invalid, })); Assert.Contains(invalid, error.Message); } } [Test] public void PublicPortsComeFromTheEnvironment() { var root = context.CreateTempDirectory("public"); var options = ServerOptions.Load(new Dictionary { ["CHRONOS_DATA_PATH"] = root, ["CHRONOS_DB"] = "postgres", ["CHRONOS_PUBLIC_HTTP_PORT"] = "18080", ["CHRONOS_PUBLIC_HTTPS_PORT"] = "18443", }); Assert.Equal((18080, 18443), (options.PublicHttpPort, options.PublicHttpsPort)); Assert.Null(ServerOptions.Load(new Dictionary { ["CHRONOS_DATA_PATH"] = root, ["CHRONOS_DB"] = "postgres" }).PublicHttpsPort); foreach (var invalid in new[] { "0", "70000", "https" }) Assert.Throws(() => ServerOptions.Load(new Dictionary { ["CHRONOS_DATA_PATH"] = root, ["CHRONOS_DB"] = "postgres", ["CHRONOS_PUBLIC_HTTPS_PORT"] = invalid })); } [Test] public void HelpListsEveryVariable() { foreach (var variable in ServerOptions.EnvironmentVariables.Concat(["PUID", "PGID", "TZ"])) Assert.True(Regex.IsMatch(ServerCommandLine.Usage, $@"\b{variable}\b"), variable); } }