| """The harness interface |
| |
| The interface between the client and the server when hosted. |
| """ |
| |
| # pylint: disable=missing-docstring |
| |
| __author__ = """Copyright Andy Whitcroft 2006""" |
| |
| import logging |
| |
| import common |
| |
| |
| class harness(object): |
| """The NULL server harness |
| |
| Properties: |
| job |
| The job object for this job |
| """ |
| |
| def __init__(self, job): |
| """ |
| job |
| The job object for this job |
| """ |
| self.setup(job) |
| |
| |
| def setup(self, job): |
| """ |
| job |
| The job object for this job |
| """ |
| self.job = job |
| |
| |
| def run_start(self): |
| """A run within this job is starting""" |
| pass |
| |
| |
| def run_pause(self): |
| """A run within this job is completing (expect continue)""" |
| pass |
| |
| |
| def run_reboot(self): |
| """A run within this job is performing a reboot |
| (expect continue following reboot) |
| """ |
| pass |
| |
| |
| def run_abort(self): |
| """A run within this job is aborting. It all went wrong""" |
| pass |
| |
| |
| def run_complete(self): |
| """A run within this job is completing (all done)""" |
| pass |
| |
| |
| def run_test_complete(self): |
| """A test run by this job is complete. Note that if multiple |
| tests are run in parallel, this will only be called when all |
| of the parallel runs complete.""" |
| pass |
| |
| |
| def test_status(self, status, tag): |
| """A test within this job is completing""" |
| pass |
| |
| |
| def test_status_detail(self, code, subdir, operation, status, tag, |
| optional_fields): |
| """A test within this job is completing (detail)""" |
| pass |
| |
| |
| def select(which, job, harness_args): |
| if not which: |
| which = 'standalone' |
| |
| logging.debug('Selected harness: %s', which) |
| |
| harness_name = 'harness_%s' % which |
| harness_module = common.setup_modules.import_module(harness_name, |
| 'autotest_lib.client.bin') |
| harness_instance = getattr(harness_module, harness_name)(job, harness_args) |
| |
| return harness_instance |
