Adds support for imports to the Ilograph exporter (#332).

Author: simonbrowndotje

changelog.md

@@ -12,7 +12,8 @@
 - structurizr-dsl: Adds a `!relationships` keyword that can be used to find a set of relationships via an expression.
 - structurizr-dsl: Adds a DSL wrapper around the `structurizr-component` component finder.
 - structurizr-dsl: Adds support for local theme files to be specified via `theme` (https://github.com/structurizr/java/issues/331).
-- structurizr-export: Adds support for icons to the Ilograph exporter.
+- structurizr-export: Adds support for icons to the Ilograph exporter (https://github.com/structurizr/java/issues/332).
+- structurizr-export: Adds support for imports to the Ilograph exporter (https://github.com/structurizr/java/issues/332).
 
 ## 2.2.0 (2nd July 2024)
 

structurizr-export/src/main/java/com/structurizr/export/ilograph/IlographExporter.java

@@ -16,10 +16,41 @@
  */
 public class IlographExporter extends AbstractWorkspaceExporter {
 
+    public static final String ILOGRAPH_IMPORTS = "ilograph.imports";
     public static final String ILOGRAPH_ICON = "ilograph.icon";
 
     public WorkspaceExport export(Workspace workspace) {
         IndentingWriter writer = new IndentingWriter();
+
+        // Ilograph imports can be specified in the form:
+        //
+        // AWS:ilograph/aws
+        //
+        // Which gets exported as:
+        //
+        // imports:
+        //  - from: ilograph/aws
+        //    namespace: AWS
+        String commaSeparatedListOfImports = workspace.getProperties().get(ILOGRAPH_IMPORTS);
+        if (!StringUtils.isNullOrEmpty(commaSeparatedListOfImports)) {
+            writer.writeLine("imports:");
+
+            String[] ilographImports = commaSeparatedListOfImports.split(",");
+            for (String ilographImport : ilographImports) {
+                String[] parts = ilographImport.split(":");
+                if (parts.length == 2) {
+                    String namespace = parts[0];
+                    String from = parts[1];
+
+                    writer.writeLine("- from: " + from);
+                    writer.indent();
+                    writer.writeLine("namespace: " + namespace);
+                    writer.outdent();
+                }
+            }
+            writer.writeLine();
+        }
+
         writer.writeLine("resources:");
         writer.indent();
 

structurizr-export/src/test/java/com/structurizr/export/ilograph/IlographExporterTests.java

@@ -26,7 +26,7 @@ public void test_BigBankPlcExample() throws Exception {
     }
 
     @Test
-    public void test_AmazonWebServicesExample() throws Exception {
+    void test_AmazonWebServicesExample() throws Exception {
         Workspace workspace = WorkspaceUtils.loadWorkspaceFromJson(new File("./src/test/resources/structurizr-54915-workspace.json"));
         workspace.getViews().getConfiguration().getStyles().addElementStyle("Amazon Web Services - Route 53").addProperty(IlographExporter.ILOGRAPH_ICON, "AWS/Networking/Route-53.svg");
 
@@ -39,7 +39,7 @@ public void test_AmazonWebServicesExample() throws Exception {
     }
 
     @Test
-    public void test_renderCustomElements() throws Exception {
+    void test_renderCustomElements() {
         Workspace workspace = new Workspace("Name", "Description");
         Model model = workspace.getModel();
 
@@ -71,4 +71,23 @@ public void test_renderCustomElements() throws Exception {
                 "        color: \"#707070\"\n", export.getDefinition());
     }
 
+    @Test
+    void test_imports() {
+        Workspace workspace = new Workspace("Name", "Description");
+        workspace.addProperty(IlographExporter.ILOGRAPH_IMPORTS, "NAMESPACE1:path1,NAMESPACE2:path2");
+
+        WorkspaceExport export = new IlographExporter().export(workspace);
+        assertEquals("""
+imports:
+- from: path1
+  namespace: NAMESPACE1
+- from: path2
+  namespace: NAMESPACE2
+
+resources:
+perspectives:
+  - name: Static Structure
+    relations:""", export.getDefinition());
+    }
+
 }