Add Diagnostics Classes (#81)

Author: rcosta358

liquidjava-verifier/src/main/java/liquidjava/api/CommandLineLauncher.java

@@ -3,7 +3,8 @@
 import java.io.File;
 import java.util.Arrays;
 import java.util.List;
-import liquidjava.errors.ErrorEmitter;
+
+import liquidjava.diagnostics.ErrorEmitter;
 import liquidjava.processor.RefinementProcessor;
 import spoon.Launcher;
 import spoon.processing.ProcessingManager;

…java/liquidjava/errors/ErrorEmitter.java …liquidjava/diagnostics/ErrorEmitter.javaliquidjava-verifier/src/main/java/liquidjava/errors/ErrorEmitter.java renamed to liquidjava-verifier/src/main/java/liquidjava/diagnostics/ErrorEmitter.java liquidjava-verifier/src/main/java/liquidjava/errors/ErrorEmitter.java renamed to liquidjava-verifier/src/main/java/liquidjava/diagnostics/ErrorEmitter.java

@@ -1,4 +1,4 @@
-package liquidjava.errors;
+package liquidjava.diagnostics;
 
 import java.net.URI;
 import java.util.HashMap;

…java/liquidjava/errors/ErrorHandler.java …liquidjava/diagnostics/ErrorHandler.javaliquidjava-verifier/src/main/java/liquidjava/errors/ErrorHandler.java renamed to liquidjava-verifier/src/main/java/liquidjava/diagnostics/ErrorHandler.java liquidjava-verifier/src/main/java/liquidjava/errors/ErrorHandler.java renamed to liquidjava-verifier/src/main/java/liquidjava/diagnostics/ErrorHandler.java

@@ -1,4 +1,4 @@
-package liquidjava.errors;
+package liquidjava.diagnostics;
 
 import java.util.Formatter;
 import java.util.HashMap;

liquidjava-verifier/src/main/java/liquidjava/diagnostics/ErrorPosition.java

@@ -0,0 +1,40 @@
+package liquidjava.diagnostics;
+
+import spoon.reflect.cu.SourcePosition;
+
+public class ErrorPosition {
+
+    private int lineStart;
+    private int colStart;
+    private int lineEnd;
+    private int colEnd;
+
+    public ErrorPosition(int lineStart, int colStart, int lineEnd, int colEnd) {
+        this.lineStart = lineStart;
+        this.colStart = colStart;
+        this.lineEnd = lineEnd;
+        this.colEnd = colEnd;
+    }
+
+    public int getLineStart() {
+        return lineStart;
+    }
+
+    public int getColStart() {
+        return colStart;
+    }
+
+    public int getLineEnd() {
+        return lineEnd;
+    }
+
+    public int getColEnd() {
+        return colEnd;
+    }
+
+    public static ErrorPosition fromSpoonPosition(SourcePosition pos) {
+        if (pos == null || !pos.isValidPosition())
+            return null;
+        return new ErrorPosition(pos.getLine(), pos.getColumn(), pos.getEndLine(), pos.getEndColumn());
+    }
+}

liquidjava-verifier/src/main/java/liquidjava/diagnostics/LJDiagnostics.java

@@ -0,0 +1,93 @@
+package liquidjava.diagnostics;
+
+import java.util.ArrayList;
+import java.util.HashMap;
+
+import liquidjava.diagnostics.errors.LJError;
+import liquidjava.diagnostics.warnings.LJWarning;
+import liquidjava.processor.context.PlacementInCode;
+
+public class LJDiagnostics {
+    private static LJDiagnostics instance;
+
+    private ArrayList<LJError> errors;
+    private ArrayList<LJWarning> warnings;
+    private HashMap<String, PlacementInCode> translationMap;
+
+    private LJDiagnostics() {
+        this.errors = new ArrayList<>();
+        this.warnings = new ArrayList<>();
+        this.translationMap = new HashMap<>();
+    }
+
+    public static LJDiagnostics getInstance() {
+        if (instance == null)
+            instance = new LJDiagnostics();
+        return instance;
+    }
+
+    public void addError(LJError error) {
+        this.errors.add(error);
+    }
+
+    public void addWarning(LJWarning warning) {
+        this.warnings.add(warning);
+    }
+
+    public void setTranslationMap(HashMap<String, PlacementInCode> map) {
+        this.translationMap = map;
+    }
+
+    public boolean foundError() {
+        return !this.errors.isEmpty();
+    }
+
+    public boolean foundWarning() {
+        return !this.warnings.isEmpty();
+    }
+
+    public ArrayList<LJError> getErrors() {
+        return this.errors;
+    }
+
+    public ArrayList<LJWarning> getWarnings() {
+        return this.warnings;
+    }
+
+    public HashMap<String, PlacementInCode> getTranslationMap() {
+        return this.translationMap;
+    }
+
+    public LJError getError() {
+        return foundError() ? this.errors.get(0) : null;
+    }
+
+    public LJWarning getWarning() {
+        return foundWarning() ? this.warnings.get(0) : null;
+    }
+
+    public void clear() {
+        this.errors.clear();
+        this.warnings.clear();
+        this.translationMap.clear();
+    }
+
+    @Override
+    public String toString() {
+        StringBuilder sb = new StringBuilder();
+        if (foundError()) {
+            for (LJError error : errors) {
+                sb.append(error.toString()).append("\n");
+            }
+        } else {
+            if (foundWarning()) {
+                sb.append("Warnings:\n");
+                for (LJWarning warning : warnings) {
+                    sb.append(warning.getMessage()).append("\n");
+                }
+                sb.append("Passed Verification!\n");
+            }
+        }
+        return sb.toString();
+    }
+}

liquidjava-verifier/src/main/java/liquidjava/diagnostics/errors/CustomError.java

@@ -0,0 +1,18 @@
+package liquidjava.diagnostics.errors;
+
+/**
+ * Custom error with an arbitrary message
+ * 
+ * @see LJError
+ */
+public class CustomError extends LJError {
+
+    public CustomError(String message) {
+        super("Found Error", message, null);
+    }
+
+    @Override
+    public String toString() {
+        return super.toString(null);
+    }
+}

liquidjava-verifier/src/main/java/liquidjava/diagnostics/errors/GhostInvocationError.java

@@ -0,0 +1,30 @@
+package liquidjava.diagnostics.errors;
+
+import liquidjava.rj_language.Predicate;
+import spoon.reflect.declaration.CtElement;
+
+/**
+ * Error indicating that a ghost method invocation is invalid (e.g., has wrong arguments)
+ * 
+ * @see LJError
+ */
+public class GhostInvocationError extends LJError {
+
+    private Predicate expected;
+
+    public GhostInvocationError(CtElement element, Predicate expected) {
+        super("Ghost Invocation Error", "Invalid types or number of arguments in ghost invocation", element);
+        this.expected = expected;
+    }
+
+    public Predicate getExpected() {
+        return expected;
+    }
+
+    @Override
+    public String toString() {
+        StringBuilder sb = new StringBuilder();
+        sb.append("Expected: ").append(expected.toString()).append("\n");
+        return super.toString(sb.toString());
+    }
+}

liquidjava-verifier/src/main/java/liquidjava/diagnostics/errors/IllegalConstructorTransitionError.java

@@ -0,0 +1,21 @@
+package liquidjava.diagnostics.errors;
+
+import spoon.reflect.declaration.CtElement;
+
+/**
+ * Error indicating that a constructor contains a state refinement with a 'from' state, which is not allowed
+ * 
+ * @see LJError
+ */
+public class IllegalConstructorTransitionError extends LJError {
+
+    public IllegalConstructorTransitionError(CtElement element) {
+        super("Illegal Constructor Transition Error",
+                "Found constructor with 'from' state (should only have a 'to' state)", element);
+    }
+
+    @Override
+    public String toString() {
+        return super.toString(null);
+    }
+}

liquidjava-verifier/src/main/java/liquidjava/diagnostics/errors/InvalidRefinementError.java

@@ -0,0 +1,29 @@
+package liquidjava.diagnostics.errors;
+
+import spoon.reflect.declaration.CtElement;
+
+/**
+ * Error indicating that a refinement is invalid (e.g., not a boolean expression)
+ * 
+ * @see LJError
+ */
+public class InvalidRefinementError extends LJError {
+
+    private String refinement;
+
+    public InvalidRefinementError(String message, CtElement element, String refinement) {
+        super("Invalid Refinement", message, element);
+        this.refinement = refinement;
+    }
+
+    public String getRefinement() {
+        return refinement;
+    }
+
+    @Override
+    public String toString() {
+        StringBuilder sb = new StringBuilder();
+        sb.append("Refinement: ").append(refinement).append("\n");
+        return super.toString(sb.toString());
+    }
+}

liquidjava-verifier/src/main/java/liquidjava/diagnostics/errors/LJError.java

@@ -0,0 +1,67 @@
+package liquidjava.diagnostics.errors;
+
+import liquidjava.diagnostics.ErrorPosition;
+import liquidjava.utils.Utils;
+import spoon.reflect.cu.SourcePosition;
+import spoon.reflect.declaration.CtElement;
+
+/**
+ * Base class for all LiquidJava errors
+ */
+public abstract class LJError extends Exception {
+
+    private String title;
+    private String message;
+    private CtElement element;
+    private ErrorPosition position;
+    private SourcePosition location;
+
+    public LJError(String title, String message, CtElement element) {
+        super(message);
+        this.title = title;
+        this.message = message;
+        this.element = element;
+        try {
+            this.location = element.getPosition();
+            this.position = ErrorPosition.fromSpoonPosition(element.getPosition());
+        } catch (Exception e) {
+            this.location = null;
+            this.position = null;
+        }
+    }
+
+    public String getTitle() {
+        return title;
+    }
+
+    public String getMessage() {
+        return message;
+    }
+
+    public CtElement getElement() {
+        return element;
+    }
+
+    public ErrorPosition getPosition() {
+        return position;
+    }
+
+    public SourcePosition getLocation() {
+        return location;
+    }
+
+    @Override
+    public abstract String toString();
+
+    public String toString(String extra) {
+        StringBuilder sb = new StringBuilder();
+        sb.append(title).append(" at: \n").append(element.toString().replace("@liquidjava.specification.", "@"))
+                .append("\n\n");
+        sb.append(message).append("\n");
+        if (extra != null)
+            sb.append(extra).append("\n");
+        sb.append("Location: ").append(location != null ? Utils.stripParens(location.toString()) : "<unknown>")
+                .append("\n");
+        return sb.toString();
+    }
+}