CLI command

probierz baseline accept

Accept the screens of one run as the baselines of its journey in the matrix cell the run was drawn in.

Invocation#

Shell
probierz baseline accept <APP_ID> <RUN_ID> [--screen <NAME>]

Required inputs and options#

  • <APP_ID> is the product, as probierz apps list names it.
  • <RUN_ID> is a run probierz history lists; --screen accepts one screen, every kept screen otherwise.

Output and state effects#

Copies the run's screens/<name>.png into .probierz/<app>/baselines/<journey>/<cell>/ in the product's repository and adds them to its git index together; commit them with the product. The cell is the run's target and the value its conditions hold for each axis the product's matrix profiles vary (browser, system, viewport, language), for example web@BROWSER=firefox@VIEWPORT=390x844; a byte other than a letter, digit, ., _ or - is written %XX, and the region names no cell. probierz oracle judge compares each later run's screens only with those accepted in its own cell, so another browser's rendering is never a change. The answer names the cell.

Exact refusals#

  • Each before a file is written: run-unknown (probierz.records.run, exit 1), a run of that id not recorded, naming probierz history; no-journey (exit 1), a run that carried no journey; no-screens (exit 1), a run that kept no screen, naming its artifacts directory and how a journey keeps one; no-target (exit 1), a run that names no target, so its screens belong to no cell.
  • baseline-unwritable (exit 1): a baseline that cannot be written; the files this attempt wrote are removed and nothing is added to the git index, so a run is accepted whole or not at all. Real test: tests/baseline/accept.rs.

Source snapshot#

Generated from the Rust binaries at revision 99a74945a3598a8d73b6c6cbe5aae4f283becea3 of Probierz's private source repository.

Combined help SHA-256: 77529678a61237f774b59e76df0d1907cb749ef5da56d2ed913b040793b7d30b; binary SHA-256: be9e0eaff0e6ea50403a0c6f6d467697a4eac676f9523b8dc13a596d2b5526c5.