Files
Chronos/tests/Titano.Tools.Tests/I18nCommandTests.cs
T

106 lines
6.6 KiB
C#

using System.Xml.Linq;
using Titano.Testing;
using Titano.Tools.Commands;
namespace Titano.Tools.Tests;
/// <summary><c>i18n check</c>: 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.</summary>
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<StartUploadResponse>.Fail(409, "render_exists");
return Fail<ChunkReceived>(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)));
}
}