Defects4J是可再现错误的集合和支持基础设施以推进软件工程研究为目标。

Defects4J包含来自以下开源项目的835个错误（加上29个弃用的错误）：

*由于Java8中引入的行为更改，一些错误不再可复制。因此，Defects4J区分了活动错误和不推荐使用的错误：

• 可以通过以下方式访问活动的Bug活动bugs.csv.

• 已从中删除弃用的Bug活动bugs.csv，但其元数据是保留在项目目录中。

• 弃用的错误可以通过访问已弃用-bugs.csv，这也详细说明不推荐使用错误的时间和原因。

我们不会重新计算活动错误，因为发布使用了Defects4J工件通常通过特定的bug id来引用bug。

每个bug都具有以下属性：

• 在相应的问题跟踪程序中归档的问题，以及问题跟踪程序标识符在修复提交消息中提到。
• 在一次提交中修复。
• 最小化：手动删除Defects4J维护人员提交中不相关的更改（例如重构或功能添加）。
• 通过修改源代码（与配置文件相反，文档或测试文件）。
• 存在在修复之前失败并在修复之后通过的触发测试--测试失败不是随机的，也不是依赖于测试执行顺序的。

（b）uggy和（f）ixed程序修订标记为<id>b和<id>f分别为(<标识>是一个整数）。

• Java 1.8语言
• Git>=1.9
• SVN>=1.8
• Perl>=5.0.12

缺陷4J版本1.x和0.x需要Java 1.7。

使用最新的Java 1.8版本。使用不同版本的Java可能会导致在程序版本。

缺陷4J在时区内生成并执行测试美国/洛杉矶.如果您正在使用Defects4J框架之外的bug，请将TZ公司环境变量到美国/洛杉矶并将其导出。

中列出了所有必需的Perl模块cpan文件.在许多Unix平台上，默认情况下会安装这些必需的Perl模块。如果不是这样，请参阅下面的说明以了解如何安装它们。

1. 克隆缺陷4J：

   • git克隆https://github.com/rjust/defects4j

2. 初始化Defects4J（下载项目存储库和外部库，出于大小目的和避免冗余，git存储库中未包含这些库）：如果你没有cpanm公司安装后，使用cpan或cpan包装器安装中列出的perl模块cpan文件.

   • cd缺陷4j
   • cpanm—安装程序。
   • ./init.sh文件

3. 将Defects4J的可执行文件添加到PATH：

   • export PATH=$PATH:“path2defects4j”/framework/bin（“path2defects4j”指向您克隆Defects4J的目录；它看起来像“/user/yourComputerUserName/desktop/defects4j”。）

4. 检查安装：

   • defects4j信息-p Lang

在某些平台（如Windows）上，您可能需要使用perl“完整路径”\缺陷4j这些说明说明在哪里使用缺陷4j.

1. 获取特定项目的信息（通用语言）：

   • defects4j信息-p Lang

2. 获取特定错误的信息（commons lang，bug 1）：

   • defects4j信息-p Lang-b 1

3. 签出一个有缺陷的源代码版本（commons lang，bug 1，bug版本）：

   • 缺陷4j检出-p Lang-v 1b-w/tmp/Lang_1_buggy

4. 切换到工作目录，编译源代码和测试，并运行测试：

   • cd/tmp/lang_1_buggy
   • defects4j编译
   • 缺陷4j试验

5. 一些Defects4J命令将项目id作为命令行参数（可能与其他参数一起）。示例包括信息,校验,和查询。请注意信息和查询导出的报告信息来自Defects4J元数据，不需要访问在项目的VCS中。

   其他命令需要一个工作目录，或者显式设置(-w个命令行参数）或隐式（从工作目录）。示例包括需要访问下文件的任何命令版本控制，包括源代码和构建文件。这包括所有生成或测试代码的命令(编译,测试,新闻报道,突变)和返回版本特定信息的命令(出口).

6. 中的脚本框架/测试/是如何使用Defects4J的示例，您可能会发现这些示例很有用当您使用Defects4J编写自己的脚本时，这是一种灵感。

使用框架/bin/defects4j执行以下任何命令：

使用defects4j导出-p<属性名称>[-o输出文件]在工作中导出特定于版本的属性的目录：

使用defects4j查询-p<pid>-q<field_list>[-o<output_file>][-D|-A]生成一个CSV文件，其中包含一组针对每个bug请求的元数据在特定项目中。

默认情况下，defects4j查询返回项目的活动bug ID列表。要请求特定的元数据-q个标志应提供一个以下列表中以逗号分隔的变量列表。例如，defects4j查询-p图表-q“report.id，report.url”将提供所有活动的错误ID，以及每个错误的错误报告ID和错误报告URL。

默认情况下，defects4j查询返回有关活动Bug的信息。这个【-D】标志只返回有关不推荐使用的错误的信息，而【-A】标志返回有关所有活动和已弃用错误的信息。

要确定代码的错误版本和固定版本之间更改的方法，请执行以下操作：

1. 将此行添加到用户级git属性文件中：*.java diff=java

2. 运行git diff—无index例如git diff—无index/tmp/lang_1_buggy/tmp/lag_1_fixed.在输出中，以“@”开头的每一行都给出了已更改方法的方法名。

生成的测试套件的测试执行框架(框架/料仓)提供了以下脚本：

我们欢迎您对Defects4J的贡献！小便器自述文件详细介绍了错误检测过程。

• 评估外语技巧的脚本和注释

• 用于评估APR技术的脚本和注释
• Nopol、jGenProg和jKali APR系统生成的补丁
• Defects4J v1.2.0的修复操作和模式

• “Defects4J：现有故障数据库，支持Java程序的受控测试研究”ReneéJust、Darioush Jalali和Michael D.Ernst，ISSTA 2014年[下载].

• “变异是软件测试中真实错误的有效替代品吗？”勒内·贾斯特、达里奥乌什·贾拉利、劳拉·伊诺泽姆采娃、迈克尔·D·恩斯特、里德·霍姆斯和戈登·弗雷泽，2014年FSE[下载].

• “使用基于搜索的测试生成来识别Mockito中真实故障的挑战”格雷戈里·盖伊，2016年SSBSE[下载].

• “通过基于搜索的单元测试生成检测Gson库中的实际故障”格雷戈里·盖伊，2018年SSBSE[下载].

• “缺陷4J是基于搜索的软件工程社区的挑战案例”格雷戈里·盖伊和雷内只是，2020年SSBSE[下载].

更多出版物

任何脚本或模块的文档可用作HTML文档.

Defects4J的目录结构如下：

缺陷4j||---project_repos：所提供项目的版本控制存储库。||---major：主要变异框架。||---框架：核心库和可执行文件、测试执行、，|和错误检测框架。||---bin：Defects4J的命令行界面。||---错误挖掘：错误挖掘框架。||---核心：核心框架的模块。||---lib：核心框架中使用的库。||---util：Defects4J使用的util脚本。||---项目：特定于项目的资源文件。||---test：测试框架的脚本。

Defects4J使用语义版本方案(专业.少数的.补丁):

MIT许可证，请参阅许可证.txt了解更多信息。