OpenSZZ

Web Application that apply SZZ Algorithm to calculate BugInducingCommits of any project.

The web application needs as input: - Git repository URL of the project to be analysed - Jira repository URL

For example for Apache BCEL import shoud have the following Format:

Git URL = https://github.com/apache/commons-bcel.git

Jira URL = https://issues.apache.org/jira/projects/BCEL/

The output is a csv file containing for each identified BugInducingCommit the corresponding BugFixingCommit, the issueType and the involved changed file.

Pre-requisites

Docker

Docker Compose

Setup

Clone the Repository

git clone https://github.com/clowee/OpenSZZ.git

Configure .env file.

The application is scalable and the core part can be replicated in n different containers with random ports.

Here it is possible to configure the range of ports.

PORTRANGE_FROM=1000 PORTRANGE_TO=2000

DISPATCHER_PORT=8888 => Port where the Dispatcher Container is supposed to run

APP_PORT=8081 => Port where the Application Container (Frontend) is supposed to run

SERVER=http://localhost => URL where the dispatcher server it is reachable.

Configure the email address from which you want to send the confirmation email (tested with gmail accounts) EMAIL= PASS=

How to Run

Just run the following command

sudo docker-compose build

sudo docker-compose up -d --scale web=#replicates

This will build both of the docker images and will launch them in the background with the database container.

The scale option indicates how many times the container web should be replicated.

sudo docker-compose up -d --scale web=5 will create in total 5 containers web.

You can show the services down with

docker-compose down

Checking status

docker-compose ps

Updating If the Webservice or Webapp projects are updated, you need to update the submodules and rebuild the source and the docker-images. Just rerun

sudo docker-compose up --build -d --scale web=#replicates