基于unittest框架现代风格测试报告。

特点

• 漂亮的测试报告让你更愿意编写测试。
• 支持单元、Web UI、API 各种类型的测试。
• 支持Selenium运行失败/错误自动截图。
• 支持失败重跑。
• 支持标签黑、白名单。
• 支持发邮件的功能。
• 支持多语言en、zh-CN 等。
• 支持HTML/XML不同格式的报告。

安装

• pip安装

> pip install XTestRunner

使用文档

单元测试

XTestRunner基本用法，用于生成 HTML测试报告。

测试用例

# test_unit.py
import unittest
from XTestRunner import HTMLTestRunner


class TestDemo(unittest.TestCase):
    """测试用例说明"""
    
    def test_success(self):
        """执行成功"""
        self.assertEqual(2 + 3, 5)
    
    @unittest.skip("skip case")
    def test_skip(self):
        """跳过用例"""
        pass
    
    def test_fail(self):
        """失败用例"""
        self.assertEqual(5, 6)
    
    def test_error(self):
        """错误用例"""
        self.assertEqual(a, 6)

if __name__ == '__main__':
    suit = unittest.TestSuite()
    suit.addTests([
        TestDemo("test_success"),
        TestDemo("test_skip"),
        TestDemo("test_fail"),
        TestDemo("test_error")
    ])
    
    with(open('./result.html', 'wb')) as fp:
        runner = HTMLTestRunner(
            stream=fp,
            title='<project name>test report',
            description='describe: ... ',
            language='en',
        )
        runner.run(
            testlist=suit,
            rerun=2,
            save_last_run=False
        )

HTMLTestRunner类说明

• stream: 指定报告的路径。
• title: 报告的标题。
• description: 报告的描述, 支持str、list两种类型。
• language: 支持中文zh-CN, 默认en。

run()方法说明

• testlist: 运行的测试套件。
• rerun: 重跑次数。
• save_last_run: 是否保存最后一个重跑结果。

运行测试

> python test_unit.py