write okify_regtests script, generalizing jwst and romancal versions

[zacharyburnett]

resolves SCSB-183

follow-up to spacetelescope/jwst#8762

adds the okify_regtests script to the ci_watson package, generalized between the existing jwst and romancal versions:

• https://github.com/spacetelescope/jwst/blob/ffa02661593f4c53d66ab17fa837aa72a358def6/jwst/scripts/okify_regtests.py
• https://github.com/spacetelescope/romancal/blob/9031ae12b14b22ba565581670e74b826d40ed86a/romancal/scripts/okify_regtests.py

This change would be coupled with removals of okify_regtests from both jwst and romancal:

• remove okify_regtests script (moved to ci_watson) jwst#8957
• remove okify_regtests script (moved to ci_watson) romancal#1513

Arguments

usage: okify_regtests [-h] [--dry-run] {jwst,roman} run-number

"okifies" a set of failing regression test results, by overwriting truth files on
Artifactory so that a set of failing regression test results becomes correct. Requires
JFrog CLI (https://jfrog.com/getcli/) configured with credentials (`jf login`) and write
access to the desired truth file repository (`jwst-pipeline`, `roman-pipeline`, etc.).

positional arguments:
  {jwst,roman}  Observatory to overwrite truth files for on Artifactory
  run-number    GitHub Actions job number of regression test run (see
                https://github.com/spacetelescope/RegressionTests/actions)

options:
  -h, --help    show this help message and exit
  --dry-run     do nothing (passes the `--dry-run` flag to JFrog CLI)

Usage Examples

okify_regtests jwst 956 --dry-run
okify_regtests roman 1317

[zacharyburnett]

@spacetelescope/jwst-pipeline-maintainers @spacetelescope/jwst-pipeline-developers @spacetelescope/romancal-maintainers thoughts on this consolidation?

[zacharyburnett]

added rglob from spacetelescope/jwst#8970

[WilliamJamieson]

Could you add basic documentation for this in the README or something like that?

[zacharyburnett]

@melanieclarke as you use okify_regtests for JWST, would you mind testing this script in this branch when you get a chance, and let me know if you'd like any changes to the workflow (or if you find any bugs)?

[melanieclarke]

@zacharyburnett - will do, next time I have something to okify. Thanks for working on this!

[melanieclarke]

I tested okify_regtests from this branch for jwst for diffs from spacetelescope/jwst#8847, with: okify_regtests jwst 1076

It looks like all went well - it found the two diffs I expected and copied them to the right place in artifactory.

[melanieclarke]

LGTM, for jwst.

[braingram]

Tested with romancal (see spacetelescope/romancal#1513) with no issues. Feel free to merge (I don't have permissions to merge).