Internal Report Viewer: host and use the the report viewer locally

.github/workflows/maven.yml

@@ -1,7 +1,7 @@
 name: Build
 
 on:
-  push: 
+  push:
     paths:
       - ".github/workflows/maven.yml"
       - "**/pom.xml"
@@ -14,7 +14,7 @@ on:
       - "**/pom.xml"
       - "**.java"
       - "**.g4"
-  
+
   # Allows you to run this workflow manually from the Actions tab
   workflow_dispatch:
 
@@ -43,17 +43,21 @@ jobs:
       with:
         java-version: 21
         distribution: 'temurin'
-
+
+    - uses: actions/setup-node@v4
+      with:
+        node-version: "18"
+
     - name: Run Tests
       run: mvn verify -B -U
-      
+
     - name: Build Assembly
-      run: mvn clean package assembly:single
-      
+      run: mvn -Pwith-report-viewer clean package assembly:single
+
     - name: Upload Assembly
       uses: actions/upload-artifact@v4
       with:
         name: "JPlag"
         path: "jplag.cli/target/jplag-*-jar-with-dependencies.jar"
-      
+
 

.github/workflows/publish.yml

@@ -34,8 +34,12 @@ jobs:
         with:
           java-version: '21'
           distribution: 'temurin'
+      - uses: actions/setup-node@v4
+        with:
+          node-version: "18"
+
       - name: Build JPlag
-        run: mvn -U -B clean package assembly:single
+        run: mvn -Pwith-report-viewer -U -B clean package assembly:single
 
       - name: Attach CLI to Release on GitHub
         uses: softprops/action-gh-release@v1

.github/workflows/sonarcloud-branch.yml

@@ -42,7 +42,7 @@ jobs:
           path: ~/.m2
           key: ${{ runner.os }}-m2-${{ hashFiles('**/pom.xml') }}
           restore-keys: ${{ runner.os }}-m2
-          
+
       - name: Build and analyze
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.github/workflows/sonarcloud-pr.yml

@@ -65,7 +65,7 @@ jobs:
           path: ~/.m2
           key: ${{ runner.os }}-m2-${{ hashFiles('**/pom.xml') }}
           restore-keys: ${{ runner.os }}-m2
-          
+
       - name: Build and analyze (PR)
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.github/workflows/spotless.yml

@@ -14,7 +14,7 @@ on:
       - "**/pom.xml"
       - "**.java"
       - "**.g4"
-  
+
   # Allows you to run this workflow manually from the Actions tab
   workflow_dispatch:
 
@@ -43,9 +43,9 @@ jobs:
       with:
         java-version: 21
         distribution: 'temurin'
-      
+
     - name: Check with Spotless
       run: mvn clean spotless:check
-      
-      
+
+
 

README.md

@@ -60,7 +60,8 @@ JPlag is released on [Maven Central](https://search.maven.org/search?q=de.jplag)
 1. Download or clone the code from this repository.
 2. Run `mvn clean package` from the root of the repository to compile and build all submodules.
    Run `mvn clean package assembly:single` instead if you need the full jar which includes all dependencies.
-5. You will find the generated JARs in the subdirectory `cli/target`.
+   Run `mvn -Pwith-report-viewer clean package assembly:single` to build the full jar with the report viewer. In this case, you'll need [Node.js](https://nodejs.org/en/download) installed.
+3. You will find the generated JARs in the subdirectory `cli/target`.
 
 ## Usage
 JPlag can either be used via the CLI or directly via its Java API. For more information, see the [usage information in the wiki](https://github.com/jplag/JPlag/wiki/1.-How-to-Use-JPlag). If you are using the CLI, you can display your results via [jplag.github.io](https://jplag.github.io/JPlag/). No data will leave your computer!

cli/pom.xml

@@ -7,6 +7,7 @@
         <version>${revision}</version>
     </parent>
     <artifactId>cli</artifactId>
+
     <dependencies>
         <!-- IMPORTANT: For Coverage testing, you have to add dependencies to the coverage-report project ! -->
 
@@ -161,4 +162,56 @@
             </plugin>
         </plugins>
     </build>
+
+    <profiles>
+        <profile>
+            <id>with-report-viewer</id>
+            <build>
+                <resources>
+                    <resource>
+                        <targetPath>report-viewer</targetPath>
+                        <directory>../report-viewer/dist</directory>
+                    </resource>
+                </resources>
+                <plugins>
+                    <plugin>
+                        <groupId>org.codehaus.mojo</groupId>
+                        <artifactId>exec-maven-plugin</artifactId>
+                        <version>1.3.2</version>
+                        <executions>
+                            <execution>
+                                <id>npm install</id>
+                                <goals>
+                                    <goal>exec</goal>
+                                </goals>
+                                <phase>generate-resources</phase>
+                                <configuration>
+                                    <executable>npm</executable>
+                                    <workingDirectory>../report-viewer</workingDirectory>
+                                    <arguments>
+                                        <argument>install</argument>
+                                    </arguments>
+                                </configuration>
+                            </execution>
+                            <execution>
+                                <id>npm build</id>
+                                <goals>
+                                    <goal>exec</goal>
+                                </goals>
+                                <phase>generate-resources</phase>
+                                <configuration>
+                                    <executable>npm</executable>
+                                    <workingDirectory>../report-viewer</workingDirectory>
+                                    <arguments>
+                                        <argument>run</argument>
+                                        <argument>build</argument>
+                                    </arguments>
+                                </configuration>
+                            </execution>
+                        </executions>
+                    </plugin>
+                </plugins>
+            </build>
+        </profile>
+    </profiles>
 </project>

cli/src/main/java/de/jplag/cli/CLI.java

@@ -4,8 +4,11 @@
 import static picocli.CommandLine.Model.UsageMessageSpec.SECTION_KEY_OPTION_LIST;
 import static picocli.CommandLine.Model.UsageMessageSpec.SECTION_KEY_SYNOPSIS;
 
+import java.awt.*;
 import java.io.File;
 import java.io.FileNotFoundException;
+import java.io.IOException;
+import java.net.URI;
 import java.security.SecureRandom;
 import java.util.Arrays;
 import java.util.HashSet;
@@ -22,6 +25,7 @@
 import de.jplag.JPlagResult;
 import de.jplag.Language;
 import de.jplag.cli.logger.CollectedLoggerFactory;
+import de.jplag.cli.server.ReportViewer;
 import de.jplag.clustering.ClusteringOptions;
 import de.jplag.clustering.Preprocessing;
 import de.jplag.exceptions.ExitException;
@@ -77,14 +81,13 @@ public static void main(String[] args) {
             ParseResult parseResult = cli.parseOptions(args);
 
             if (!parseResult.isUsageHelpRequested() && !(parseResult.subcommand() != null && parseResult.subcommand().isUsageHelpRequested())) {
-                JPlagOptions options = cli.buildOptionsFromArguments(parseResult);
-                JPlagResult result = JPlag.run(options);
-                ReportObjectFactory reportObjectFactory = new ReportObjectFactory(new File(cli.getResultFolder() + ".zip"));
-                reportObjectFactory.createAndSaveReport(result);
-
-                OutputFileGenerator.generateCsvOutput(result, new File(cli.getResultFolder()), cli.options);
+                switch (cli.options.mode) {
+                    case RUN -> cli.runJPlag(parseResult);
+                    case VIEWER -> cli.runViewer(null);
+                    case RUN_AND_VIEW -> cli.runViewer(cli.runJPlag(parseResult));
+                }
             }
-        } catch (ExitException | FileNotFoundException exception) {
+        } catch (ExitException | IOException exception) {
             logger.error(exception.getMessage()); // do not pass exception here to keep log clean
             finalizeLogger();
             System.exit(1);
@@ -115,6 +118,27 @@ public CLI() {
         this.commandLine.setAllowSubcommandsAsOptionParameters(true);
     }
 
+    public File runJPlag(ParseResult parseResult) throws ExitException, FileNotFoundException {
+        JPlagOptions options = buildOptionsFromArguments(parseResult);
+        JPlagResult result = JPlag.run(options);
+        File target = new File(getResultFolder() + ".zip");
+        ReportObjectFactory reportObjectFactory = new ReportObjectFactory(target);
+        reportObjectFactory.createAndSaveReport(result);
+        OutputFileGenerator.generateCsvOutput(result, new File(getResultFolder()), this.options);
+        return target;
+    }
+
+    public void runViewer(File zipFile) throws IOException {
+        ReportViewer reportViewer = new ReportViewer(zipFile, this.options.advanced.port);
+        int port = reportViewer.start();
+        logger.info("ReportViewer started on port http://localhost:{}", port);
+        Desktop.getDesktop().browse(URI.create("http://localhost:" + port + "/"));
+
+        System.out.println("Press Enter key to exit...");
+        System.in.read();
+        reportViewer.stop();
+    }
+
     private List<CommandSpec> buildSubcommands() {
         return LanguageLoader.getAllAvailableLanguages().values().stream().map(language -> {
             CommandSpec command = CommandSpec.create().name(language.getIdentifier());

cli/src/main/java/de/jplag/cli/CliOptions.java

@@ -53,6 +53,9 @@ public class CliOptions implements Runnable {
             "--result-directory"}, description = "Name of the directory in which the comparison results will be stored (default: ${DEFAULT-VALUE})%n")
     public String resultFolder = "results";
 
+    @Option(names = {"--mode"}, description = "The mode to run jplag in")
+    public JPlagMode mode = JPlagMode.RUN;
+
     @ArgGroup(heading = "Advanced%n", exclusive = false)
     public Advanced advanced = new Advanced();
 
@@ -89,6 +92,9 @@ public static class Advanced {
                         + "be saved (default: ${DEFAULT-VALUE})%n")
         public double similarityThreshold = JPlagOptions.DEFAULT_SIMILARITY_THRESHOLD;
 
+        @Option(names = {"-P", "--port"}, description = "The port used for the internal report viewer.")
+        public int port = 1996;
+
         @Option(names = "--csv-export", description = "If present, a csv export will be generated in addition to the zip file.")
         public boolean csvExport = false;
     }

cli/src/main/java/de/jplag/cli/JPlagMode.java

@@ -0,0 +1,19 @@
+package de.jplag.cli;
+
+/**
+ * The mode JPlag runs in. This influences which steps JPlag will execute
+ */
+public enum JPlagMode {
+    /**
+     * Only run JPlag and create a results.zip
+     */
+    RUN,
+    /**
+     * Only start the report viewer
+     */
+    VIEWER,
+    /**
+     * Run JPlag and open the result in report viewer
+     */
+    RUN_AND_VIEW
+}

cli/src/main/java/de/jplag/cli/server/ContentType.java

@@ -0,0 +1,41 @@
+package de.jplag.cli.server;
+
+/**
+ * Data types used by JPlag in the context of http. Contains the according mime type.
+ */
+public enum ContentType {
+    HTML("text/html; charset=utf-8", ".html"),
+    JS("application/javascript; charset=utf-8", ".js"),
+    CSS("text/css; charset=utf-8", ".css"),
+    PNG("image/png", ".png"),
+    PLAIN("text/plain; charset=utf-8", null),
+    ZIP("application/zip", ".zip");
+
+    private final String value;
+
+    private final String nameSuffix;
+
+    ContentType(String value, String nameSuffix) {
+        this.value = value;
+        this.nameSuffix = nameSuffix;
+    }
+
+    public String getValue() {
+        return value;
+    }
+
+    /**
+     * Guesses the type from the given path using the suffix after the last '.'.
+     * @param path The path to guess from
+     * @return The guessed type
+     */
+    public static ContentType fromPath(String path) {
+        String suffix = path.substring(path.lastIndexOf('.'));
+        for (ContentType value : ContentType.values()) {
+            if (suffix.equals(value.nameSuffix)) {
+                return value;
+            }
+        }
+        return ContentType.PLAIN;
+    }
+}

cli/src/main/java/de/jplag/cli/server/HttpRequestMethod.java

@@ -0,0 +1,32 @@
+package de.jplag.cli.server;
+
+/**
+ * Wraps the http request methods used by JPlag. Request methods determine the capabilities of a http request.
+ */
+public enum HttpRequestMethod {
+    GET("GET"),
+    POST("POST");
+
+    private final String name;
+
+    /**
+     * @param name The name of the request method
+     */
+    HttpRequestMethod(String name) {
+        this.name = name;
+    }
+
+    public String getName() {
+        return name;
+    }
+
+    public static HttpRequestMethod fromName(String name) {
+        for (HttpRequestMethod value : HttpRequestMethod.values()) {
+            if (value.name.equals(name)) {
+                return value;
+            }
+        }
+
+        return null;
+    }
+}