FLITSR

flitsr is an automatic fault-finding tool for programs with multiple faults. The backbone of the flitsr tool is Spectrum-Based Fault Localization, a fault-finding technology that uses a system’s test suite to help find faults. Included in the flitsr tool is the FLITSR (Fault Localization by Iterative Test Suite Reduction) algorithm, a state-of-the-art technology that allows flitsr to find multiple faults at once.

The flitsr tool integrates with test suite information from both coverage.py or GZoltar.

Quick start

To install FLITSR, simply install as a python package using the following command:

pip install flitsr

For more detailed instructions, see Installation Instructions.

For developers

flitsr is primarily a debugging tool to assist developers in finding faults in their code. If you are looking for information on using flitsr as a debugging tool, the following sections are for you:

For developers

• Base tool – flitsr
• Input types
• flitsr advanced types
• Using the flitsr API

For researchers

Included in flitsr is also the flitsr evaluation framework, which contains functionality necessary to run large-scale SBFL experiments for researchers. If you are looking on how to use the flitsr evaluation framework to run experiments, see the following sections:

For researchers

• Evaluation framework – run_all
• Merging results – merge
• Plotting figures – percent_at_n
• Transform spectra – transform

Extending flitsr

flitsr has been designed to be as versatile as possible, allowing changes and additions to almost every aspect of its functionality. The following sections provide information on what can be extended in flitsr and how:

Extending flitsr

• Creating flitsr plugins
• Extending flitsr inputs
• Extending flitsr advanced types
• Creating custom drivers