wait_for_tests¶

wait_for_tests is a script in CIMEROOT/scripts/Tools.
$ ./wait_for_tests --help
usage: 
wait_for_tests [<Path to TestStatus> <Path to TestStatus> ...]  [--verbose]
OR
wait_for_tests --help

[1mEXAMPLES:[0m
    [1;32m# Wait for test in current dir[0m
    > wait_for_tests
    [1;32m# Wait for test in user specified tests[0m
    > wait_for_tests path/to/testdir
    [1;32m# Wait for all tests in a test area[0m
    > wait_for_tests path/to/testarea/*/TestStatus

Wait for a queued set of E3SM tests to finish by watching the TestStatus
files. If all tests pass, 0 is returned, otherwise a non-zero error code is
returned. Note that this program waits for the RUN phase specifically and will
not terminate if the RUN phase didn't happen.

positional arguments:
  paths                 Paths to test directories or status file. Pwd default.
                        (default: .)

optional arguments:
  -h, --help            show this help message and exit
  -d, --debug           Print debug information (very verbose) to file
                        /glade/work/turuncu/APPS/ufs-mrweather-
                        app/cime/scripts/Tools/wait_for_tests.log (default:
                        False)
  -v, --verbose         Add additional context (time and file) to log messages
                        (default: False)
  -s, --silent          Print only warnings and error messages (default:
                        False)
  -n, --no-wait         Do not wait for tests to finish (default: False)
  --no-run              Do not expect run phase to be completed (default:
                        False)
  -t, --check-throughput
                        Fail if throughput check fails (fail if tests slow
                        down) (default: False)
  -m, --check-memory    Fail if memory check fails (fail if tests footprint
                        grows) (default: False)
  -i, --ignore-namelist-diffs
                        Do not fail a test if the only problem is diffing
                        namelists (default: False)
  --ignore-memleak      Do not fail a test if the only problem is a memleak
                        (default: False)
  --force-log-upload    Always upload logs to cdash, even if test passed
                        (default: False)
  -b CDASH_BUILD_NAME, --cdash-build-name CDASH_BUILD_NAME
                        Build name, implies you want results send to Cdash
                        (default: None)
  -p CDASH_PROJECT, --cdash-project CDASH_PROJECT
                        The name of the CDash project where results should be
                        uploaded (default: E3SM)
  -g CDASH_BUILD_GROUP, --cdash-build-group CDASH_BUILD_GROUP
                        The build group to be used to display results on the
                        CDash dashboard. (default: ACME_Latest)
  --timeout TIMEOUT     Timeout wait in seconds. (default: None)
  --update-success      Record test success in baselines. Only the nightly
                        process should use this in general. (default: False)