Written to: 1 requirement: 1 proved, 0 partly, 0 failing, 0 with no test recorded. 0008-repoctl-prove FR-011
Which tests a change must run, and which it may leave out (commons repoctl 0008-repoctl-proveFR-011, FR-012, FR-014): a test runs when anything it transitively imports changed (the selector by imports), when a requirement named by a changed file's // Spec: line is proved by it (the selector by the trace register), or, for a seam, when its library imports a changed symbol of the provider; a test of a suite that reads the tree is never left out (a seam is about symbols, so it runs the tests that import them); a quarantined test is reported and not run until its expiry; and the key of a result in the cache is a hash of everything that decides it.
The functions are pure: the Physical layer reads the files, resolves the imports and runs the tests, and these decide. A test leaves out only what it cannot reach, so the selectors only ever add a test to the run.
type TestReach = {
readonly library: LibraryName;
/** The path from the repository's root. */
readonly path: strin…(683 characters)
typeTestReach= {
readonlylibrary:LibraryName;
/** The path from the repository's root. */readonlypath:string;
/** What it transitively imports: files, and folders (ending with `/`) where an import could not be resolved to a file. */readonlydepends:readonlystring[];
/** Whether it reads the checkout, so that no change can be shown not to reach it. */readonlyenvironmental:boolean;
/** The requirements it proves, as `<spec> FR-nnn`. */readonlyproves:readonlystring[];
/** What the files of its own library that it reaches import of each other library. */readonlyuses:readonly { readonlyprovider:LibraryName; readonlyusage:Usage }[];
};
A test file as the selectors read it: where it is, what it reaches, whether it reads the tree, which requirements it proves and what its library imports of other libraries through it.
The tests of a suite that a change must run: by imports, by the trace register, and the ones that read the tree; the others are left out. everything runs them all (the plan is every proof).
The tests of a consumer that a change of the symbols of a provider must run: those whose library files import one of them (or everything from the provider).
The tests of a run split by the quarantine record on a day (YYYY-MM-DD): those that run, those held back with their entry, and the entries that have expired (their tests run again).
The key of a result: the same text for the same test, the same sources it imports and the same runtime, so that a cache holds a result by it. The hashes are given: one for the test, one for each source it imports.
type TestReach = {
readonly library: LibraryName;
/** The path from the repository's root. */
readonly path: strin…(683 characters)
typeTestReach= {
readonlylibrary:LibraryName;
/** The path from the repository's root. */readonlypath:string;
/** What it transitively imports: files, and folders (ending with `/`) where an import could not be resolved to a file. */readonlydepends:readonlystring[];
/** Whether it reads the checkout, so that no change can be shown not to reach it. */readonlyenvironmental:boolean;
/** The requirements it proves, as `<spec> FR-nnn`. */readonlyproves:readonlystring[];
/** What the files of its own library that it reaches import of each other library. */readonlyuses:readonly { readonlyprovider:LibraryName; readonlyusage:Usage }[];
};
A test file as the selectors read it: where it is, what it reaches, whether it reads the tree, which requirements it proves and what its library imports of other libraries through it.
The tests of a suite that a change must run: by imports, by the trace register, and the ones that read the tree; the others are left out. everything runs them all (the plan is every proof).
The tests of a consumer that a change of the symbols of a provider must run: those whose library files import one of them (or everything from the provider).
The tests of a run split by the quarantine record on a day (YYYY-MM-DD): those that run, those held back with their entry, and the entries that have expired (their tests run again).
The key of a result: the same text for the same test, the same sources it imports and the same runtime, so that a cache holds a result by it. The hashes are given: one for the test, one for each source it imports.