测试报告自动生成与可视化实战

#!/usr/bin/env python3# -*- coding: utf-8 -*-"""测试报告自动生成演示: 收集 -> 聚合 -> 指标计算 -> 基线对比 -> HTML 报告"""from collections import Counterfrom statistics import mean PASS, FAIL, ERROR = 'PASS', 'FAIL', 'ERROR' # (用例名, 状态, 耗时秒, 失败原因)RAW_RESULTS = [    ('login', PASS, 1.2, ''), ('register', PASS, 2.1, ''),    ('search', FAIL, 3.0, '网络超时'), ('payment', PASS, 1.8, ''),    ('logout', ERROR, 5.2, '断言失败'), ('upload', FAIL, 4.1, '服务器500'),    ('download', PASS, 1.9, ''), ('checkout', PASS, 0.9, ''),] * 3  # 8 条 x 3 轮 = 24 条用例  class TestReporter:    """把散落的测试结果加工成可视化报告的主厨"""     def __init__(self, results, baseline=None):        self.results = results        self.baseline = baseline  # 昨日基线快照: {'total': 20, 'passed': 17}     def aggregate(self):        """聚合工序: 按状态归类, 失败原因分类, 耗时统计"""        status = Counter(r[1] for r in self.results)        fail_cat = Counter(r[3] for r in self.results if r[1] != PASS)        times = [r[2] for r in self.results]        return {            'total': len(self.results),            'passed': status[PASS],            'failed': status[FAIL] + status[ERROR],            'fail_cat': dict(fail_cat),            'avg_time': mean(times),        }     def pass_rate(self):        """通过率 = 通过数 / 总数 x 100%"""        a = self.aggregate()        return round(a['passed'] / a['total'] * 100, 2)     def delta_vs_baseline(self, rate):        """环比变化率 = (当前 - 基线) / 基线 x 100%"""        if not self.baseline:            return None        base = self.baseline['passed'] / self.baseline['total'] * 100        return round((rate - base) / base * 100, 2)     @staticmethod    def _bar(passed, failed):        """无外部依赖的字符条形图"""        total = passed + failed or 1        pw = round(passed / total * 20)        ok = '<div class="ok">' + '█' * pw + ' 通过 ' + str(passed) + '</div>'        fail = '<div class="fail">' + '█' * (20 - pw) + ' 失败 ' + str(failed) + '</div>'        return ok + fail     def render_html(self, title='测试报告'):        """模板渲染: 把聚合数据填入 HTML 模板产出可视化页面"""        a = self.aggregate()        rate = self.pass_rate()        delta = self.delta_vs_baseline(rate)        delta_html = ('%+.2f%%' % delta) if delta is not None else '无基线'        fail_rows = ''.join(            '<tr><td>%s</td><td>%s</td></tr>' % kv for kv in a['fail_cat'].items()        ) or '<tr><td colspan="2">无失败</td></tr>'        return ('<!DOCTYPE html><html><head><meta charset="utf-8">'                '<title>%s</title><style>body{font-family:sans-serif;'                'max-width:840px;margin:40px auto}.card{border:1px solid '                '#e2e8f0;border-radius:10px;padding:20px;margin:16px 0}'                '.metric{font-size:40px;color:#818CF8}.ok{color:#10B981}'                '.fail{color:#F43F5E}table{width:100%%;border-collapse:'                'collapse}td{border:1px solid #e2e8f0;padding:8px}'                '</style></head><body><h1>%s</h1>'                '<div class="card">通过率 <span class="metric">%.2f%%</span>'                '<br>平均耗时 %.2fs | 基线环比 %s</div>'                '<div class="card">%s</div>'                '<div class="card"><h3>失败原因归类</h3><table>%s</table>'                '</div></body></html>') % (                    title, title, rate, a['avg_time'], delta_html,                    self._bar(a['passed'], a['failed']), fail_rows)     def save(self, path='report.html'):        """产物归档: 渲染结果写盘, 返回文件路径"""        with open(path, 'w', encoding='utf-8') as f:            f.write(self.render_html())        return path  def main():    baseline = {'total': 20, 'passed': 17}  # 昨日基线通过率 85%    rep = TestReporter(RAW_RESULTS, baseline)    rate = rep.pass_rate()    delta = rep.delta_vs_baseline(rate)    print('聚合结果:', rep.aggregate())    print('通过率: %.2f%%' % rate, '| 相对基线: %+.2f%%' % delta)    print('HTML 报告已生成:', rep.save())    print('报告大小:', len(rep.render_html()), '字符')  if __name__ == '__main__':    main()