# # 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, symbol_sets, build_dir, rtdir, bsp): self.symbol_sets = symbol_sets 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: 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: 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') return self.ssets except: raise error.general('Symbol set parsing failed') def write_ini(self, symbol_set): config = configparser.ConfigParser() try: sset = symbol_set config.add_section('symbol-sets') config.set('symbol-sets', 'sets', sset) config.add_section(sset) config.set(sset, 'libraries', self.symbol_sets[sset]) with open(self.symbol_select_file, 'w') as conf: config.write(conf) except: raise error.general('symbol parser write failed') 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) symbol_sets = parser.parse() for sset in symbol_sets: parser.write_ini(sset) covoar_runner = covoar(self.test_dir, self.symbol_select_path, self.executables, self.explanations_txt, self.trace) covoar_runner.run(sset, self.symbol_select_path) self._generate_reports(symbol_sets); self._summarize(); finally: self._cleanup(); def _generate_reports(self, symbol_sets): log.notice('Coverage generating reports') if self.report_format == 'html': report = report_gen_html(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))