#
# RTEMS Tools Project (http://www.rtems.org/)
# Copyright 2014 Krzysztof Miesowicz (krzysztof.miesowicz@gmail.com)
# All rights reserved.
#
# This file is part of the RTEMS Tools package in 'rtems-tools'.
#
# Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions are met:
#
# 1. Redistributions of source code must retain the above copyright notice,
# this list of conditions and the following disclaimer.
#
# 2. Redistributions in binary form must reproduce the above copyright notice,
# this list of conditions and the following disclaimer in the documentation
# and/or other materials provided with the distribution.
#
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 'AS IS'
# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
# POSSIBILITY OF SUCH DAMAGE.
#
from __future__ import print_function
import datetime
import shutil
import os
import sys
try:
import configparser
except:
import ConfigParser as configparser
from rtemstoolkit import error
from rtemstoolkit import path
from rtemstoolkit import log
from rtemstoolkit import execute
from rtemstoolkit import macros
from . import options
class summary:
def __init__(self, p_summary_dir):
self.summary_file_path = path.join(p_summary_dir, 'summary.txt')
self.index_file_path = path.join(p_summary_dir, 'index.html')
self.bytes_analyzed = 0
self.bytes_not_executed = 0
self.percentage_executed = 0.0
self.percentage_not_executed = 100.0
self.ranges_uncovered = 0
self.branches_uncovered = 0
self.branches_total = 0
self.branches_always_taken = 0
self.branches_never_taken = 0
self.percentage_branches_covered = 0.0
self.is_failure = False
def parse(self):
if not path.exists(self.summary_file_path):
log.output('coverage: summary file %s does not exist!' % (self.summary_file_path))
self.is_failure = True
with open(self.summary_file_path, 'r') as summary_file:
self.bytes_analyzed = self._get_next_with_colon(summary_file)
self.bytes_not_executed = self._get_next_with_colon(summary_file)
self.percentage_executed = self._get_next_with_colon(summary_file)
self.percentage_not_executed = self._get_next_with_colon(summary_file)
self.ranges_uncovered = self._get_next_with_colon(summary_file)
self.branches_total = self._get_next_with_colon(summary_file)
self.branches_uncovered = self._get_next_with_colon(summary_file)
self.branches_always_taken = self._get_next_without_colon(summary_file)
self.branches_never_taken = self._get_next_without_colon(summary_file)
if len(self.branches_uncovered) > 0 and len(self.branches_total) > 0:
self.percentage_branches_covered = \
1.0 - (float(self.branches_uncovered) / float(self.branches_total))
else:
self.percentage_branches_covered = 0.0
return
def _get_next_with_colon(self, summary_file):
line = summary_file.readline()
if ':' in line:
return line.split(':')[1].strip()
else:
return ''
def _get_next_without_colon(self, summary_file):
line = summary_file.readline()
return line.strip().split(' ')[0]
class report_gen_html:
def __init__(self, p_symbol_sets_list, build_dir, rtdir, bsp):
self.symbol_sets_list = ['score']
self.build_dir = build_dir
self.partial_reports_files = list(['index.html', 'summary.txt'])
self.number_of_columns = 1
self.covoar_src_path = path.join(rtdir, 'covoar')
self.bsp = bsp
def _find_partial_reports(self):
partial_reports = {}
for symbol_set in self.symbol_sets_list:
set_summary = summary(path.join(self.bsp + "-coverage",
symbol_set))
set_summary.parse()
partial_reports[symbol_set] = set_summary
return partial_reports
def _prepare_head_section(self):
head_section = '
' + os.linesep
head_section += ' RTEMS coverage report' + os.linesep
head_section += ' ' + os.linesep
head_section += '' + os.linesep
return head_section
def _prepare_index_content(self, partial_reports):
header = " RTEMS coverage analysis report
" + os.linesep
header += "Coverage reports by symbols sets:
" + os.linesep
table = "" + os.linesep
table += self._header_row()
for symbol_set in partial_reports:
table += self._row(symbol_set, partial_reports[symbol_set])
table += "
"
timestamp = "Analysis performed on " + datetime.datetime.now().ctime()
return "\n" + header + table + timestamp + "\n"
def _row(self, symbol_set, summary):
row = "" + os.linesep
row += "" + symbol_set + " | " + os.linesep
if summary.is_failure:
row += ' FAILURE | ' + os.linesep
else:
row += ' ' + self._link(summary.index_file_path, 'Index') \
+ ' | ' + os.linesep
row += ' ' + self._link(summary.summary_file_path, 'Summary') \
+ ' | ' + os.linesep
row += ' ' + summary.bytes_analyzed + ' | ' + os.linesep
row += ' ' + summary.bytes_not_executed + ' | ' + os.linesep
row += ' ' + summary.ranges_uncovered + ' | ' + os.linesep
row += ' ' + summary.percentage_executed + '% | ' + os.linesep
row += ' ' + summary.percentage_not_executed + '% | ' + os.linesep
row += ' | ' + os.linesep
row += ' ' + summary.branches_uncovered + ' | ' + os.linesep
row += ' ' + summary.branches_total + ' | ' + os.linesep
row += ' {:.3%} | '.format(summary.percentage_branches_covered)
spbc = 100 * summary.percentage_branches_covered
row += ' | '.format(spbc)
row += '
' + os.linesep
return row
def _header_row(self):
row = "" + os.linesep
row += " Symbols set name | " + os.linesep
row += " Index file | " + os.linesep
row += " Summary file | " + os.linesep
row += " Bytes analyzed | " + os.linesep
row += " Bytes not executed | " + os.linesep
row += " Uncovered ranges | " + os.linesep
row += " Percentage covered | " + os.linesep
row += " Percentage uncovered | " + os.linesep
row += " Instruction coverage | " + os.linesep
row += " Branches uncovered | " + os.linesep
row += " Branches total | " + os.linesep
row += " Branches covered percentage | " + os.linesep
row += " Branches coverage | " + os.linesep
row += "
"
self.number_of_columns = row.count('')
return row
def _link(self, address, text):
return '' + text + ''
def _create_index_file(self, head_section, content):
name = path.join(self.build_dir, self.bsp + "-report.html")
with open(name, 'w') as f:
f.write(head_section)
f.write(content)
def generate(self):
partial_reports = self._find_partial_reports()
head_section = self._prepare_head_section()
index_content = self._prepare_index_content(partial_reports)
self._create_index_file(head_section,index_content)
def add_covoar_src_path(self):
table_js_path = path.join(self.covoar_src_path, 'table.js')
covoar_css_path = path.join(self.covoar_src_path, 'covoar.css')
for symbol_set in self.symbol_sets_list:
symbol_set_dir = path.join(self.build_dir,
self.bsp + '-coverage', symbol_set)
html_files = os.listdir(symbol_set_dir)
for html_file in html_files:
html_file = path.join(symbol_set_dir, html_file)
if path.exists(html_file) and 'html' in html_file:
with open(html_file, 'r') as f:
file_data = f.read()
file_data = file_data.replace('table.js', table_js_path)
file_data = file_data.replace('covoar.css',
covoar_css_path)
with open(html_file, 'w') as f:
f.write(file_data)
class build_path_generator(object):
'''
Generates the build path from the path to executables
'''
def __init__(self, executables, target):
self.executables = executables
self.target = target
def run(self):
build_path = '/'
path_ = self.executables[0].split('/')
for p in path_:
if p == self.target:
break
else:
build_path = path.join(build_path, p)
return build_path
class symbol_parser(object):
'''
Parse the symbol sets ini and create custom ini file for covoar
'''
def __init__(self,
symbol_config_path,
symbol_select_path,
symbol_set,
build_dir):
self.symbol_select_file = symbol_select_path
self.symbol_file = symbol_config_path
self.build_dir = build_dir
self.symbol_sets = {}
self.symbol_set = symbol_set
self.ssets = []
def parse(self):
config = configparser.ConfigParser()
try:
config.read(self.symbol_file)
if self.symbol_set is not None:
self.ssets = self.symbol_set.split(',')
else:
self.ssets = config.get('symbol-sets', 'sets').split(',')
self.ssets = [sset.encode('utf-8') for sset in self.ssets]
for sset in self.ssets:
lib = path.join(self.build_dir, config.get('libraries', sset))
self.symbol_sets[sset] = lib.encode('utf-8')
except:
raise error.general('Symbol set parsing failed')
def _write_ini(self):
config = configparser.ConfigParser()
try:
sets = ', '.join(self.symbol_sets.keys())
config.add_section('symbol-sets')
config.set('symbol-sets', 'sets', sets)
for key in self.symbol_sets.keys():
config.add_section(key)
config.set(key, 'libraries', self.symbol_sets[key])
with open(self.symbol_select_file, 'w') as conf:
config.write(conf)
except:
raise error.general('symbol parser write failed')
def run(self):
self.parse()
self._write_ini()
class covoar(object):
'''
Covoar runner
'''
def __init__(self, base_result_dir, config_dir, executables, explanations_txt, trace):
self.base_result_dir = base_result_dir
self.config_dir = config_dir
self.executables = ' '.join(executables)
self.explanations_txt = explanations_txt
self.project_name = 'RTEMS-5'
self.trace = trace
def _find_covoar(self):
covoar_exe = 'covoar'
tester_dir = path.dirname(path.abspath(sys.argv[0]))
base = path.dirname(tester_dir)
exe = path.join(base, 'bin', covoar_exe)
if path.isfile(exe):
return exe
exe = path.join(base, 'build', 'tester', 'covoar', covoar_exe)
if path.isfile(exe):
return exe
raise error.general('coverage: %s not found'% (covoar_exe))
def run(self, set_name, symbol_file):
covoar_result_dir = path.join(self.base_result_dir, set_name)
if not path.exists(covoar_result_dir):
path.mkdir(covoar_result_dir)
if not path.exists(symbol_file):
raise error.general('coverage: no symbol set file: %s'% (symbol_file))
exe = self._find_covoar()
command = exe + ' -S ' + symbol_file + \
' -O ' + covoar_result_dir + \
' -E ' + self.explanations_txt + \
' -p ' + self.project_name + ' ' + self.executables
log.notice()
log.notice('Running coverage analysis: %s (%s)' % (set_name, covoar_result_dir))
start_time = datetime.datetime.now()
executor = execute.execute(verbose = self.trace, output = self.output_handler)
exit_code = executor.shell(command, cwd=os.getcwd())
if exit_code[0] != 0:
raise error.general('coverage: covoar failure:: %d' % (exit_code[0]))
end_time = datetime.datetime.now()
log.notice('Coverage time: %s' % (str(end_time - start_time)))
def output_handler(self, text):
log.output('%s' % (text))
class coverage_run(object):
'''
Coverage analysis support for rtems-test
'''
def __init__(self, macros_, executables, symbol_set = None, trace = False):
'''
Constructor
'''
self.trace = trace
self.macros = macros_
self.build_dir = self.macros['_cwd']
self.explanations_txt = self.macros.expand(self.macros['cov_explanations'])
self.test_dir = path.join(self.build_dir, self.macros['bsp'] + '-coverage')
if not path.exists(self.test_dir):
path.mkdir(self.test_dir)
self.rtdir = path.abspath(self.macros['_rtdir'])
self.rtscripts = self.macros.expand(self.macros['_rtscripts'])
self.coverage_config_path = path.join(self.rtscripts, 'coverage')
self.symbol_config_path = path.join(self.coverage_config_path,
'symbol-sets.ini')
self.symbol_select_path = path.join(self.coverage_config_path,
self.macros['bsp'] + '-symbols.ini')
self.executables = executables
self.symbol_sets = []
self.no_clean = int(self.macros['_no_clean'])
self.report_format = self.macros['cov_report_format']
self.symbol_set = symbol_set
self.target = self.macros['target']
def run(self):
try:
if self.executables is None:
raise error.general('no test executables provided.')
build_dir = build_path_generator(self.executables, self.target).run()
parser = symbol_parser(self.symbol_config_path,
self.symbol_select_path,
self.symbol_set,
build_dir)
parser.run()
covoar_runner = covoar(self.test_dir, self.symbol_select_path,
self.executables, self.explanations_txt,
self.trace)
covoar_runner.run('score', self.symbol_select_path)
self._generate_reports();
self._summarize();
finally:
self._cleanup();
def _generate_reports(self):
log.notice('Coverage generating reports')
if self.report_format == 'html':
report = report_gen_html(self.symbol_sets,
self.build_dir,
self.rtdir,
self.macros['bsp'])
report.generate()
report.add_covoar_src_path()
def _cleanup(self):
if not self.no_clean:
if self.trace:
log.output('Coverage cleaning tempfiles')
for exe in self.executables:
trace_file = exe + '.cov'
if path.exists(trace_file):
os.remove(trace_file)
os.remove(self.symbol_select_path)
def _summarize(self):
log.notice('Coverage analysis finished: %s' % (self.build_dir))
|