zm.prCheck

Run test suites against a pull request and post the result on it as a check.

The suites run in this engine, so the engine has to hold exactly what the request proposes: bound to the request's source world, on its source branch, at the commit the request stands at, with nothing uncommitted and no untracked path (zm stash takes uncommitted changes out of the tree; an untracked path is committed or removed). For a request from a branch of this world, zm.checkout(<source branch>) gets there; for a proposal from a fork, an engine on the fork (its author's). Anything else is refused, naming what differs.

opts.suites names the suites to run (a package's own suites, for a request that changes that package); left out, every suite the world holds runs, as tests.run() runs them. The check is failure when a test failed, success when the tests that ran all passed, and error when the run reached no verdict (a suite asked for that matched none, or every test skipped); its summary is the counts, the runner's note and the failing tests. opts.name names the check (default tests); posting the same name on the same head again replaces your earlier one.

Everyone reading the request sees the check in zm.prView and zm.prChecks, with who posted it.

zm.prCheck(nil, 1, { suites = { "door" } })

In the shell: zm pr check [<world>] <n> [--suite <name>]... [--name <check>].