Flakify: A Black-Box, Language Model-based Predictor for Flaky Tests – Replication Package
Why this work is in the frame
A frame that forgets how it found something cannot be audited. These are the routes that admitted this work.
Bibliographic record
Abstract
This is the replication package associated with the paper: <em>Flakify: A Black-Box, Language Model-based Predictor for Flaky Tests.</em> We explain how to use it to reproduce the results reported in the paper. A maintainable version of this replication package is available on GitHub (https://github.com/uOttawa-Nanda-Lab/Flakify). <strong>Flakify Test Smell Detector</strong> This is a step-by-step guideline to detect test smells in the source code of test cases and retain statements that match them. <em><strong>Requirements:</strong></em> Eclipse IDE (the version we used was 2021-12) The libraries (the <strong><em>.jar</em></strong> files in the <strong><code>lib\</code></strong> directory) <em><strong>Input Files:</strong></em> This is a list of input files that are required to accomplish this step: <em>dataset/FlakeFlagger/FlakeFlagger_filtered_dataset.csv</em> <em>dataset/FlakeFlagger/FlakeFlagger_class_files/</em> <em>dataset/IDoFT/IDoFT_filtered_dataset.csv</em> <em>dataset/IDoFT/IDoFT_class_files/</em> The <strong><code>dataset/FlakeFlagger/FlakeFlagger_filtered_dataset.csv</code></strong> and <strong><code>dataset/IDoFT/IDoFT_filtered_dataset.csv</code></strong> are used to obtain the label (<em>flaky</em>=1 or <em>non-flaky</em>=0) and project name for each test case parsed from <strong><code>dataset/FlakeFlagger/FlakeFlagger_class_files/</code></strong> and <strong><code>dataset/IDoFT/IDoFT_class_files/</code></strong>, respectively. <strong><em>Output Files:</em></strong> <em>dataset/FlakeFlagger/FlakeFlagger_dataset.csv</em> <em>dataset/FlakeFlagger/FlakeFlagger_test_cases_full_code/</em> <em>dataset/FlakeFlagger/FlakeFlagger_test_cases_preprocessed_code/</em> <em>dataset/IDoFT/IDoFT_dataset.csv</em> <em>dataset/IDoFT/IDoFT_test_cases_full_code/</em> <em>dataset/IDoFT/IDoFT_test_cases_preprocessed_code/</em> <strong>Replicating the experiment</strong> To detect test smells and retain only code statements related to them, the <strong><code>src/FlakifySmellsDetector.java</code></strong> file should be compiled and run using the Eclipse IDE by having all the <em>.jar</em> files in the classpath. The pre-generated executable Jar file <strong><code>src/FlakifySmellsDetector.jar</code></strong> can be executed using the shell script <strong><code>src/FlakifySmellsDetector.sh</code></strong> after changing paths for each dataset as needed, using the following commands: <pre><code class="language-bash">bash FlakifySmellsDetector.sh FlakeFlagger bash FlakifySmellsDetector.sh IDoFT</code></pre> It will generate the dataset required to run Flakify's flaky test prediction model for the datasets given as input. The class file containing each of the test cases is then parsed to produce the corresponding full code and pre-processed code of the test case. The full and pre-processed source code of all test cases are also combined and saved in a CSV file, along with test smells found, project names, and labels. <strong>Flakify Replication</strong> This is the guideline for replicating the experiments we used to evaluate Flakify for classifying test cases as <em>flaky</em> and <em>non-flaky</em> using both cross-validation and per-project validation. <em><strong>Requirements:</strong></em> This is a list of all required python packages: <em>python =3.8.5</em> <em>imbalanced_learn= 0.8.1</em> <em>numpy= 1.19.5</em> <em>pandas= 1.3.3</em> <em>transformer= 4.10.2</em> <em>torch=1.5.0</em> <em>scikit_learn= 0.22.1</em> <em><strong>Input Files:</strong></em> This is a list of input files that are required to accomplish this step: <em>dataset/FlakeFlagger/Flakify_FlakeFlagger_dataset.csv</em> <em>dataset/IDoFT/Flakify_IDoFT_dataset.csv</em> This file contains the full code and pre-processed code of the test cases in both FlakeFlagger and IDOFT datasets, along with their ground truth labels (<em>flaky</em> and <em>non-flaky</em>). <em><strong>Output File:</strong></em> <em>results/Flakify_cross_validation_results_on_FlakeFlagger_dataset.csv</em> <em>results/Flakify_per_project_results_on_FlakeFlagger_dataset.csv</em> <em>results/Flakify_model_trained_on_FlakeFlagger_dataset.pt</em> <em>results/Flakify_cross_validation_results_on_IDoFT_dataset.csv</em> <em>results/Flakify_per_project_results_on_IDoFT_dataset.csv</em> <em>results/Flakify_model_trained_on_IDoFT_dataset.pt</em> <strong>Replicating Flakify experiments</strong> <strong>Cross-Validation</strong> To run the Flakify experiment using cross-validation on the two datasets, navigate to <code>src\</code> folder and run the following commands: <pre><code class="language-bash">bash Flakify_predictor_cross_validation.sh FlakeFlagger bash Flakify_predictor_cross_validation.sh IDoFT</code></pre> This will generate the classification results into <strong><code>results/Flakify_cross_validation_results_on_FlakeFlagger_dataset.csv</code></strong> and <strong><code>results/Flakify_cross_validation_results_on_IDoFT_dataset.csv</code></strong> for the cross-validation experiments on both datasets. It will also save the weights of the two models trained on the FlakeFlagger and IDoFT datasets into <strong><code>results/Flakify_model_trained_on_FlakeFlagger_dataset.pt</code></strong> and <code><strong>results/Flakify_model_trained_on_IDoFT_dataset.pt</strong></code>, respectively. <strong>Per-project Validation</strong> To run the Flakify experiment using per-project validation on the two datasets, navigate to <code>src\</code> folder and run the following commands: <pre><code class="language-bash">bash Flakify_predictor_per_project.sh FlakeFlagger bash Flakify_predictor_per_project.sh IDoFT</code></pre> This will generate the classification results into <strong><code>results/Flakify_per_project_results_on_FlakeFlagger_dataset.csv</code></strong> and <strong><code>results/Flakify_per_project_results_on_IDoFT_dataset.csv</code></strong> for the whole per-project validation experiments on both datasets. <strong>FlakeFlagger Replication</strong> This is the guideline for replicating the experiments we used to evaluate the two versions of FlakeFlagger, white-box and black-box, for classifying test cases as <em>flaky</em> and <em>non-flaky</em> using cross-validation on the FlakeFlagger dataset. <em><strong>Requirements:</strong></em> This is a list of all required python packages: <em>python =3.8.5</em> <em>imbalanced_learn= 0.8.1</em> <em>pandas= 1.3.3</em> <em>scikit_learn= 0.22.1</em> <em><strong>Input File:</strong></em> This is a list of input files that are required to accomplish this step: <em>dataset/FlakeFlagger/FlakeFlagger_filtered_dataset.csv</em> <em>dataset/FlakeFlagger/FlakeFlaggerFeaturesTypes.csv</em> <em>dataset/FlakeFlagger/Information_gain_per_feature.csv</em> <em><strong>Output File:</strong></em> <em>results/FlakeFlagger_black-box_results.csv</em> <em>results/FlakeFlagger_white-box_results.csv</em> <strong>Replicating FlakeFlagger experiments</strong> To run the FlakeFlagger experiments, navigate to <code>src\</code> folder and run the following command: <pre><code class="language-bash">bash FlakeFlagger_predictor.sh white-box bash FlakeFlagger_predictor.sh black-box</code></pre> This will generate the classification results into <strong><code>results/FlakeFlagger_white-box_results.csv</code> </strong>and <strong><code>results/FlakeFlagger_black-box_results.csv</code> </strong>for both white-box and black-box experiments, respectively.
Fetched live from OpenAlex and de-inverted. Abstracts are not stored in this database: the inverted indexes are 8.6 GB of the frame’s 9.3 GB of text, and the host has 13 GB free.
Full frame distilled prediction
Teacher imitationNot calibrated prevalence, not ground truth. Human validation pending. Learned from the 10,348 direct Codex labels and 10,348 direct Gemma labels. Candidate is the union of thresholded teacher heads; consensus is their intersection. These outputs are machine_predicted_unvalidated and are not human labels or direct frontier model labels.
Codex and Gemma teacher scores by category
| Category | Codex | Gemma |
|---|---|---|
| Metaresearch | 0.001 | 0.005 |
| Meta-epidemiology (narrow) | 0.000 | 0.000 |
| Meta-epidemiology (broad) | 0.000 | 0.000 |
| Bibliometrics | 0.001 | 0.001 |
| Science and technology studies | 0.002 | 0.000 |
| Scholarly communication | 0.001 | 0.000 |
| Open science | 0.004 | 0.003 |
| Research integrity | 0.000 | 0.001 |
| Insufficient payload (model declined to judge) | 0.004 | 0.001 |
Machine scores (provisional)
The two teacher heads of the student model, read on this work. A score orders the frame for review; it never asserts a category, and the validation status ships verbatim with every row.
Baseline scores from an immature model (maturity gate not passed, 7 training rounds). Scores rank; they never assert a category.
score_only:v0-immature-baseline · verbatim from the scoring run: score_only means the number may rank works, and no category label ships from it