A utility program to analyze architecture quality evolution for Java programs. It uses DesigniteJava Enterprise to analyze multiple versions of a Java project and detect architecture smells. This utility then produces evolution data (LOC and number of architecture smells in each version) and plots (architecture smell density, version-wise architecture smell distribution, and component dependency structure).

1. This utility assumes you have DesigniteJava Enterprise edition on your machine with Java 8+ installed. You may download DesigniteJava Enterprise from Designite website. Also, it is assumed that each individual commit that is being analyzed contains less than 50,000 LOC. The trial version of DesigniteJava does not export the analysis results if LOC in the analyzed version crosses this threshold. If you wish to analyze more than 50,000 LOC then consider buying DesigniteJava Enterprise license. If you are an academic researcher, you may request for a free academic license.
2. It assumes that your code is in a git repository. It copies the source code folder specified by you to a temporary location, checkout different versions of the repository and analyzes them.
3. It attempts to build your code using maven using mvn clean install -DskipTests. If you are not using maven or your build requires much more complex setup, you may change the implementation of analyze_project._build_project method. The tool requires classpath folders to analyze and resolve symbols correctly. The tool finds all the classpath folders if they are present in the provided source code folder.
4. The utility is dependent on following modules:
   • matplotlib
   • networkx
   • numpy
   • PyDriller

Specify the following parameters in main.py

• Full path of DesigniteJava
• Full path of source code folder
• Full path of temporary folder
• Full path of output folder (don't keep any other files/folders in this folder; this utility will delete all of them before generating result of the analysis)
• Number of versions to analyze

Then, run the python file using python3

python3 main.py

This utility produces following csv files.

• Smell analysis summary
• Smell distribution across analyzed versions

It also generates and stores following plots.

• Architecture smell density vs versions
• Architecture smell distribution vs versions
• Component dependency structure. It is generated for all analyzed versions but only when DesigniteJava detects a dense structure architecture smell in that version.

When analyzed Jenkins, the utility produced the output presented below.

Smell analysis summary

Smell distribution across analyzed versions

Architecture smell density vs versions

Architecture smell distribution vs versions

Component dependency structure

It shows names of 5 packages with highest degree (dependency to other packages).