|
|
|
# ASTracker
|
|
|
|
ASTracker is a Java tool that parses Arcan's output and tracks the architectural smells detected in each versionString analysed by Arcan.
|
|
|
|
|
|
|
|
# Requirements
|
|
|
|
The requirements to install and execute the application are:
|
|
|
|
|
|
|
|
* JDK 11 (or newer)
|
|
|
|
* Maven 3 (3.6.0 is the one used, but other minor versions should work fine too)
|
|
|
|
|
|
|
|
# Installation with Maven
|
|
|
|
The installation process is simple, but it requires `git` and `mvn` (Maven) to be installed on your system.
|
|
|
|
Run the following commands to download, compile and package the toolbox:
|
|
|
|
```shell script
|
|
|
|
git clone git@gitlab.seis.iti.gr:sdk4ed/atd-toolbox-new.git
|
|
|
|
cd atd-toolbox-new
|
|
|
|
mvn clean compile assembly:single -DskipTests=true
|
|
|
|
```
|
|
|
|
After executing them, a fat JAR file will be created in the `target` with the suffix "with-jar-dependencies", containing all the necessary libraries to be executed.
|
|
|
|
|
|
|
|
Alternatively, ASTracker can be executed as a web service:
|
|
|
|
```shell script
|
|
|
|
mvn spring-boot:run
|
|
|
|
```
|
|
|
|
and even built as a Docker image (ensure you have Docker installed) using:
|
|
|
|
```shell script
|
|
|
|
mvn clean compile package -DskipTest
|
|
|
|
sudo docker build --tag astracker-web:1.0 .
|
|
|
|
```
|
|
|
|
then run the Docker image using:
|
|
|
|
```shell script
|
|
|
|
sudo docker run -itp 8080:8080 astracker-web:1.0
|
|
|
|
```
|
|
|
|
**Note** that, in order for the image to be able to complete the requests you need to first [download](https://drive.google.com/file/d/1u8vYwAE9rrDosyoM33Nvg5YJuXRD_cA_/view?usp=sharing) Arcan and unzip the contents under a directory called `arcan` in the same directory as the Dockerfile. |
|
|
\ No newline at end of file |
