Add unit tests for parallelizable build summary plugin

Author: Sam Eagen

.github/workflows/bat.yml

@@ -4,6 +4,20 @@ permissions:
   contents: read
 
 jobs:
+  plugin-tests:
+    runs-on: ${{ matrix.os }}
+    strategy:
+        fail-fast: false
+        matrix:
+            include:
+                - os: ubuntu-latest
+                - os: windows-latest
+                - os: macos-latest
+    steps:
+        - uses: actions/checkout@v5
+        - uses: matlab-actions/setup-matlab@v2
+        - uses: matlab-actions/run-tests@v2
+      
   bat:
     name: Build and Test
     runs-on: ubuntu-22.04

plugins/+buildframework/ParallelizableBuildSummaryPlugin.m

@@ -7,8 +7,17 @@
     end
 
     methods
-        function plugin = ParallelizableBuildSummaryPlugin()
-            tempRoot = getenv("RUNNER_TEMP");
+        function plugin = ParallelizableBuildSummaryPlugin(options)
+            arguments
+                options.TempFolder (1,:) string = string.empty()
+            end
+
+            if ~isempty(options.TempFolder)
+                tempRoot = options.TempFolder;
+            else
+                tempRoot = getenv("RUNNER_TEMP");
+            end
+
             plugin.TempFolder = fullfile(tempRoot, "taskDetails");
         end
     end
@@ -31,7 +40,8 @@ function runBuild(plugin, pluginData)
             end
 
             % Write to file
-            [fID, msg] = fopen(fullfile(getenv("RUNNER_TEMP"), "buildSummary" + getenv("GITHUB_RUN_ID") + ".json"), "w");
+            folder = fileparts(plugin.TempFolder);
+            [fID, msg] = fopen(fullfile(folder, "buildSummary" + getenv("GITHUB_RUN_ID") + ".json"), "w");
             if fID == -1
                 warning("buildframework:BuildSummaryPlugin:UnableToOpenFile","Unable to open a file required to create the MATLAB build summary table: %s", msg);
             else

plugins/tests/tParallelizableBuildSummaryPlugin.m

@@ -0,0 +1,105 @@
+classdef tParallelizableBuildSummaryPlugin < matlab.unittest.TestCase
+
+    % Copyright 2026 The MathWorks, Inc.
+
+    properties
+        TempFolder
+        Plugin
+        Runner
+    end
+
+    methods (TestClassSetup)
+        function setupPath(testCase)
+            import matlab.unittest.fixtures.PathFixture;
+
+            testCase.applyFixture(PathFixture(fileparts(fileparts(mfilename("fullpath")))));
+        end
+    end
+
+    methods (TestMethodSetup)
+        function createPlugin(testCase)
+            import matlab.unittest.fixtures.WorkingFolderFixture;
+            
+            testCase.applyFixture(WorkingFolderFixture);
+            testCase.TempFolder = pwd();
+
+            testCase.Plugin = ParallelizableBuildSummaryPlugin(TempFolder=testCase.TempFolder);
+            testCase.Runner = matlab.buildtool.BuildRunner.withNoPlugins();
+            testCase.Runner.addPlugin(testCase.Plugin);
+        end
+    end
+
+    methods (Test)
+        function runningBuildCreatesSummaryArtifact(testCase)
+            plan = buildplan();
+            plan("t1") = Task();
+            plan("t2") = Task();
+
+            testCase.Runner.run(plan, ["t1", "t2"]);
+
+            testCase.verifyTrue(isfile(fullfile(testCase.TempFolder, "buildSummary.json")));
+        end
+
+        function runningBuildCreatesSummaryArtifactWithExpectedTasks(testCase)
+            plan = buildplan();
+            plan("t1") = Task();
+            plan("t2") = Task();
+
+            testCase.Runner.run(plan, ["t1", "t2"]);
+
+            f = fullfile(testCase.TempFolder, "buildSummary.json");
+            testCase.assertTrue(isfile(f));
+
+            s = readstruct(f);
+
+            testCase.verifySize(s, [1 2]);
+            testCase.verifyEqual(s(1).name, "t1");
+            testCase.verifyEqual(s(2).name, "t2");
+        end
+
+        function summaryArtifactStatusesAreCorrect(testCase)
+            plan = buildplan();
+            plan("t1") = Task();
+            plan("t2") = Task(Actions=@()error("bam"));
+
+            testCase.Runner.run(plan, ["t1", "t2"]);
+
+            f = fullfile(testCase.TempFolder, "buildSummary.json");
+            testCase.assertTrue(isfile(f));
+
+            s = readstruct(f);
+
+            testCase.verifySize(s, [1 2]);
+
+            testCase.verifyFalse(s(1).failed);
+            testCase.verifyFalse(s(1).skipped);
+
+            testCase.verifyTrue(s(2).failed);
+            testCase.verifyFalse(s(2).skipped);
+        end
+
+        function runningBuildCreatesSummaryForTaskGroups(testCase)
+            plan = buildplan();
+            plan("g:t") = Task();
+
+            testCase.Runner.run(plan, "g:t");
+
+            f = fullfile(testCase.TempFolder, "buildSummary.json");
+            testCase.assertTrue(isfile(f));
+
+            s = readstruct(f);
+
+            testCase.verifySize(s, [1 1]);
+            testCase.verifyEqual(s(1).name, "g:t");
+        end
+    end
+
+end
+
+function plugin = ParallelizableBuildSummaryPlugin(varargin)
+plugin = buildframework.ParallelizableBuildSummaryPlugin(varargin{:});
+end
+
+function task = Task(varargin)
+task = matlab.buildtool.Task(varargin{:});
+end