README

一个从（PHPUnit）JUnit/Clover测试结果创建和提交Bitbucket Code Insights报告的工具。

安装

使用Composer安装是最简单的方法：Composer

composer require uuf6429/bitbucket-reporter

注意：通常这个应用程序只在开发/测试期间需要，所以建议您使用带有--dev的上一条Composer命令运行。

或者，您还可以直接从Bitbucket下载bitbucket-reporter.phar。为了方便，您可以删除'.phar'扩展名，将文件移动到$PATH的bin目录（例如/usr/local/bin）并使其可执行（chmod +x）。

用法

这个工具是从命令行运行的。默认情况下，不需要配置，但这假设了特定的设置（已启用覆盖率，JUnit/Clover测试结果文件在Bitbucket识别的路径中）。工具如何从命令行运行取决于它的安装方式

1. Composer：composer bitbucket-reporter
2. 项目中的PHAR：php bitbucket-reporter.phar
3. Bin/$PATH中的PHAR：bitbucket-reporter

以下示例假设选择了第2个选项。

该工具提供了两个命令和一些可选的选项/参数

• prepare：删除现有报告并添加新的处于待处理状态的报告
  • --no-coverage：避免在待处理状态中创建覆盖率报告
• submit：根据JUnit和Clover文件生成和提交新的报告
  • --no-coverage：缺失覆盖率文件不会导致失败，也避免创建覆盖率报告

常见问题解答

我在哪里设置仓库名称、认证令牌等？

这个工具使用由Bitbucket（和Bitbucket认证代理）定义的环境变量，但您可以从命令行覆盖这些变量。

为什么测试结果必须放在Bitbucket已知路径中？

这样做可以让Bitbucket在其自己的界面中显示测试结果，因此这是默认的期望行为。您始终可以从命令行覆盖路径。

这个工具在Bitbucket Server / Enterprise / ...上工作吗？

不知道。这个工具是为Bitbucket Cloud设计的。如果您知道如何为这些做，请随时联系。

为什么所有代码都是自定义的（例如，控制台、日志...）？

这个工具的目的将保持非常简单和直接，因此使用功能齐全的第三方库只会增加冗余和依赖冲突的风险。