rpkamp / fancy-testdox-printer
PHPUnit的华丽测试输出器
Requires
- phpunit/phpunit: ^6.0
Requires (Dev)
README
Fancy Testdox Printer 
PHPUnit的华丽测试输出器。输出与PHPUnit的--testdox
输出类似,但
- 测试通过颜色1符号更清楚地标记为失败/通过
- 失败/错误等将在测试运行结束时显示,而不是在测试运行结束时,以便获得更清晰和及时的反馈
PHPUnit兼容性
主要版本 | 支持 |
---|---|
PHPUnit 5 | 不受支持 |
PHPUnit 6 | 支持至2019年2月 |
PHPUnit 7+ | N/A,使用内置的--testdox 选项 |
此打印器仅与PHPUnit 6兼容。PHPUnit 5支持已结束,因此不会在此包中添加对它的支持。
在PHPUnit 7中,默认的测试输出器已被替换为此打印器。因此,此包没有支持PHPUnit 7的版本,将来也不会有,因为它不是必需的。要在PHPUnit 7中获得相同的输出,请运行phpunit --testdox
。如果您还想查看每个测试的用时,请运行phpunit --testdox -v
。
在PHPUnit 6的支持期(截止到2019年2月)内,此打印器也将得到支持,但在此之后将被弃用。
图例
符号 | 颜色 | 含义 |
---|---|---|
✔ | 绿色 | 测试通过 |
✘ | 红色 | 断言失败 |
✘ | 黄色 | PHPUnit错误或警告 |
∅ | 黄色 | 不完整的测试 |
☢ | 黄色 | 风险测试 |
→ | 黄色 | 跳过的测试 |
当少于70%的测试失败时,将在输出末尾显示错误摘要。70%是一个猜测,未来可能会改变,但它似乎是一个很好的截止点,因为输出中已经有很多噪音,不需要更多的噪音。(在版本0.2.0中引入)
安装
在命令行中运行
composer require rpkamp/fancy-testdox-printer --dev
将此包作为开发依赖项安装
使用方法
要使用此打印器,您可以为PHPUnit传递命令行参数或编辑phpunit.xml
命令行
在命令行中运行
vendor/bin/phpunit --printer "rpkamp\FancyTestdoxPrinter"
phpunit.xml
在phpunit.xml
中,将printerClass="rpkamp\FancyTestdoxPrinter"
添加到phpunit
标签中(请参阅phpunit.xml
以获取示例)。
示例输出
使用本项目作为打印机进行测试套件的输出如下
(运行 vendor/bin/phpunit
获取此输出)
可能包含失败、错误等的输出如下
(运行 vendor/bin/phpunit --configuration phpunit.example.xml -v
获取此输出)
请注意,如果没有使用 -v
选项,则风险、不完整和跳过的测试不会打印额外信息
1 如果您的终端支持此功能,并且在PHPUnit中已启用