Feature Request: Create a Python API for launching the OLCF Test Harness

[hagertnl]

Instead of passing around a bunch of runtests.py commands and rgt.inp files, it may be easier to create a Python API that allows users to import an API module and run, similar to the following:

from olcf_test_harness_pyapi import oth_launch

# This call blocks until an apptest has been submitted to the queue
oth_launch.launch_apptest(app="osu-microbenchmarks", test="test_startup", path="/path/to/tests/applications", mode=['start', 'stop'])

We can grow the API as needed from there, but I think this would be very helpful. Then we could possibly have Python scripts that we can create and use instead of many different rgt.inp files.

[hagertnl]

Commenting to keep track of some more API functions that would be nice:

• find_tests(path="/path/to/tests", app="appname") - find all available tests for a certain app in a directory. Possibly useful for Python scripting to make sure test names are valid

[hagertnl]

Another use case: a utility named check_available_apps.py, which would act like this:

$ check_available_apps.py --path /path/to/test/applications
App: LAMMPS
Git Branch/Commit: main/a0b1c2
Tests:
- test1
- test2
- test3
App: GROMACS
...

This would be helpful to verify --mode checkout results.