buildtool works with Matlab >= R2022b

Author: scivision

.github/workflows/composite-nomex/action.yml

@@ -15,7 +15,7 @@ runs:
 
 
   - name: Non-Mex Test (< R2024b)
-    if: ${{ matrix.release >= 'R2023b' && matrix.release < 'R2024b' }}
+    if: ${{ matrix.release >= 'R2022b' && matrix.release < 'R2024b' }}
     uses: matlab-actions/run-build@v2
     with:
       startup-options: ${{ matrix.startup-options }}
@@ -31,7 +31,7 @@ runs:
 
 
   - name: Java Test (< R2024b)
-    if: ${{ !contains(matrix.startup-options, '-nojvm') && matrix.release >= 'R2023b' && matrix.release < 'R2024b' }}
+    if: ${{ !contains(matrix.startup-options, '-nojvm') && matrix.release >= 'R2022b' && matrix.release < 'R2024b' }}
     uses: matlab-actions/run-build@v2
     with:
       startup-options: ${{ matrix.startup-options }}
@@ -40,8 +40,8 @@ runs:
 
 # note: "source-folder" adds all subfolders to Matlab path
 # https://github.com/matlab-actions/run-tests?tab=readme-ov-file#run-matlab-tests
-  - name: Non-mex tests (< R2023b)
-    if: ${{ matrix.release < 'R2023b' }}
+  - name: Non-buildtool tests (< R2022b)
+    if: ${{ matrix.release < 'R2022b' }}
     uses: matlab-actions/run-command@v2
     with:
       command: run('test/test_nomex.m')

Readme.md

@@ -16,22 +16,44 @@ and
 [mustBeTextScalar](https://www.mathworks.com/help/matlab/ref/mustbetextscalar.html)
 syntax.
 URLs (e.g. https://, s3:// and similar) are treated as not existing.
+
+## Self-tests
+
 The self-tests require at least Matlab R2020b and can be run from the matlab-stdlib/ directory.
 
+Matlab R2024b and newer:
+
 ```matlab
-%% Matlab >= R2023a
 buildtool test
 ```
 
-or for older Matlab:
+Matlab R2023a..R2024a, inclusive:
+
+```matlab
+buildtool test_nomex
+buildtool test_java
+buildtool test_exe
+buildtool test_mex
+```
+
+Matlab R2022b:
+
+```matlab
+buildtool test_nomex
+buildtool test_java
+```
+
+Matlab older than R2022b:
 
 ```matlab
 run('test/test_nomex.m')
 ```
 
-Build the optional high-performance
+## MEX functions
+
+With Matlab R2023a and newer, optionally build high-performance
 [MEX](https://www.mathworks.com/help/matlab/cpp-mex-file-applications.html)
-functions from the Matlab prompt in Matlab R2023a or newer:
+functions (the same functions are provided by default without MEX) from the Matlab prompt in Matlab R2023a or newer:
 
 ```matlab
 buildtool mex

buildfile.m

@@ -1,16 +1,18 @@
 function plan = buildfile
 import matlab.unittest.selectors.HasTag
-assert(~isMATLABReleaseOlderThan("R2023b"), "MATLAB R2023b or newer is required for this buildfile")
+assert(~isMATLABReleaseOlderThan("R2022b"), "MATLAB R2022b or newer is required for this buildfile")
 
 plan = buildplan(localfunctions);
 
 pkg_name = "+stdlib";
 
 addpath(plan.RootFolder)
 
-%% Self-test setup
-plan("clean") = matlab.buildtool.tasks.CleanTask;
-
+if isMATLABReleaseOlderThan("R2023b")
+  plan("clean") =matlab.buildtool.Task();
+else
+  plan("clean") = matlab.buildtool.tasks.CleanTask;
+end
 
 cnomex = ~HasTag("exe") & ~HasTag("mex") & ~HasTag("java");
 if ispc()
@@ -24,11 +26,15 @@
   cjava = cjava & ~HasTag("unix");
 end
 
+if isMATLABReleaseOlderThan("R2023b")
+  plan("test_exe") = matlab.buildtool.Task(Actions=@(context) legacy_test(context, HasTag("exe")), Dependencies="exe");
+elseif isMATLABReleaseOlderThan("R2024b")
+  plan("test_exe") = matlab.buildtool.tasks.TestTask("test", Tag="exe", Dependencies="exe");
+end
 
 if isMATLABReleaseOlderThan("R2024b")
 
   plan("test_java") = matlab.buildtool.Task(Actions=@(context) legacy_test(context, cjava));
-  plan("test_exe") = matlab.buildtool.tasks.TestTask("test", Tag="exe", Dependencies="exe");
   plan("test_nomex") = matlab.buildtool.Task(Actions=@(context) legacy_test(context, cnomex), Dependencies="clean");
   plan("test_mex") = matlab.buildtool.Task(Actions=@(context) legacy_test(context, cmex), Dependencies="mex");
 
@@ -60,6 +66,8 @@
   plan("clean_mex") = matlab.buildtool.Task(Actions=@clean_mex, Description="Clean only MEX files to enable incremental tests");
 end
 
+if isMATLABReleaseOlderThan("R2023a"), return, end
+
 td = fullfile(plan.RootFolder, 'test');
 
 srcs = ["stdout_stderr_c.c", "stdin_cpp.cpp", "printenv.cpp", "sleep.cpp"];