buglocate README

A VSCode plugin for bug localization without running code.

Features

TF-IDF based searching.

Bug Localization by deep learning.

Local training.

Release Notes

Users appreciate release notes as you update your extension.

1.0.1

Formal edition of our bug localization tool FMBL.

Install from publish

1. Install front-end plugin from VSCode extension marketplace by searching "FMBL".

   Or install from vsix.

   code --install-extension buglocate-1.0.1.vsix
   

2. Download back-end program main.exe from here.

3. Download GoogleNews-vectors-negative300.bin from here.

Install from code

1. Clone code from Gitee:

git clone https://gitee.com/lonekey/FMBL

2. create and activate conda environment

cd FMBL
conda env create -f buglocate.yaml
conda activate buglocate

3. backup FMBL, this will generate main.exe

pyinstaller -F main.py

4. Download GoogleNews-vectors-negative300.bin from here.

Configuration

In VSCode, check the "buglocate" configuration items carefully and fill in according to your project. For example:

Then, move the main.exe and GoogleNews-vectors-negative300.bin to the workpath

Demo

From project AspectJ, we explain in detail how FMBL works.

1. Download AspectJ from Github. Open it in VSCode.

git clone https://github.com/eclipse/org.aspectj

2. Make sure to fill out the configuration correctly.

3. Init FMBL, by restart or execute initialization command(press ctrl+shift+p, then enter buglocate.init).

The first initialization takes a long time, and if it completes quickly, an error may have occurred(Not properly configured or other unexpected bugs).

Tips: check the initialization process step by step.

cd workpath
.\\main.exe --doCollect
.\\main.exe --doMatch
.\\main.exe --doMakeDataset
.\\main.exe --doTrain

4. Select a piece of text in VSCode, right-click and select "buglocate"