Merge pull request #189 from ImperialCollegeLondon/test/min-release-mixin

test: Minimum release mixin

Author: mfacchinelli

tests/system/package/tCodeAnalyzerConfiguration.m

@@ -1,16 +1,13 @@
-classdef tCodeAnalyzerConfiguration < matlab.unittest.TestCase
+classdef tCodeAnalyzerConfiguration < matlab.unittest.TestCase & mag.test.mixin.RequireMinMATLABRelease
 % TCODEANALYZERCONFIGURATION Tests for code analyzer configuration JSON
 % file.
 
-    properties (Constant, Access = public)
-        ConfigurationFile = fullfile(fileparts(mfilename("fullpath")), "..", "..", "..", "resources", "codeAnalyzerConfiguration.json")
+    properties (Constant)
+        MinimumRelease = "R2025a"
     end
 
-    methods (TestClassSetup)
-
-        function useMATLABR2025aOrAbove(testCase)
-            testCase.assumeFalse(isMATLABReleaseOlderThan("R2025a"), "Only MATLAB R2025a or later is supported for this test.");
-        end
+    properties (Constant, Access = public)
+        ConfigurationFile = fullfile(fileparts(mfilename("fullpath")), "..", "..", "..", "resources", "codeAnalyzerConfiguration.json")
     end
 
     methods (Test)

tests/system/package/tToolbox.m

@@ -1,6 +1,10 @@
-classdef tToolbox < matlab.unittest.TestCase
+classdef tToolbox < matlab.unittest.TestCase & mag.test.mixin.RequireMinMATLABRelease
 % TTOOLBOX Tests for installation of MAG Data Visualization toolbox.
 
+    properties (Constant)
+        MinimumRelease = "R2025a"
+    end
+
     properties (Constant, Access = private)
         PackageRoot (1, 1) string = fullfile(fileparts(mfilename("fullpath")), "..", "..", "..")
     end
@@ -11,15 +15,11 @@
 
     methods (TestClassSetup)
 
-        function useMATLABR2025aOrAbove(testCase)
-            testCase.assumeFalse(isMATLABReleaseOlderThan("R2025a"), "Only MATLAB R2025a or later is supported for this test.");
-        end
-
         function checkMATLABPackage(testCase)
 
-            % MATLAB will still execute this method, even if the above
+            % MATLAB will still execute this method, even if the release
             % check fails.
-            if ~isMATLABReleaseOlderThan("R2025a")
+            if ~isMATLABReleaseOlderThan(testCase.MinimumRelease)
                 testCase.assumeEmpty(mpmlist(mag.buildtool.task.PackageTask.ToolboxName), "MAG Data Visualization installed as a MATLAB package.");
             end
         end

tests/tool/+mag/+test/+case/UITestCase.m

@@ -1,12 +1,7 @@
-classdef (Abstract) UITestCase < matlab.uitest.TestCase
+classdef (Abstract) UITestCase < matlab.uitest.TestCase & mag.test.mixin.RequireMinMATLABRelease
 % UITESTCASE Base class for all MAG UI tests.
 
-    methods (TestClassSetup)
-
-        % Do not run tests in R2024a and older as not all functionality is
-        % supported.
-        function useMATLABR2024bOrAbove(testCase)
-            testCase.assumeFalse(isMATLABReleaseOlderThan("R2024b"), "Only MATLAB R2024b or later is supported for this test.");
-        end
+    properties (Constant)
+        MinimumRelease = "R2024b"
     end
 end

tests/tool/+mag/+test/+mixin/RequireMinMATLABRelease.m

@@ -0,0 +1,17 @@
+classdef (Abstract) RequireMinMATLABRelease < matlab.unittest.TestCase
+% REQUIREMINMATLABRELEASE Require a minimum MATLAB release for testing.
+
+    properties (Abstract, Constant)
+        % MINIMUMRELEASE Minimum MATLAB release required.
+        MinimumRelease (1, 1) string {mag.validator.mustMatchRegex(MinimumRelease, "^[Rr][0-9]{4}[A-Za-z]$")}
+    end
+
+    methods (TestClassSetup)
+
+        function useMinMATLABRReleaseOrAbove(testCase)
+
+            testCase.assumeFalse(isMATLABReleaseOlderThan(testCase.MinimumRelease), ...
+                compose("Only MATLAB %s or later is supported for this test.", testCase.MinimumRelease));
+        end
+    end
+end