diff --git a/README.md b/README.md index 1074d0a..829e7c9 100644 --- a/README.md +++ b/README.md @@ -1,14 +1,16 @@ # Holmes: A Causal Testing Prototype Holmes is a prototype implementation of Causal Testing, a novel testing technique that uses causal experiments to help developers debug Java programs. This repository contains the source code along with the user study setup and materials for the paper titled: -**Causal Testing: Understanding Defects' Root Causes** by Brittany Johnson, Yuriy Brun, and Alexandra Meliou, which will appear in the Proceedings of the 42nd International Conference on Software Engineering (ICSE) 2020. +**Causal Testing: Understanding Defects' Root Causes** by Brittany Johnson, Yuriy Brun, and Alexandra Meliou, published in the Proceedings of the 42nd International Conference on Software Engineering (ICSE) 2020. + +The version of Holmes described in that paper, and the artifact released with that paper, can be viewed at ## Pre-requisites -1. Install the [Eclipse IDE](https://www.eclipse.org/eclipseide/) and make sure you have at least Java 1.7 installed on your machine. -2. Install [Python](https://www.python.org/) and [Node.js](https://nodejs.org/en/). -3. Clone this repository. -4. Download [defects4j](https://github.com/rjust/defects4j) into the Holmes directory.** +1. Clone this repository, which includes the *Holmes* directory where the source code is contained. +2. Download [defects4j](https://github.com/rjust/defects4j) into the *Holmes* directory.** +3. Install the [Eclipse IDE](https://www.eclipse.org/eclipseide/) and make sure you have at least Java 1.7 installed on your machine. +4. Install [Python](https://www.python.org/) and [Node.js](https://nodejs.org/en/). ** **Note: The version of Holmes in this repo only works with projects in the Defects4J benchmark. We are currently working on an implementation that is able to run on any JUnit test within the Eclipse IDE.** diff --git a/artifact_documentation/README.md b/artifact_documentation/README.md index 1341721..3d30d2d 100644 --- a/artifact_documentation/README.md +++ b/artifact_documentation/README.md @@ -21,7 +21,7 @@ All the above listed artifacts, with the exception of the virtual machine file, *Copied from INSTALL.md* 1. Download [VirtualBox](https://www.virtualbox.org). -2. Download virtual machine file [CausalTesting_Artifact.ova](https://drive.google.com/open?id=1hyzHYCQEkOzYiLGldkBVxNvQt0Phb-th). +2. Download virtual machine file [CausalTesting_Artifact.ova](https://gmuedu-my.sharepoint.com/:u:/g/personal/johnsonb_gmu_edu/EXtV-gff48tHszUt9A55nYQBu0YIVe9SW5DDB4jBXLM8VA?e=bWzSac).
**Please note this is a large file (5BG) and may take some time to download.** 3. Open VirtualBox. 4. Go to **File > Import Appliance...**