Artifact - Roseau: Fast, Accurate, Source-based Breaking Change Analysis in Java

This artifact contains the source code, data, and scripts supporting our paper available at: https://hal.science/hal-05176866

Running the artifact and reproducing the results

The artifact and results can be reproduced either manually or using a dedicated Docker image. We refer the reader to the file README.md for detailed instructions.

Organization

This repository is organized as follows. When needed, subdirectories contain specific instructions (in README.md) for running the different tools and scripts.



roseau: This directory contains the source code of Roseau as well as intructions to compile it and execute its test suite. First, compile and install Roseau locally with mvn clean install -DskipTests.

accuracy-dataset: This directory contains our refined and extend version of Jezek and Dietrich's benchmark as described in Section V-A

libraries-dataset: This directory contains the scripts we used to collect popular Java libraries from Maven Central in Section V-B

results: This directory contains the pre-computed accuracy, performance, and longitudinal results together with Jupyter notebooks presenting the numbers and plots we use in the paper

benchmark: This directory contains the analysis pipeline that we use in Section V, including:



Running Roseau, Japicmp, and Revapi on the improved accuracy dataset and collecting their accuracy (Section V-A)

Running the JMH benchmarks to measure their runtime performance (Section V-B)

Running the preliminary experiments and the full historical analysis of Guava, h2database, and commons-lang (Section V-C)