Reverse Engineering Tool

A simplified and accessible alternative to Enterprise Architect for generating UML diagrams from student code.

This project provides an intuitive tool designed to support both instructional review and student learning at MSOE. It streamlines the workflow for faculty and students by making UML diagram generation from Java code straightforward and efficient.

Table of Contents

• Releases
• Key Technologies
• Getting Started
• Usage
• Examples
• Project Team

Releases

This project has automated releases. A release is triggered on a successful commit to the main branch. You may find the latest releases here.

Each automated release provides downloads to the following artifacts:

• reveng_cli.jar: Fat JAR containing the Reverse Engineering CLI Tool
• reveng_desktop_app.jar: Fat JAR containing the Reverse Engineering Tool desktop app.
• reveng_intellij_plugin.zip: ZIP archive containing the IntelliJ IDEA plugin for the Reverse Engineering Tool plugin.
• reveng_desktop_app.msi: MSI installer for the Reverse Engineering Tool desktop app.

NOTE: If you are using a non-Windows system, ensure that Graphviz is installed because it is a required dependency for all release artifacts.

Key Technologies

• Java 21 - Primary programming language
• Gradle 8.14 - Build automation and dependency management
• ANTLR 4.13.1 - Parser generation for code analysis
• PlantUML 1.2024.6 - UML diagram generation from textual descriptions

Getting Started

Prerequisites

Verify that Java 21 is installed on your system and that the JAVA_HOME environment variable points to it, or that its directory is included in your system PATH

Building the Project

Core Module Build Instructions

Run the following command to build the Core module:

./gradlew modules:core:build

This will build a Fat JAR, located in modules/core/build/libs/.

Run the JAR using:

java -jar modules/core/build/libs/reveng-cli.jar

Desktop App Module Build Instructions

Run the following command to build the Desktop App module:

./gradlew modules:desktop-app:build

This will build a Fat JAR, located in modules/desktop-app/build/libs/.

Run the JAR using:

java -jar modules/desktop-app/build/libs/reveng-desktop.jar

IntelliJ Plugin Module Build Instructions

Run the following command to build the IntelliJ Plugin module:

./gradlew modules:intellij-plugin:buildPlugin

This will create a zip distributable, located in modules/intellij-plugin/build/distributions/.

Install the plugin in IntelliJ:

1. Navigate to Settings >> Plugins >> ⚙ (next to Installed) >> Install Plugin from Disk
2. Select the generated zip.

Test Instructions

We added comprehensive JUnit tests for:

• JavaCodeParserTest — Validates parsing logic for .java files, malformed input handling, and extension checks.
• JavaCodeStructureVisitorTest — Tests the visitor’s ability to detect Java constructs and handle invalid syntax.
• AbstractCodeParserTest — Ensures the abstract parser correctly initializes and manages parsing processes.

To run the unit tests, execute the following command:

./gradlew :modules:core:test

Test Resources

All sample Java files used for testing are located in the src/test/resources directory.

Outcome

All parser-related tests passed successfully, confirming that:

• Parsing behavior is correct and consistent.
• The system handles malformed input safely.
• Directory parsing and invalid input scenarios are managed appropriately.

Running Tests

Testing documentation coming soon.

Running the IntelliJ Plugin

You can run the plugin in a sandbox IntelliJ IDE using any of these methods:

Method 1: From Gradle Tool Window

1. Navigate to View → Tool Windows → Gradle
2. Expand: reveng → Tasks → intellij platform → runIde
3. Double-click runIde

Method 2: From Terminal

./gradlew runIde

For comprehensive plugin documentation, see docs/RUNNING_THE_PLUGIN.md.

Usage

Command Syntax

reveng <input.java> <output1> [output2...] [outputLocation] [--print]

Parameters

Examples

Generate a PlantUML file

reveng TestClass.java TestDiagram.puml

Generate a PNG diagram

reveng TestClass.java TestDiagram.png

Generate multiple outputs with console output

reveng TestClass.java TestDiagram.puml TestDiagram.png ./output --print

This command generates both PlantUML and PNG files in the ./output folder and prints class details to the console.

Project Team

Product Owner

Jonathon Flynn, Ph.D.
Professor at MSOE
flynn@moe.edu

Fall 2025 Development Team

Important Notes

• Input Java file must contain exactly one public class
• Output folders are created automatically if they don’t exist
• Without the --print flag, only file creation confirmations are displayed

License

License information coming soon.