Files
siftlode/frontend/src/i18n/plurals.test.ts
T
peter 4aaaaa7860 chore(comments): drop epic, sprint and review-round ids from the code
The code cited its plan instead of saying why: `E28 review J4`, `(R6 S3b)`, `S1 justified…`,
`deep-review round 5`. That plan lives in the private ops repo, so for every reader of this one the
citation was noise, and a sentence whose subject was the plan step ("round 2 showed…") hid its
lesson behind an id. Each one is gone and the "why" kept: a bare citation is deleted, a sentence
carrying a lesson is reworded around it ("a later attempt showed…").

Measured (`scripts/audit_metrics.py`, product code): 652 lines in 270 files carried an epic code by
the definition the next commit holds (507 / 241 by the old, two-digit-only one) -> 0. Across all
code, tests, scripts and configs: ~1100 epic-code lines plus ~320 sprint/round ids.

Behaviour unchanged, checked mechanically: every changed .py file has the same AST once docstrings
are blanked; css/sh/toml/yml/json files are identical once comments are stripped; the only
non-comment changes in TS/JS are test titles, one description string in a contract table, and five
ESLint messages, whose text is all the gates snapshot diff holds. Not touched: Markdown (docs and
the changelog keep their history), Alembic migrations, TV episode notation (`S2 · E5`), DESIGN.md
ids (`C1`, `B4`, `S3h`), tracker ids (`SEC-16`, `DX-17`).

One stale claim fixed on the way: test_hls_reaper's docstring said the player checkpoints "every
10 s whether or not it is playing", which plex/stream.py calls wrong; it now says what the code does.
2026-10-05 00:19:39 +02:00

62 lines
2.7 KiB
TypeScript

// @vitest-environment jsdom
//
// A count in copy goes through i18next's plural forms (`count`), never a bare `n` —
// the share dialog's expiry read "1 days".
import { describe, expect, it } from "vitest";
import i18n from "./index";
const mods = import.meta.glob("./locales/*/*.json", { eager: true }) as Record<
string,
{ default: Record<string, unknown> }
>;
// Every leaf string as [dotted key, value].
function leaves(obj: Record<string, unknown>, prefix = ""): [string, string][] {
return Object.entries(obj).flatMap(([k, v]) => {
const key = prefix ? `${prefix}.${k}` : k;
if (v && typeof v === "object") return leaves(v as Record<string, unknown>, key);
return typeof v === "string" ? [[key, v] as [string, string]] : [];
});
}
describe("counted copy", () => {
it("the share link's expiry is singular for one day", async () => {
await i18n.changeLanguage("en");
expect(i18n.t("downloads.share.days", { count: 1 })).toBe("1 day");
expect(i18n.t("downloads.share.days", { count: 7 })).toBe("7 days");
await i18n.changeLanguage("hu");
expect(i18n.t("downloads.share.days", { count: 1 })).toBe("1 nap");
await i18n.changeLanguage("en");
});
it("a link's view count is singular for one view", async () => {
await i18n.changeLanguage("en");
expect(i18n.t("downloads.share.views", { count: 1 })).toBe("1 view");
expect(i18n.t("downloads.share.views", { count: 0 })).toBe("0 views");
});
});
// "1 seasons", "Synced 1 subscriptions" — a counted string written as one plain key reads plural at
// one. So the rule is held for every string, not key by key: a value that carries {{count}} is a plural
// pair (`_one` / `_other`), even where the two read the same today, so the next wording is a plural too.
describe("every counted string is a plural pair", () => {
it("no {{count}} in a key without a plural suffix, in any language", () => {
const bare = Object.entries(mods).flatMap(([path, mod]) =>
leaves(mod.default)
.filter(([k, v]) => v.includes("{{count}}") && !/_(zero|one|two|few|many|other)$/.test(k))
.map(([k]) => `${path.replace(/^.*locales\//, "")}: ${k}`),
);
expect(bare).toEqual([]);
});
it("reads singular at one", async () => {
await i18n.changeLanguage("en");
expect(i18n.t("plex.seasons", { count: 1 })).toBe("1 season");
expect(i18n.t("plex.seasons", { count: 3 })).toBe("3 seasons");
expect(i18n.t("channels.notify.synced", { count: 1 })).toBe("Synced 1 subscription");
expect(i18n.t("playlists.pushPartial", { count: 1 })).toBe("Synced, but 1 video was skipped");
expect(i18n.t("playlists.pushPartial", { count: 2 })).toBe("Synced, but 2 videos were skipped");
});
});