APIARTy is an automated pipeline for evaluating and comparing automated program repair tools (repair tools) that can potentially detect and fix API misuses in Java programs. APIARTy currently includes MUBench, Bears, and Bugs.jar as bug benchmarks and state-of-the-art repair tools including Arja, Astor, Nopol, NPEFix, Avatar, TBar, and SimFix. APIARTy is evaluated on a new benchmark of API misuses, APIRepBench (see APIARTy/data and APIRepBench.xlsx).
This repository accompanies the paper Evaluating Automatic Program Repair Capabilities to Repair API Misuses. If you use APIARTy or APIRepBench, please cite our paper as follows:
M. Kechagia, S. Mechtaev, F. Sarro and M. Harman, "Evaluating Automatic Program Repair Capabilities to Repair API Misuses" in IEEE Transactions on Software Engineering, vol. , no. 01, pp. 1-1, 2021. doi: 10.1109/TSE.2021.3067156.
See this project's webpage in CREST/SOLAR, here.
For any questions on this project, please contact M. Kechagia or Prof. F. Sarro.
- Execution of 14 repair tools on API misuses extracted from three bug benchmarks.
- Comparison of the repair tools on their effectiveness and efficiency on repairing API misuses.
- Examination of the effect of different API-misuse categories on the capabilities of API-repair tools.
The following table shows the automated repair tools used for comparing their capabilities on detecting and fixing API misuses.
The following table lists the bug benchmarks used for creating our benchmark of API misuses, APIRepBench (found in the data folder).
# | Benchmark | Language | # Projects | # Bugs | # API Misuses | # Final Projects | Link |
---|---|---|---|---|---|---|---|
1 | Bears | Java | 72 | 251 | 19 | 10 | https://github.com/bears-bugs/bears-benchmark |
2 | Bugs.jar | Java | 8 | 1,159 | 40 | 7 | https://github.com/bugs-dot-jar/bugs-dot-jar |
3 | MUBench | Java | 68 | 280 | 42 | 12 | https://github.com/stg-tud/MUBench |
Total | 148 | 1,690 | 101 | 29 |
To deploy and use APIARTy, you need to install Docker. If you use APIARTy on a desktop, get Docker Desktop from the following link:
To build a Docker image of this repository and run it on Docker you need to follow the next instructions:
git clone https://github.com/mkechagia/APIARTy.git
cd APIARTy
docker build -t apiarty .
docker run -it -v apiarty-findings:/apiarty/findings --rm apiarty
ordocker run -it -v <absolute_path_to_store_results>:/apiarty/findings --rm apiarty
(it locally stores the results).- Also, the following command can be used for keeping locally the data (buggy projects)
docker run -it -v <absolute_path_to_store_results>:/apiarty/findings -v <absolute_path_to_store_results>:/apiarty/data --rm apiarty
.
For more information about Docker, please check the following links:
- https://docs.docker.com/develop/develop-images/dockerfile_best-practices/
- https://docs.docker.com/engine/reference/run/
data/*.json
contains the projects' meta-data required by most repair tools. Easily you can add more .json
files (i.e., projects) to detect and repair any bugs. The whole process can run on one project or on all. Just give the right commands presented in the following.
- To run an experiment on one project e.g., Bears-84, using one tool e.g., Kali, give the following command:
./apiarty Arja-Kali Bears-84
- To analyse all the projects that exist in
data
using a particular repair tool e.g., Kali, give the following command:
./apiarty Arja-Kali
- To run all tools (Arja, Astor, Nopol and NPEFix) on a project e.g., Bears-84, give the following command:
./apiarty ALL Bears-84
- To run Avatar, TBar, or SimFix, apply the guidelines included in the
guidelines.txt
as these tools strictly use Defects4J commands.
All experiments run on an Ubuntu 16.04 Linux Docker image of APIARTy deployed on a 2-core PC with 8GB RAM and 3,1 GHz Intel Core i5 processor. We used Java 1.8 (amd64) ofthe OpenJDK, allocating up to 4GB for the JVM.
This repository is structured as follows:
APIARTy
├── APIRepBench.xlsx: information on the bugs of APIRepBench, patch correctness, execution time of repair attempts
├── Dockerfile
├── README.md
├── _config.yml
├── apiarty
├── apiarty.bin
│ ├── apiarty
│ └── bashrc
├── data: Our APIRepBench benchmark of API misuses
│ └── <bug_id>.json: standard input (with project metadata)
├── findings: findings for Astor, NPEFix, recent tools (Avatar, TBar, SimFix), and remaining tools (the general structure follows)
│ └── findings
│ ├── <bug_id>
│ │ └── <repair tool>
│ │ ├── stderr.txt: stderr of the execution (with repair)
│ │ └── stdout.txt: stdout of the execution (with repair)
│ ├── <bug_id>_avatar.txt: repair log of Avatar
│ ├── <bug_id>_tbar.txt: repair log of TBar
│ ├── <bug_id>_simfix.txt: repair log of SimFix
│ ├── all-results.csv: execution time taken by the repair attempts (without those that reach the timeout)
│ └── timeout.csv: repair attempts that failed by timeout
└── guidelines
├── Avatar
│ ├── AbstractFixer.java
│ ├── Configuration.java
│ └── FLFix.sh
└── guidelines.txt: specific guidelines for running Avatar, TBar, and SimFix