Code quality gates
- QUAL-01 MUST NullAway is an error, not a warning. A new package starts with its own
package-info.javacarrying@NullMarked.- Check (code): the compiler arguments say
-Xep:NullAway:ERROR; every source package has apackage-info.javawith@NullMarked. - Reference: Editora
pom.xml,docs/conventions.md(Null annotations).
- Check (code): the compiler arguments say
- QUAL-02 SHOULD A NullAway report is fixed, not suppressed: put
@Nullableon what may be null.- Check (code):
grep -rn '@SuppressWarnings("NullAway")' src/mainfinds nothing. - Reference: Editora; one suppression is left, in
recovery/RecoveryCodec.java.
- Check (code):
- QUAL-03 SHOULD Coverage floors are a regression net, not a target. Beyond the build-wide floor of 0.90
lines and methods, each package of 300+ lines gets its own floor about three points below its measured level;
when a package’s coverage rises, its floor is ratcheted up.
- Check (code): the
jacoco-checkrules inpom.xmlcarry aPACKAGEline floor for each large package. - Reference: Editora
pom.xmljacoco-check.
- Check (code): the
- QUAL-04 SHOULD When a guide quotes the coverage floors, a test fails when the quoted table and the pom
disagree.
- Check (test): a build test reads the
jacoco-checkrules frompom.xmland compares them with the guide’s table. - Reference: Editora
BuildHygieneTest.theCoverageFloorsQuotedInTheTestingGuideAreTheOnesTheBuildEnforces,docs/testing.md.
- Check (test): a build test reads the
- QUAL-05 MUST Extract the decision, then test it (principle 12).
Prefer a pure decision helper plus unit tests; use the headless FX harness only when controller or toolkit
behavior is the point.
- Check (code): enablement, visibility and navigation rules sit in classes that import no
javafxtype, each with a unit test not taggedfx. - Reference: Editora
docs/testing.md(Prefer pure logic):ui/Chrome,editops/TextNav,config/PathKeys, each with a plain unit test.
- Check (code): enablement, visibility and navigation rules sit in classes that import no
- QUAL-06 MUST FX tests are tagged
@Tag("fx"), so the pure suite runs alone with-DexcludedGroups=fx.- Check (code): every test class that boots the toolkit (
FxTestSupport,FxToolkit) carries@Tag("fx"). - Reference: Editora
docs/testing.md. Editora does not hold it fully yet: about twenty*FxTestclasses, most of themProjectMap*FxTest, carry no tag.
- Check (code): every test class that boots the toolkit (
- QUAL-07 SHOULD Tests do not sleep. Workers and FX callbacks are owned by a scope (
AsyncTestScope), and tests wait on latches.- Check (code):
grep -rn 'Thread.sleep' src/testfinds nothing. - Reference: Editora
AsyncTestScope,docs/testing.md. Many older Editora tests still poll withThread.sleep.
- Check (code):
- QUAL-08 SHOULD A test window writes only inside its temp folders, never in the real home directory.
- Check (test): the command sweep checks the home directory after running every command.
- Reference: Editora
CommandSweepFxTest.leftInTheHomeDirectory.
- QUAL-09 MUST UI work is verified in the running app
(principle 13): a capture hook or headless screenshot of the real
window, with real key and mouse events, before a UI change is called done.
- Check (code): the app has a capture hook (
DevCapture) or a headless fixture that builds the real window. - Reference: Editora
FxWindowFixture(the realMainControllerwindow, headless); Torrenta and TerminaDevCapture.java.
- Check (code): the app has a capture hook (
- QUAL-10 SHOULD A guard that cannot fail is decoration. When you add a drift or parity test, break the
thing it guards once and watch it fail.
- Check (by hand): break what the new test guards, run it, and see it fail.
- Reference: Modula’s
DependenciesTest.
Guard tests that pay for themselves across the family:
- QUAL-11 SHOULD A command sweep runs every registered command in a real headless window.
- Check (test): one FX test iterates the registry and runs each command.
- Reference: Editora
CommandSweepFxTest.
- QUAL-12 MUST A message parity test holds that every locale has every key and every
command.<id>has a.desc.- Check (test): the test fails on a key missing from a locale or a command title without
.desc. - Reference: Editora
MessagesTest.
- Check (test): the test fails on a key missing from a locale or a command title without
- QUAL-13 SHOULD A settings round trip shows that every switch, number and choice survives a restart.
- Check (test): one FX test sets every control, reloads the settings and reads each back.
- Reference: Editora
SettingsRoundTripFxTest.
- QUAL-14 SHOULD A contrast test holds that text tokens keep their ratios in every theme.
- Check (test): a pure test reads the stylesheets and does the WCAG arithmetic.
- Reference: Editora
StyleContrastTest.
- QUAL-15 SHOULD A release supply-chain test keeps the signing and attestation steps where they are.
- Check (test): a test reads the workflows and fails when a signing, notarization or attestation step moves or goes.
- Reference: Editora
ReleaseSupplyChainTest.
Pauta 2.0.0 · · Changelog · This page in the latest edition