blob: 13e3904b68a9d2932615dc8c157701aced75b66f [file] [log] [blame]
# Copyright 2019, The Android Open Source Project
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
# http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
"""
Atest test event handler class.
"""
from __future__ import print_function
from collections import deque
from datetime import timedelta
import logging
from test_runners import test_runner_base
EVENT_NAMES = {'module_started': 'TEST_MODULE_STARTED',
'module_ended': 'TEST_MODULE_ENDED',
'run_started': 'TEST_RUN_STARTED',
'run_ended': 'TEST_RUN_ENDED',
# Next three are test-level events
'test_started': 'TEST_STARTED',
'test_failed': 'TEST_FAILED',
'test_ended': 'TEST_ENDED',
# Last two failures are runner-level, not test-level.
# Invocation failure is broader than run failure.
'run_failed': 'TEST_RUN_FAILED',
'invocation_failed': 'INVOCATION_FAILED',
'test_ignored': 'TEST_IGNORED',
'log_association':'LOG_ASSOCIATION'}
EVENT_PAIRS = {EVENT_NAMES['module_started']: EVENT_NAMES['module_ended'],
EVENT_NAMES['run_started']: EVENT_NAMES['run_ended'],
EVENT_NAMES['test_started']: EVENT_NAMES['test_ended']}
START_EVENTS = list(EVENT_PAIRS.keys())
END_EVENTS = list(EVENT_PAIRS.values())
TEST_NAME_TEMPLATE = '%s#%s'
EVENTS_NOT_BALANCED = ('Error: Saw %s Start event and %s End event. These '
'should be equal!')
# time in millisecond.
ONE_SECOND = 1000
ONE_MINUTE = 60000
ONE_HOUR = 3600000
CONNECTION_STATE = {
'current_test': None,
'last_failed': None,
'last_ignored': None,
'current_group': None,
'current_group_total': None,
'test_count': 0,
'test_start_time': None}
class EventHandleError(Exception):
"""Raised when handle event error."""
class EventHandler(object):
"""Test Event handle class."""
event_stack = deque()
def __init__(self, reporter, name):
self.reporter = reporter
self.runner_name = name
self.state = CONNECTION_STATE.copy()
def _module_started(self, event_data):
self.state['current_group'] = event_data['moduleName']
self.state['last_failed'] = None
self.state['current_test'] = None
def _run_started(self, event_data):
# Technically there can be more than one run per module.
self.state['current_group_total'] = event_data['testCount']
self.state['test_count'] = 0
self.state['last_failed'] = None
self.state['current_test'] = None
def _test_started(self, event_data):
name = TEST_NAME_TEMPLATE % (event_data['className'],
event_data['testName'])
self.state['current_test'] = name
self.state['test_count'] += 1
self.state['test_start_time'] = event_data['start_time']
def _test_failed(self, event_data):
self.state['last_failed'] = {'name': TEST_NAME_TEMPLATE % (
event_data['className'],
event_data['testName']),
'trace': event_data['trace']}
def _test_ignored(self, event_data):
name = TEST_NAME_TEMPLATE % (event_data['className'],
event_data['testName'])
self.state['last_ignored'] = name
def _run_failed(self, event_data):
# Module and Test Run probably started, but failure occurred.
self.reporter.process_test_result(test_runner_base.TestResult(
runner_name=self.runner_name,
group_name=self.state['current_group'],
test_name=self.state['current_test'],
status=test_runner_base.ERROR_STATUS,
details=event_data['reason'],
test_count=self.state['test_count'],
test_time='',
runner_total=None,
group_total=self.state['current_group_total']))
def _invocation_failed(self, event_data):
# Broadest possible failure. May not even start the module/test run.
self.reporter.process_test_result(test_runner_base.TestResult(
runner_name=self.runner_name,
group_name=self.state['current_group'],
test_name=self.state['current_test'],
status=test_runner_base.ERROR_STATUS,
details=event_data['cause'],
test_count=self.state['test_count'],
test_time='',
runner_total=None,
group_total=self.state['current_group_total']))
def _run_ended(self, event_data):
pass
def _module_ended(self, event_data):
pass
def _test_ended(self, event_data):
name = TEST_NAME_TEMPLATE % (event_data['className'],
event_data['testName'])
test_time = ''
if self.state['test_start_time']:
test_time = self._calc_duration(event_data['end_time'] -
self.state['test_start_time'])
if self.state['last_failed'] and name == self.state['last_failed']['name']:
status = test_runner_base.FAILED_STATUS
trace = self.state['last_failed']['trace']
self.state['last_failed'] = None
elif self.state['last_ignored'] and name == self.state['last_ignored']:
status = test_runner_base.IGNORED_STATUS
self.state['last_ignored'] = None
trace = None
else:
status = test_runner_base.PASSED_STATUS
trace = None
self.reporter.process_test_result(test_runner_base.TestResult(
runner_name=self.runner_name,
group_name=self.state['current_group'],
test_name=name,
status=status,
details=trace,
test_count=self.state['test_count'],
test_time=test_time,
runner_total=None,
group_total=self.state['current_group_total']))
def _log_association(self, event_data):
pass
switch_handler = {EVENT_NAMES['module_started']: _module_started,
EVENT_NAMES['run_started']: _run_started,
EVENT_NAMES['test_started']: _test_started,
EVENT_NAMES['test_failed']: _test_failed,
EVENT_NAMES['test_ignored']: _test_ignored,
EVENT_NAMES['run_failed']: _run_failed,
EVENT_NAMES['invocation_failed']: _invocation_failed,
EVENT_NAMES['test_ended']: _test_ended,
EVENT_NAMES['run_ended']: _run_ended,
EVENT_NAMES['module_ended']: _module_ended,
EVENT_NAMES['log_association']: _log_association}
def process_event(self, event_name, event_data):
"""Process the events of the test run and call reporter with results.
Args:
event_name: A string of the event name.
event_data: A dict of event data.
"""
logging.debug('Processing %s %s', event_name, event_data)
if event_name in START_EVENTS:
self.event_stack.append(event_name)
elif event_name in END_EVENTS:
self._check_events_are_balanced(event_name, self.reporter)
if self.switch_handler.has_key(event_name):
self.switch_handler[event_name](self, event_data)
else:
logging.warning('Event[%s]: %s is not processable.', event_name, event_data)
def _check_events_are_balanced(self, event_name, reporter):
"""Check Start events and End events. They should be balanced.
If they are not balanced, print the error message in
state['last_failed'], then raise TradeFedExitError.
Args:
event_name: A string of the event name.
reporter: A ResultReporter instance.
Raises:
TradeFedExitError if we doesn't have a balance of START/END events.
"""
start_event = self.event_stack.pop() if self.event_stack else None
if not start_event or EVENT_PAIRS[start_event] != event_name:
# Here bubble up the failed trace in the situation having
# TEST_FAILED but never receiving TEST_ENDED.
if self.state['last_failed'] and (start_event ==
EVENT_NAMES['test_started']):
reporter.process_test_result(test_runner_base.TestResult(
runner_name=self.runner_name,
group_name=self.state['current_group'],
test_name=self.state['last_failed']['name'],
status=test_runner_base.FAILED_STATUS,
details=self.state['last_failed']['trace'],
test_count=self.state['test_count'],
test_time='',
runner_total=None,
group_total=self.state['current_group_total']))
raise EventHandleError(EVENTS_NOT_BALANCED % (start_event,
event_name))
@staticmethod
def _calc_duration(duration):
"""Convert duration from ms to 3h2m43.034s.
Args:
duration: millisecond
Returns:
string in h:m:s, m:s, s or millis, depends on the duration.
"""
delta = timedelta(milliseconds=duration)
timestamp = str(delta).split(':') # hh:mm:microsec
if duration < ONE_SECOND:
return "({}ms)".format(duration)
elif duration < ONE_MINUTE:
return "({:.3f}s)".format(float(timestamp[2]))
elif duration < ONE_HOUR:
return "({0}m{1:.3f}s)".format(timestamp[1], float(timestamp[2]))
return "({0}h{1}m{2:.3f}s)".format(timestamp[0],
timestamp[1], float(timestamp[2]))