# # 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 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.build_dir, self.bsp + "-coverage", symbol_set)) set_summary.parse() partial_reports[symbol_set] = set_summary return partial_reports def _prepare_head_section(self): head_section = ''' RTEMS coverage report ''' return head_section def _prepare_index_content(self, partial_reports): header = "

RTEMS coverage analysis report

" header += "

Coverage reports by symbols sets:

" table = "" 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 = "" row += "" + symbol_set + "" if summary.is_failure: row += ' FAILURE' else: row += " " + self._link(summary.index_file_path,"Index") \ + "" row += " " + self._link(summary.summary_file_path,"Summary") \ + "" row += " " + summary.bytes_analyzed + "" row += " " + summary.bytes_not_executed + "" row += " " + summary.ranges_uncovered + "" row += " " + summary.percentage_executed + "%" row += " " + summary.percentage_not_executed + "%" row += ' ' row += " " + summary.branches_uncovered + "" row += " " + summary.branches_total + "" row += " {:.3%} ".format(summary.percentage_branches_covered) spbc = 100 * summary.percentage_branches_covered row += ' '.format(spbc) row += "\n" return row def _header_row(self): row = "" row += " Symbols set name " row += " Index file " row += " Summary file " row += " Bytes analyzed " row += " Bytes not executed " row += " Uncovered ranges " row += " Percentage covered " row += " Percentage uncovered " row += " Instruction coverage " row += " Branches uncovered " row += " Branches total " row += " Branches covered percentage " row += " Branches coverage " row += "\n" 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, coverage_arg, build_dir): self.symbol_select_file = symbol_select_path self.symbol_file = symbol_config_path self.build_dir = build_dir self.symbol_sets = {} self.cov_arg = coverage_arg self.ssets = [] def parse(self): config = configparser.ConfigParser() try: config.read(self.symbol_file) if self.cov_arg: self.ssets = self.cov_arg.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): 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' 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('symbol set file: coverage %s not created, skipping %s'% (symbol_file, set_name)) command = 'covoar -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 = True, 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, p_macros, coverage_arg, executables): ''' Constructor ''' self.macros = p_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.coverage_arg = coverage_arg 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.coverage_arg, build_dir) parser.run() covoar_runner = covoar(self.test_dir, self.symbol_select_path, self.executables, self.explanations_txt) 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: 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))