client/bin/harness.py

   1 """The harness interface
   2
   3 The interface between the client and the server when hosted.
   4 """
   5
   6 __author__ = """Copyright Andy Whitcroft 2006"""
   7
   8 import os, sys, logging
   9 import common
  10
  11 class harness(object):
  12     """The NULL server harness
  13
  14     Properties:
  15             job
  16                     The job object for this job
  17     """
  18
  19     def __init__(self, job):
  20         """
  21                 job
  22                         The job object for this job
  23         """
  24         self.setup(job)
  25
  26
  27     def setup(self, job):
  28         """
  29                 job
  30                         The job object for this job
  31         """
  32         self.job = job
  33
  34         configd = os.path.join(os.environ['AUTODIR'], 'configs')
  35         if os.path.isdir(configd):
  36             (name, dirs, files) = os.walk(configd).next()
  37             job.config_set('kernel.default_config_set',
  38                            [ configd + '/' ] + files)
  39
  40
  41     def run_start(self):
  42         """A run within this job is starting"""
  43         pass
  44
  45
  46     def run_pause(self):
  47         """A run within this job is completing (expect continue)"""
  48         pass
  49
  50
  51     def run_reboot(self):
  52         """A run within this job is performing a reboot
  53            (expect continue following reboot)
  54         """
  55         pass
  56
  57
  58     def run_abort(self):
  59         """A run within this job is aborting. It all went wrong"""
  60         pass
  61
  62
  63     def run_complete(self):
  64         """A run within this job is completing (all done)"""
  65         pass
  66
  67
  68     def run_test_complete(self):
  69         """A test run by this job is complete. Note that if multiple
  70         tests are run in parallel, this will only be called when all
  71         of the parallel runs complete."""
  72         pass
  73
  74
  75     def test_status(self, status, tag):
  76         """A test within this job is completing"""
  77         pass
  78
  79
  80     def test_status_detail(self, code, subdir, operation, status, tag,
  81                            optional_fields):
  82         """A test within this job is completing (detail)"""
  83         pass
  84
  85
  86 def select(which, job, harness_args):
  87     if not which:
  88         which = 'standalone'
  89
  90     logging.debug('Selected harness: %s' % which)
  91
  92     harness_name = 'harness_%s' % which
  93     harness_module = common.setup_modules.import_module(harness_name,
  94                                                         'autotest_lib.client.bin')
  95     harness_instance = getattr(harness_module, harness_name)(job, harness_args)
  96
  97     return harness_instance