Add latest-including-prerelease option (#137)

* add latest-including-prerelease option

* Update integ-test-promote-template.yml

* add release status to prerelease install

* fix integ test version

* update task description

* fix integ test

* fix integ test

Author: davidbuzinski

integ-test-promote-template.yml

@@ -60,6 +60,27 @@ jobs:
           inputs:
             command: assert(strcmp(version('-release'),'2023a'))
 
+    - job: test_install_latest_including_prerelease_v${{ version }}
+      condition: not(eq(${{ version }}, '0'))
+      strategy:
+        matrix:
+          microsoft_hosted_linux:
+            poolName: Azure Pipelines
+            vmImage: ubuntu-22.04
+      pool:
+        name: $(poolName)
+        vmImage: $(vmImage)
+      steps:
+        - checkout: none
+        - task: MathWorks.matlab-azure-devops-extension-dev.InstallMATLAB.InstallMATLAB@${{ version }}
+          displayName: Install MATLAB
+          inputs:
+            release: latest-including-prerelease
+        - task: MathWorks.matlab-azure-devops-extension-dev.RunMATLABCommand.RunMATLABCommand@${{ version }}
+          displayName: Print MATLAB version
+          inputs:
+            command: version
+
     - job: test_run_command_v${{ version }}
       strategy:
         matrix:

package-lock.json

@@ -12,6 +12,7 @@ export interface Release {
     name: string;
     version: string;
     update: string;
+    isPrerelease: boolean;
 }
 
 export async function makeToolcacheDir(release: Release, platform: string): Promise<[string, boolean]> {
@@ -66,8 +67,11 @@ async function windowsHostedToolpath(release: Release): Promise<string> {
 export async function getReleaseInfo(release: string): Promise<Release> {
     // Get release name from input parameter
     let name: string;
+    let isPrerelease: boolean = false;
     if (release.toLowerCase().trim() === "latest") {
-        name = await resolveLatest();
+        name = await fetchReleaseInfo("latest");
+    } else if (release.toLowerCase().trim() === "latest-including-prerelease") {
+        name = await fetchReleaseInfo("latest-including-prerelease");
     } else {
         const nameMatch = release.toLowerCase().match(/r[0-9]{4}[a-b]/);
         if (!nameMatch) {
@@ -88,18 +92,24 @@ export async function getReleaseInfo(release: string): Promise<Release> {
     } else {
         update = "Latest";
         version += ".999";
+        if (name.includes("prerelease")) {
+            name = name.replace("prerelease", "");
+            version += "-prerelease";
+            isPrerelease = true;
+        }
     }
 
     return {
         name,
         version,
         update,
+        isPrerelease,
     };
 }
 
-async function resolveLatest(): Promise<string> {
+async function fetchReleaseInfo(name: string): Promise<string> {
     return new Promise((resolve, reject) => {
-        https.get("https://ssd.mathworks.com/supportfiles/ci/matlab-release/v0/latest", (resp) => {
+        https.get(`https://ssd.mathworks.com/supportfiles/ci/matlab-release/v0/${name}`, (resp) => {
             if (resp.statusCode !== 200) {
                 reject(Error(`Unable to retrieve latest MATLAB release information. Contact MathWorks at continuous-integration@mathworks.com if the problem persists.`));
             }
@@ -108,6 +118,7 @@ async function resolveLatest(): Promise<string> {
             });
         });
     });
+
 }
 
 export async function setupBatch(platform: string, architecture: string) {

tasks/install-matlab/v1/src/matlab.ts

@@ -58,8 +58,12 @@ export async function install(
         "install",
         `--release=${release.name + release.update}`,
         `--destination=${destination}`,
-        "--products",
     ];
+
+    if (release.isPrerelease) {
+        mpmArguments = mpmArguments.concat("--release-status=Prerelease");
+    }
+    mpmArguments = mpmArguments.concat("--products");
     mpmArguments = mpmArguments.concat(parsedProducts);
 
     const exitCode = await taskLib.exec(mpmPath, mpmArguments);

tasks/install-matlab/v1/src/mpm.ts

@@ -26,6 +26,7 @@ export default function suite() {
         name: "r2023b",
         version: "2023.2.999",
         update: "Latest",
+        isPrerelease: false,
       };
 
       beforeEach(() => {
@@ -300,26 +301,43 @@ export default function suite() {
         mockResp.statusCode = 200;
         stubHttpsGet.callsFake((url, callback) => {
           callback(mockResp);
-          mockResp.emit("data", "r2022b");
+          mockResp.emit("data", "r2024b");
           mockResp.emit("end");
           return Promise.resolve(null);
         });
         const release = await matlab.getReleaseInfo("latest");
-        assert(release.name === "r2022b");
+        assert(release.name === "r2024b");
+        assert(release.isPrerelease === false);
+      });
+
+      it("getReleaseInfo resolves latest-including-prerelease", async () => {
+        const mockResp = new http.IncomingMessage(new net.Socket());
+        mockResp.statusCode = 200;
+        stubHttpsGet.callsFake((url, callback) => {
+          callback(mockResp);
+          mockResp.emit("data", "r2025aprerelease");
+          mockResp.emit("end");
+          return Promise.resolve(null);
+        });
+        const release = await matlab.getReleaseInfo("latest");
+        assert(release.name === "r2025a");
+        assert(release.isPrerelease === true);
       });
 
       it("getReleaseInfo is case insensitive", async () => {
         const release = await matlab.getReleaseInfo("R2022B");
         assert(release.name === "r2022b");
         assert(release.version === "2022.2.999");
         assert(release.update === "Latest");
+        assert(release.isPrerelease === false);
       });
 
       it("getReleaseInfo allows specifying update number", async () => {
         const release = await matlab.getReleaseInfo("R2022au2");
         assert(release.name === "r2022a");
         assert(release.version === "2022.1.2");
         assert(release.update === "u2");
+        assert(release.isPrerelease === false);
       });
 
       it("getReleaseInfo rejects for invalid release input", async () => {

tasks/install-matlab/v1/test/matlab.test.ts

@@ -116,7 +116,7 @@ export default function suite() {
 
         it("install ideally works", async () => {
             const mpmPath = "mpm";
-            const releaseInfo = {name: "r2022b", version: "9.13.0", update: "Latest"};
+            const releaseInfo = {name: "r2022b", version: "9.13.0", update: "Latest", isPrerelease: false};
             const destination = "/opt/matlab";
             const products = "MATLAB Compiler";
             const expectedMpmArgs = [
@@ -133,9 +133,29 @@ export default function suite() {
             });
         });
 
+        it("add --release-status flag for prerelease", async () => {
+            const mpmPath = "mpm";
+            const releaseInfo = {name: "r2025a", version: "9.13.0", update: "Latest", isPrerelease: true};
+            const destination = "/opt/matlab";
+            const products = "MATLAB Compiler";
+            const expectedMpmArgs = [
+                "install",
+                "--release=r2025aLatest",
+                `--destination=${destination}`,
+                "--release-status=Prerelease",
+                "--products",
+                "MATLAB",
+                "Compiler",
+            ];
+            assert.doesNotReject(async () => { mpm.install(mpmPath, releaseInfo, products, destination); });
+            mpm.install(mpmPath, releaseInfo, destination, products).then(() => {
+                assert(stubExec.calledWithMatch(mpmPath, expectedMpmArgs));
+            });
+        });
+
         it("install rejects on failed install", async () => {
             const mpmPath = "mpm";
-            const releaseInfo = {name: "r2022b", version: "9.13.0", update: "latest"};
+            const releaseInfo = {name: "r2022b", version: "9.13.0", update: "latest", isPrerelease: false};
             const destination = "/opt/matlab";
             const products = "MATLAB Compiler";
             stubExec.callsFake((bin, args?) => {