Add a source argument to setup-matlab

action.yml

@@ -9,6 +9,11 @@ inputs:
       MATLAB release to set up (R2021a or later)
     required: false
     default: latest
+  source:
+    description: >-
+      Path to mounted ISO image or directory set up with `mpm download`
+    required: false
+    default: ""
   products:
     description: >-
       Products to set up in addition to MATLAB, specified as a list of product names separated by spaces

src/index.ts

@@ -10,8 +10,13 @@ export async function run() {
     const platform = process.platform;
     const architecture = process.arch;
     const release = core.getInput("release");
+    const source = core.getInput("source");
     const products = core.getMultilineInput("products");
     const cache = core.getBooleanInput("cache");
+
+    if (source !== "") {
+        return install.installFromSource(platform, architecture, source, products);
+    }
     return install.install(platform, architecture, release, products, cache);
 }
 

src/install.ts

@@ -1,6 +1,7 @@
 // Copyright 2020-2025 The MathWorks, Inc.
 
 import * as core from "@actions/core";
+import * as crypto from "crypto";
 import * as matlab from "./matlab";
 import * as mpm from "./mpm";
 import * as path from "path";
@@ -56,7 +57,7 @@ export async function install(platform: string, architecture: string, release: s
         core.setOutput('matlabroot', destination);
 
         await matlab.setupBatch(platform, matlabArch);
-        
+
         if (platform === "win32") {
             if (matlabArch === "x86") {
                 core.addPath(path.join(destination, "runtime", "win32"));
@@ -68,3 +69,39 @@ export async function install(platform: string, architecture: string, release: s
 
     return;
 }
+
+// Limitations
+//
+// * No system dependencies are installed
+// * Does not cache
+export async function installFromSource(platform: string, architecture: string, source: string, products: string[]) {
+    // Create release key
+    const releaseKey = 'source-' + crypto.createHash('sha256').update(source).digest('hex');
+    const releaseInfo = {
+        name: releaseKey,
+        version: "1.0.0",
+        update: "",
+        isPrerelease: false
+    };
+
+    const [destination, alreadyExists]: [string, boolean] = await matlab.getToolcacheDir(platform, releaseInfo);
+
+    if (!alreadyExists) {
+        const mpmPath: string = await mpm.setup(platform, architecture);
+        await mpm.installFromSource(mpmPath, source, products, destination);
+        core.saveState(State.InstallSuccessful, 'true');
+    }
+
+    core.addPath(path.join(destination, "bin"));
+    core.setOutput('matlabroot', destination);
+
+    await matlab.setupBatch(platform, architecture);
+
+    if (platform === "win32") {
+        if (architecture === "x86") {
+            core.addPath(path.join(destination, "runtime", "win32"));
+        } else {
+            core.addPath(path.join(destination, "runtime", "win64"));
+        }
+    }
+}

src/install.unit.test.ts

@@ -23,6 +23,7 @@ describe("install procedure", () => {
     let matlabSetupBatchMock: jest.Mock;
     let mpmSetupMock: jest.Mock;
     let mpmInstallMock: jest.Mock;
+    let mpmInstallSourceMock: jest.Mock;
     let saveStateMock: jest.Mock;
     let addPathMock: jest.Mock;
     let setOutputMock: jest.Mock;
@@ -51,6 +52,7 @@ describe("install procedure", () => {
         matlabSetupBatchMock = matlab.setupBatch as jest.Mock;
         mpmSetupMock = mpm.setup as jest.Mock;
         mpmInstallMock = mpm.install as jest.Mock;
+        mpmInstallSourceMock = mpm.installFromSource as jest.Mock;
         saveStateMock = core.saveState as jest.Mock;
         addPathMock = core.addPath as jest.Mock;
         setOutputMock = core.setOutput as jest.Mock;
@@ -92,7 +94,7 @@ describe("install procedure", () => {
         matlabGetReleaseInfoMock.mockResolvedValue({
             name: "r2020a",
             version: "9.8.0",
-            updateNumber: "latest"    
+            updateNumber: "latest"
         });
         await expect(install.install(platform, arch, "r2020a", products, useCache)).rejects.toBeDefined();
     });
@@ -124,11 +126,22 @@ describe("install procedure", () => {
         expect(saveStateMock).toHaveBeenCalledTimes(0);
     });
 
+    it("rejects when mpm installing from source fails", async () => {
+        mpmInstallSourceMock.mockRejectedValue(Error("oof"));
+        await expect(install.installFromSource("linux", "x64", "bad/path", ["MATLAB"])).rejects.toBeDefined();
+        expect(saveStateMock).toHaveBeenCalledTimes(0);
+    });
+
     it("rejects when the matlab-batch install fails", async () => {
         matlabSetupBatchMock.mockRejectedValueOnce(Error("oof"));
         await expect(doInstall()).rejects.toBeDefined();
     });
 
+    it("installing from source rejects when the matlab-batch install fails", async () => {
+        matlabSetupBatchMock.mockRejectedValueOnce(Error("oof"));
+        await expect(install.installFromSource("linux", "x64", "/path", ["MATLAB"])).rejects.toBeDefined();
+    });
+
     it("Does not restore cache if useCache is false", async () => {
         await expect(doInstall()).resolves.toBeUndefined();
         expect(restoreMATLABMock).toHaveBeenCalledTimes(0);
@@ -156,7 +169,7 @@ describe("install procedure", () => {
         matlabGetReleaseInfoMock.mockResolvedValue({
             name: "r2023a",
             version: "9.14.0",
-            updateNumber: "latest"    
+            updateNumber: "latest"
         });
         await expect(install.install("darwin", "arm64", "r2023a", products, true)).resolves.toBeUndefined();
         expect(matlabInstallSystemDependenciesMock).toHaveBeenCalledWith("darwin", "arm64", "r2023a");
@@ -171,4 +184,34 @@ describe("install procedure", () => {
         expect(addPathMock).toHaveBeenCalledWith(expect.stringContaining("runtime"));
     });
 
+    it("installs from source", async () => {
+        await expect(install.installFromSource("linux", "x64", "/dummy/path", ["MATLAB", "Parallel_Computing_Toolbox"]))
+            .resolves
+            .toBeUndefined();
+        expect(matlabInstallSystemDependenciesMock).toHaveBeenCalledTimes(0);
+        expect(matlabSetupBatchMock).toHaveBeenCalledTimes(1);
+        expect(mpmSetupMock).toHaveBeenCalledTimes(1);
+        expect(mpmInstallMock).toHaveBeenCalledTimes(0);
+        expect(mpmInstallSourceMock).toHaveBeenCalledTimes(1);
+        expect(saveStateMock).toHaveBeenCalledWith(State.InstallSuccessful, 'true');
+        expect(addPathMock).toHaveBeenCalledTimes(1);
+        expect(setOutputMock).toHaveBeenCalledTimes(1);
+    });
+
+    it("NoOp on existing install from source", async () => {
+        matlabGetToolcacheDirMock.mockResolvedValue(["/opt/hostedtoolcache/MATLAB/9.13.0/x64", true]);
+        await expect(install.installFromSource("linux", "x64", "/my/path", ["MATLAB"])).resolves.toBeUndefined();
+        expect(mpmInstallMock).toHaveBeenCalledTimes(0);
+        expect(saveStateMock).toHaveBeenCalledTimes(0);
+        expect(addPathMock).toHaveBeenCalledTimes(1);
+        expect(setOutputMock).toHaveBeenCalledTimes(1);
+    });
+
+    it("adds runtime path for Windows platform when installing from source", async () => {
+        await expect(install.installFromSource("win32", arch, "/dummy/path", products)).resolves.toBeUndefined();
+        expect(addPathMock).toHaveBeenCalledTimes(2);
+        expect(addPathMock).toHaveBeenCalledWith(expect.stringContaining("bin"));
+        expect(addPathMock).toHaveBeenCalledWith(expect.stringContaining("runtime"));
+    });
+
 });

src/mpm.ts

@@ -72,7 +72,7 @@ export async function install(mpmPath: string, release: matlab.Release, products
         "install",
         `--release=${mpmRelease}`,    
         `--destination=${destination}`,
-    ]
+    ];
     if (release.isPrerelease) {
         mpmArguments = mpmArguments.concat(["--release-status=Prerelease"]);
     }
@@ -89,3 +89,30 @@ export async function install(mpmPath: string, release: matlab.Release, products
     }
     return
 }
+
+export async function installFromSource(mpmPath: string, source: string, products: string[], destination: string) {
+    // remove spaces and flatten product list
+    let parsedProducts = products.flatMap(p => p.split(/[ ]+/));
+    // Add MATLAB by default
+    parsedProducts.push("MATLAB");
+    // Remove duplicate products
+    parsedProducts = [...new Set(parsedProducts)];
+
+    let mpmArguments: string[] = [
+        "install",
+        `--source=${source}`,    
+        `--destination=${destination}`,
+    ];
+    mpmArguments = mpmArguments.concat("--products", ...parsedProducts);
+
+    const exitCode = await exec.exec(mpmPath, mpmArguments).catch(async e => {
+        // Fully remove failed MATLAB installation for self-hosted runners
+        await rmRF(destination);
+        throw e;
+    });
+    if (exitCode !== 0) {
+        await rmRF(destination);
+        return Promise.reject(Error(`Script exited with non-zero code ${exitCode}`));
+    }
+    return
+}

src/mpm.unit.test.ts

@@ -180,4 +180,38 @@ describe("mpm install", () => {
         await expect(mpm.install(mpmPath, releaseInfo, products, destination)).rejects.toBeDefined();
         expect(rmRFMock).toHaveBeenCalledWith(destination);
     });
+
+    it("ideally works when installing from source", async () => {
+        const destination ="/opt/matlab";
+        const source = "/path/to/source";
+        const products = ["MATLAB", "Compiler"];
+        const expectedMpmArgs = [
+            "install",
+            `--source=${source}`,
+            `--destination=${destination}`,
+            "--products",
+            "MATLAB",
+            "Compiler",
+        ]
+        execMock.mockResolvedValue(0);
+
+        await expect(mpm.installFromSource(mpmPath, source, products, destination)).resolves.toBeUndefined();
+        expect(execMock.mock.calls[0][1]).toMatchObject(expectedMpmArgs);
+    });
+
+    it("rejects and cleans on mpm rejection when installing from source", async () => {
+        const destination = "/opt/matlab";
+        const products = ["MATLAB", "Compiler"];
+        execMock.mockRejectedValue(1);
+        await expect(mpm.installFromSource(mpmPath, "/path", products, destination)).rejects.toBeDefined();
+        expect(rmRFMock).toHaveBeenCalledWith(destination);
+    });
+
+    it("rejects and cleans on failed install when installing from source", async () => {
+        const destination = "/opt/matlab";
+        const products = ["MATLAB", "Compiler"];
+        execMock.mockResolvedValue(1);
+        await expect(mpm.installFromSource(mpmPath, "/path", products, destination)).rejects.toBeDefined();
+        expect(rmRFMock).toHaveBeenCalledWith(destination);
+    });
 });