using System.Xml.Linq; using Titano.Testing; using Titano.Tools.Commands; namespace Titano.Tools.Tests; /// i18n check: English texts that count something need plural forms (BRIEF §16), and every error code /// of the server has its message, whose key is built at run time. public sealed class I18nCommandTests { [Test] public void ANumberInFrontOfACountedNounNeedsPluralForms() { Assert.Equal("frames", I18nCommand.CountedNoun("Advisor.Finding.BlackFrames", "{0} frames are black (lens cap or missed exposure).")); Assert.Equal("gaps", I18nCommand.CountedNoun("Advisor.Reason.Timing.SparseGaps", "{0} short gaps, but motion is unmeasured or fast.")); Assert.Equal("changes", I18nCommand.CountedNoun("Advisor.Finding.StepsNotReceived", "{0} logged exposure changes never reached the pixels.")); Assert.Equal("times", I18nCommand.CountedNoun("Advisor.Finding.LensChanged", "The lens changes {0} times.")); Assert.Equal("sequences", I18nCommand.CountedNoun("Errors.Analysis.Failed", "{0} of {1} sequences could not be analysed; see the job log.")); Assert.Equal("jobs", I18nCommand.CountedNoun("Shell.JobBar.Ready", "Ready · {0:N0} jobs queued")); Assert.Equal("cores", I18nCommand.CountedNoun("Settings.Rendering.Cores", "of {0} logical cores")); } [Test] public void PluralFormsBoundsLabelsAndUnitsCountNothing() { Assert.Null(I18nCommand.CountedNoun("Advisor.Finding.BlackFrames.other", "{0} frames are black (lens cap or missed exposure).")); Assert.Null(I18nCommand.CountedNoun("Advisor.Finding.BlackFrames.one", "{0} frame is black (lens cap or missed exposure).")); Assert.Null(I18nCommand.CountedNoun("Server.Error.WeakPassword", "Use at least {0} characters.")); Assert.Null(I18nCommand.CountedNoun("Library.Views.Error.Long", "At most {0} characters, no control characters.")); Assert.Null(I18nCommand.CountedNoun("Archive.Retag.Invalid", "Each tag has 1 to {0} characters.")); Assert.Null(I18nCommand.CountedNoun("Archive.Log.ScanDone", "Folders: {0}, indexed: {1}, adopted: {2}, removed: {3}")); Assert.Null(I18nCommand.CountedNoun("Advisor.Reason.Window.Period.other", "Flicker repeats every {0} frames: a {1}-frame window averages four cycles.")); Assert.Null(I18nCommand.CountedNoun("Advisor.Reason.Timing.Regular", "Steady {0} s interval (jitter {1} s): each photo becomes one video frame.")); Assert.Null(I18nCommand.CountedNoun("Tooltips.Editor.Remote", "Changes are saved on {0} and analyses and renders run there")); Assert.Null(I18nCommand.CountedNoun("Advisor.Reason.Transition.Single", "A single exposure step: a {0}-frame transition keeps the change gentle.")); } [Test] public void ATallyOfParticiplesNeedsLabels() { // Italian reads "1 copiate · 1 non riuscite": the participle agrees with the number in front of it. Assert.Equal("copied", I18nCommand.CountedTally("Import.Result.Partial", "{0} copied · {1} failed")); Assert.Equal("missing", I18nCommand.CountedTally("Archive.Health.Damaged", "{0} missing · {1} damaged")); Assert.Equal("made", I18nCommand.CountedTally("Archive.Log.ImagesDone", "{0}: {1} made, {2} reused, {3} unreadable")); Assert.Equal("copied", I18nCommand.CountedTally("Archive.Log.ImportDone", "{0:N0} copied, {1:N0} skipped, {2:N0} failed.")); } [Test] public void LabelsNamesAndSizesAreNoTally() { Assert.Null(I18nCommand.CountedTally("Import.Result.Partial", "Copied: {0} · failed: {1}")); Assert.Null(I18nCommand.CountedTally("Archive.Log.ImagesDone", "{0}: made {1}, reused {2}, unreadable {3}")); Assert.Null(I18nCommand.CountedTally("Archive.Log.ScanDone", "Folders: {0}, indexed: {1}, adopted: {2}, removed: {3}")); // A single participle after a placeholder is as often a name or a size as a count. Assert.Null(I18nCommand.CountedTally("Export.Log.Failed", "{0} failed: {1}")); Assert.Null(I18nCommand.CountedTally("Library.Queued", "{0} queued · {1}")); Assert.Null(I18nCommand.CountedTally("Import.Plan.SpaceMissing", "{0} missing")); Assert.Null(I18nCommand.CountedTally("Settings.Storage.Usage", "{0} used · {1} free")); Assert.Null(I18nCommand.CountedTally("Import.Result.Skipped.other", "{0:N0} copied, {1:N0} skipped")); } [Test] public void ErrorCodesAreTheLiteralsPassedToTheServerErrorHelpers() { const string source = """ if (bad) return ApiErrors.BadRequest(context, "invalid_filter", "status"); return known.SequenceId == sequenceId ? new StartUploadResponse(null, options.ChunkSizeBytes, [], AlreadyExists: true, null) : Outcome.Fail(409, "render_exists"); return Fail(400, "chunk_size", expected.ToString(CultureInfo.InvariantCulture)); DeleteBlock.Offline => ApiErrors.Result(context, StatusCodes.Status503ServiceUnavailable, "archive_offline"), return TooMany(context, "rate_limited", wait); return ApiErrors.NotFound(context, "sequence"); return ApiErrors.BadRequest(context, code, setting, setting); await FailAsync(upload, "not_a_code"); """; Assert.SequenceEqual(["invalid_filter", "render_exists", "chunk_size", "archive_offline", "rate_limited"], I18nCommand.ErrorCodes(source).ToList()); } [Test] public void AnErrorCodeNamesItsMessageKeyLikeTheServer() { Assert.Equal("Server.Error.RenderExists", I18nCommand.ErrorKey("render_exists")); Assert.Equal("Server.Error.Forbidden", I18nCommand.ErrorKey("forbidden")); Assert.Equal("Server.Error.Http413", I18nCommand.ErrorKey("http_413")); } [Test] public void EveryErrorCodeOfTheServerHasAnEnglishMessage() { var root = Args.RepoRoot(); var keys = XDocument.Load(Path.Combine(root, "i18n", "en", "Server.resx")).Root!.Elements("data") .Select(d => (string)d.Attribute("name")!).ToHashSet(StringComparer.Ordinal); var missing = I18nCommand.MissingErrorMessages(root, keys).ToList(); Assert.Empty(missing.Select(m => $"{m.Code} ({Path.GetFileName(m.File)})")); var withoutOne = keys.Where(k => k != "Server.Error.RenderExists").ToHashSet(StringComparer.Ordinal); var reported = I18nCommand.MissingErrorMessages(root, withoutOne).ToList(); Assert.Count(1, reported); Assert.Equal(("render_exists", "Server.Error.RenderExists", "RenderUploads.cs"), (reported[0].Code, reported[0].Key, Path.GetFileName(reported[0].File))); } }