Merge branch 'R2022b' of https://github.com/mathworks/matlab-engine-for-python into R2022b

Author: alanfmw

.github/workflows/qualify_22b_23a.yml

@@ -0,0 +1,41 @@
+# Run tInstall on Ubuntu against python versions 3.10, 3.9 and 3.8
+
+name: Test R2022b and R2023a
+
+on:
+  push:
+    branches:
+      - R2022b
+      - R2023a
+      - main
+
+  # Allows you to run this workflow manually from the Actions tab
+  workflow_dispatch:
+
+
+
+# A workflow run is made up of one or more jobs that can run sequentially or in parallel
+jobs:
+  test-python-engine:
+    strategy:
+      matrix:
+        python: ["3.10", "3.9", "3.8"]
+        matlab: [R2022b, R2023a]
+    
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Set up Python
+        uses: actions/setup-python@v3.1.3
+        with:
+           python-version: ${{ matrix.python }}
+      
+      - name: Set up MATLAB
+        uses: matlab-actions/setup-matlab@v1
+        with:
+           release: ${{ matrix.matlab }}
+
+      - uses: actions/checkout@v3
+
+      - name: Run tests
+        uses: matlab-actions/run-tests@v1

README.md

@@ -11,7 +11,7 @@ The MATLAB® Engine API for Python® provides a package to integrate MATLA
 ### Required 3rd Party Products
 <!-- MUST_BE_UPDATED_EACH_RELEASE (Search repo for this string) -->
 * Python 3.8, 3.9, or 3.10
-    * Supported Python versions by MATLAB release can be found [here](https://www.mathworks.com/content/dam/mathworks/mathworks-dot-com/support/sysreq/files/python-compatibility.pdf).
+    * Supported Python versions by MATLAB release can be found [here](https://www.mathworks.com/learn/training/advanced-matlab-application-development.html).
 
 ---
 

test/tInstall.m

@@ -0,0 +1,41 @@
+classdef tInstall < matlab.unittest.TestCase
+% Verify installation of matlab engine
+
+% Copyright 2023 Mathworks, Inc.
+
+    properties (Constant)
+        MATLABVersion = string(ver('MATLAB').Version) % Example: 9.14
+        MATLABRelease = erase(ver('MATLAB').Release,{'(',')'}) % Example: (R2023a) -> R2023a
+    end
+
+    methods (Test)
+        function installNoVersionSpecified(testCase)
+            assumeEqual(testCase, testCase.MATLABRelease, 'R2023a')
+            [status, out] = system("pip install matlabengine");
+            verifyEqual(testCase, status, 0, out)
+            verifyInstallation(testCase)
+        end
+
+        function installMatchingEngine(testCase)
+            [status, out] = system("pip install matlabengine==" + testCase.MATLABVersion + ".*");
+            verifyEqual(testCase, status, 0, out)
+            verifyInstallation(testCase)
+        end
+    end
+
+    methods
+        function verifyInstallation(testCase)
+        % Verify installation by calling functions in matlab engine
+        % Share this session and see if find_matlab can find it.
+            sharedEngineName = string(matlab.engine.engineName);
+            if (sharedEngineName == "")
+                sharedEngineName = "MATLAB_tInstall";
+                matlab.engine.shareEngine(sharedEngineName)
+            end
+            pySharedEngineName = string(py.matlab.engine.find_matlab());
+            verifyEqual(testCase, pySharedEngineName, sharedEngineName)
+            system("pip uninstall -y matlabengine")
+        end
+    end
+end
+