Updates MATLAB installation paths to consistenly use "/opt/matlab/R20XXY" as the default installation path, Silent installer workflows will continue to use "/usr/local/MATLAB" to match the behavior of the standard GUI based installer.

fixes #107

Author: epaganon

.github/workflows/README.md

@@ -18,11 +18,11 @@ Each time the image passes the qualification, it is pushed to the GitHub Contain
 
 `ghcr.io/mathworks-ref-arch/matlab-dockerfile/matlab:${matlab-release}`
 
-where `${matlab-release}` is a matlab release (e.g. `r2021a`, `r2021b`, etc..) .
+where `${matlab-release}` is a matlab release (e.g. `R2021a`, `R2021b`, etc..) .
 
 ## Workflow Description
 
-The workflow consists of a one-dimensional matrix of jobs. Each job builds, tests and publishes the container image for a different MATLAB release, starting from `r2020b`. To ensure that a failure in any job does not cancel other jobs, the `fail-fast` option is set to `false`.
+The workflow consists of a one-dimensional matrix of jobs. Each job builds, tests and publishes the container image for a different MATLAB release, starting from `R2020b`. To ensure that a failure in any job does not cancel other jobs, the `fail-fast` option is set to `false`.
 
 Each job consists of the following steps:
 

.github/workflows/build-test-publish.yml

@@ -12,6 +12,7 @@ on:
       - "Dockerfile"
       - "tests/*"
       - "tests/utils/**"
+      - ".github/workflows/build-test-publish.yml"
       - "!**.md"
   schedule:
     # Run at 00:00 on every Monday (1st Day of the Week)
@@ -27,7 +28,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        matlab-release: [r2024a, r2023b, r2023a, r2022b, r2022a, r2021b, r2021a, r2020b]
+        matlab-release: [R2024a, R2023b, R2023a, R2022b, R2022a, R2021b, R2021a, R2020b]
 
     steps:
       - name: Checkout repo
@@ -70,7 +71,15 @@ jobs:
         env:
           IMAGE_NAME: ${{ env.IMAGE_BASE_NAME }}:${{ matrix.matlab-release }}
         working-directory: tests
-        run: python -m unittest
+        run: python -m unittest -v
 
       - name: Push the image to ghcr.io
-        run: docker push ${{ env.IMAGE_BASE_NAME }}:${{ matrix.matlab-release }}
+        env:
+          MATLAB_RELEASE: ${{ matrix.matlab-release }}
+        run: |
+          LOWERCASE_RELEASE=${MATLAB_RELEASE,,}
+          UPPERCASE_RELEASE=${LOWERCASE_RELEASE^}
+          docker tag ${{ env.IMAGE_BASE_NAME }}:${MATLAB_RELEASE} ${{ env.IMAGE_BASE_NAME }}:${LOWERCASE_RELEASE}
+          docker tag ${{ env.IMAGE_BASE_NAME }}:${MATLAB_RELEASE} ${{ env.IMAGE_BASE_NAME }}:${UPPERCASE_RELEASE}
+          docker push ${{ env.IMAGE_BASE_NAME }}:${LOWERCASE_RELEASE}
+          docker push ${{ env.IMAGE_BASE_NAME }}:${UPPERCASE_RELEASE}

.github/workflows/from-matlab-docker-build-test.yml

@@ -12,6 +12,7 @@ on:
       - "alternates/building-on-matlab-docker-image/Dockerfile"
       - "tests/alternates/building-on-matlab-docker-image/*"
       - "tests/utils/**"
+      - ".github/workflows/from-matlab-docker-build-test.yml"
       - "!**.md"
   schedule:
     # Run at 00:00 on every Monday (1st Day of the Week)
@@ -28,7 +29,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        matlab-release: [r2024a, r2023b, r2023a, r2022b, r2022a]
+        matlab-release: [R2024a, R2023b, R2023a, R2022b, R2022a]
 
     steps:
       - name: Checkout repo

.github/workflows/matlab-container-offline-install-build-test.yml

@@ -13,6 +13,7 @@ on:
       - "alternates/matlab-container-offline-install/Dockerfile"
       - "tests/alternates/matlab-container-offline-install/*"
       - "tests/utils/**"
+      - ".github/workflows/matlab-container-offline-install-build-test.yml"
       - "!**.md"
   schedule:
     # Run at 00:00 on every Monday (1st Day of the Week)
@@ -31,7 +32,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        matlab-release: [r2024a, r2023b, r2023a, r2022b, r2022a, r2021b, r2021a, r2020b]
+        matlab-release: [R2024a, R2023b, R2023a, R2022b, R2022a, R2021b, R2021a, R2020b]
 
     steps:
       - name: Checkout repo
@@ -87,6 +88,4 @@ jobs:
         working-directory: tests
         env:
           IMAGE_NAME: ${{ env.IMAGE_BASE_NAME }}:${{ matrix.matlab-release }}
-        run: |
-          python -m unittest ${{ env.ALT_PATH }}/test_container.py
-          python -m unittest ${{ env.ALT_PATH }}/test_installed_products.py
+        run: python -m unittest -v ${{ env.ALT_PATH }}/*.py

.github/workflows/matlab-installer-build-test.yml

@@ -12,6 +12,7 @@ on:
       - "alternates/matlab-installer/Dockerfile"
       - "tests/alternates/matlab-installer/*"
       - "tests/utils/**"
+      - ".github/workflows/matlab-installer-build-test.yml"
       - "!**.md"
   schedule:
     # Run at 00:00 on every Monday (1st Day of the Week)
@@ -30,7 +31,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        matlab-release: [r2024a, r2023b, r2023a, r2022b, r2022a, r2021b, r2021a, r2020b]
+        matlab-release: [R2024a, R2023b, R2023a, R2022b, R2022a, R2021b, R2021a, R2020b]
 
     steps:
       - name: Checkout repo
@@ -71,4 +72,4 @@ jobs:
         working-directory: tests
         env:
           IMAGE_NAME: ${{ env.IMAGE_BASE_NAME }}:${{ matrix.matlab-release }}
-        run: python -m unittest ${{ env.ALT_PATH }}/test_mock_matlab_container.py
+        run: python -m unittest -v ${{ env.ALT_PATH }}/*.py

.github/workflows/non-interactive-build-test.yml

@@ -10,15 +10,16 @@ on:
     # Trigger the workflow when the Dockerfile or any file under tests/ is modified
     paths:
       - "alternates/non-interactive/Dockerfile"
-      - "alternates/non-interactive/MATLAB-BATCH.md"
-      - "tests/**"
+      - "tests/alternates/non-interactive/*"
+      - "tests/utils/**"
+      - ".github/workflows/non-interactive-build-test.yml"
       - "!**.md"
   schedule:
     # Run at 00:00 on every Monday (1st Day of the Week)
     - cron: "0 0 * * 1"
 
 env:
-  IMAGE_BASE_NAME: matlab-non-interactive
+  IMAGE_BASE_NAME: ghcr.io/${{ github.repository }}/matlab-non-interactive
   ALT_PATH: alternates/non-interactive
 
 jobs:
@@ -28,7 +29,7 @@ jobs:
       fail-fast: false
       matrix:
         matlab-release:
-          [r2024a, r2023b, r2023a, r2022b, r2022a, r2021b, r2021a, r2020b]
+          [R2024a, R2023b, R2023a, R2022b, R2022a, R2021b, R2021a, R2020b]
 
     steps:
       - name: Checkout repo
@@ -63,5 +64,15 @@ jobs:
         env:
           IMAGE_NAME: ${{ env.IMAGE_BASE_NAME }}:${{ matrix.matlab-release }}
           BATCH_TOKEN: ${{ secrets.MATLAB_BATCH_TOKEN_EXPIRES_03_2025 }}
+        run: python -m unittest -v ${{ env.ALT_PATH }}/*.py
+
+      - name: Push the image to ghcr.io
+        env:
+          MATLAB_RELEASE: ${{ matrix.matlab-release }}
         run: |
-          python -m unittest ${{ env.ALT_PATH }}/test_matlabbatch.py
+          LOWERCASE_RELEASE=${MATLAB_RELEASE,,}
+          UPPERCASE_RELEASE=${LOWERCASE_RELEASE^}
+          docker tag ${{ env.IMAGE_BASE_NAME }}:${MATLAB_RELEASE} ${{ env.IMAGE_BASE_NAME }}:${LOWERCASE_RELEASE}
+          docker tag ${{ env.IMAGE_BASE_NAME }}:${MATLAB_RELEASE} ${{ env.IMAGE_BASE_NAME }}:${UPPERCASE_RELEASE}
+          docker push ${{ env.IMAGE_BASE_NAME }}:${LOWERCASE_RELEASE}
+          docker push ${{ env.IMAGE_BASE_NAME }}:${UPPERCASE_RELEASE}

Dockerfile

@@ -4,15 +4,15 @@
 # install, and the location at which to install MATLAB.
 
 # Here is an example docker build command with the optional build arguments.
-# docker build --build-arg MATLAB_RELEASE=r2024a 
+# docker build --build-arg MATLAB_RELEASE=R2024a 
 #              --build-arg MATLAB_PRODUCT_LIST="MATLAB Deep_Learning_Toolbox Symbolic_Math_Toolbox"
 #              --build-arg MATLAB_INSTALL_LOCATION="/opt/matlab/R2024a"
 #              --build-arg LICENSE_SERVER=12345@hostname.com 
 #              -t my_matlab_image_name .
 
 # To specify which MATLAB release to install in the container, edit the value of the MATLAB_RELEASE argument.
-# Use lowercase to specify the release, for example: ARG MATLAB_RELEASE=r2021b
-ARG MATLAB_RELEASE=r2024a
+# Use uppercase to specify the release, for example: ARG MATLAB_RELEASE=R2021b
+ARG MATLAB_RELEASE=R2024a
 
 # Specify the list of products to install into MATLAB.
 ARG MATLAB_PRODUCT_LIST="MATLAB"

README.md

@@ -27,12 +27,12 @@ cd matlab-dockerfile
 
 Build container with a name and tag of your choice.
 ```bash
-docker build -t matlab:r2024a .
+docker build -t matlab:R2024a .
 ```
 
 Run the container. Test the container by running an example MATLAB command such as ver.
 ```bash
-docker run --init --rm -e MLM_LICENSE_FILE=27000@MyServerName matlab:r2024a -batch ver
+docker run --init --rm -e MLM_LICENSE_FILE=27000@MyServerName matlab:R2024a -batch ver
 ```
 The [Dockerfile](https://github.com/mathworks-ref-arch/matlab-dockerfile/blob/main/Dockerfile) defaults to building a container for MATLAB R2024a.
 
@@ -57,9 +57,9 @@ The [Dockerfile](https://github.com/mathworks-ref-arch/matlab-dockerfile/blob/ma
 
 | Argument Name | Default value | Description |
 |---|---|---|
-| [MATLAB_RELEASE](#build-an-image-for-a-different-release-of-matlab) | r2024a | The MATLAB release you want to install, in lower-case. For example: `r2019b`|
+| [MATLAB_RELEASE](#build-an-image-for-a-different-release-of-matlab) | R2024a | The MATLAB release you want to install, in lower-case. For example: `R2019b`|
 | [MATLAB_PRODUCT_LIST](#build-an-image-with-a-specific-set-of-products) | MATLAB | Products to install as a space-separated list. For more information, see [MPM.md](https://github.com/mathworks-ref-arch/matlab-dockerfile/blob/main/MPM.md). For example: `MATLAB Simulink Deep_Learning_Toolbox Fixed-Point_Designer`|
-| [MATLAB_INSTALL_LOCATION](#build-an-image-with-matlab-installed-to-a-specific-location) | /opt/matlab/r2024a | The path to install MATLAB. |
+| [MATLAB_INSTALL_LOCATION](#build-an-image-with-matlab-installed-to-a-specific-location) | /opt/matlab/R2024a | The path to install MATLAB. |
 | [LICENSE_SERVER](#build-an-image-configured-to-use-a-license-server) | *unset* | The port and hostname of the machine that is running the Network License Manager, using the `port@hostname` syntax. For example: `27000@MyServerName` |
 
 Use these arguments with the the `docker build` command to customize your image.
@@ -68,30 +68,30 @@ Alternatively, you can change the default values for these arguments directly in
 #### Build an Image for a Different Release of MATLAB
 For example, to build an image for MATLAB R2019b, use this command.
 ```bash
-docker build --build-arg MATLAB_RELEASE=r2019b -t matlab:r2019b .
+docker build --build-arg MATLAB_RELEASE=R2019b -t matlab:R2019b .
 ```
 
 #### Build an Image with a specific set of products
 For example, to build an image with MATLAB and Simulink®, use this command.
 ```bash
-docker build --build-arg MATLAB_PRODUCT_LIST='MATLAB Simulink' -t matlab:r2024a .
+docker build --build-arg MATLAB_PRODUCT_LIST='MATLAB Simulink' -t matlab:R2024a .
 ```
 
 #### Build an Image with MATLAB installed to a specific location
 For example, to build an image with MATLAB installed at /opt/matlab, use this command.
 ```bash
-docker build --build-arg MATLAB_INSTALL_LOCATION='/opt/matlab' -t matlab:r2024a .
+docker build --build-arg MATLAB_INSTALL_LOCATION='/opt/matlab' -t matlab:R2024a .
 ```
 
 #### Build an Image Configured to Use a License Server
 
 Including the license server information with the `docker build` command means you do not have to pass it when running the container.
 ```bash
 # Build container with the License Server.
-docker build --build-arg LICENSE_SERVER=27000@MyServerName -t matlab:r2024a .
+docker build --build-arg LICENSE_SERVER=27000@MyServerName -t matlab:R2024a .
 
 # Run the container, without needing to pass license information.
-docker run --init --rm matlab:r2024a -batch ver
+docker run --init --rm matlab:R2024a -batch ver
 ```
 
 ## Use the Network License Manager
@@ -124,7 +124,7 @@ With the `docker build` command, either:
 
     ```bash
     # Example
-    docker build -t matlab:r2024a --build-arg LICENSE_SERVER=27000@MyServerName .
+    docker build -t matlab:R2024a --build-arg LICENSE_SERVER=27000@MyServerName .
     ```
 - Use the `network.lic` file:
     1. Place the `network.lic` file in the same folder as the Dockerfile.
@@ -133,41 +133,41 @@ With the `docker build` command, either:
 
     ```bash
     # Example
-    docker build -t matlab:r2024a .
+    docker build -t matlab:R2024a .
     ```
 
 With the `docker run` command, use the `MLM_LICENSE_FILE` environment variable. For example:
 
 ```bash
-docker run --init --rm -e MLM_LICENSE_FILE=27000@MyServerName matlab:r2024a -batch ver
+docker run --init --rm -e MLM_LICENSE_FILE=27000@MyServerName matlab:R2024a -batch ver
 ```
 
 ## Run the Container
 If you did not provide the license server information when building the image, then provide it when running the container. Set the environment variable `MLM_LICENSE_FILE` using the `-e` flag, with the  network license manager's location in the format `port@hostname`.
 
 ```bash
 # Start MATLAB, print version information, and exit:
-docker run --init --rm -e MLM_LICENSE_FILE=27000@MyServerName matlab:r2024a -batch ver
+docker run --init --rm -e MLM_LICENSE_FILE=27000@MyServerName matlab:R2024a -batch ver
 ```
 
 You can run the container **without** specifying `MLM_LICENSE_FILE` if you provided the license server information when building the image, as shown in the examples below.
 
 ### Run MATLAB in an Interactive Command Prompt
 To start the container and run MATLAB in an interactive command prompt, execute:
 ```bash
-docker run --init -it --rm matlab:r2024a
+docker run --init -it --rm matlab:R2024a
 ```
 ### Run MATLAB in Batch Mode
 To start the container, run a MATLAB command, and then exit, execute:
 ```bash
 # Container runs the command RAND in MATLAB and exits.
-docker run --init --rm matlab:r2024a -batch rand
+docker run --init --rm matlab:R2024a -batch rand
 ```
 
 ### Run MATLAB with Startup Options
 To override the default behavior of the container and run MATLAB with any set of arguments, such as `-logfile`, execute:
 ```bash
-docker run --init -it --rm matlab:r2024a -logfile "logfilename.log"
+docker run --init -it --rm matlab:R2024a -logfile "logfilename.log"
 ```
 To learn more, see the documentation: [Commonly Used Startup Options](https://www.mathworks.com/help/matlab/matlab_env/commonly-used-startup-options.html).
 

alternates/building-on-matlab-docker-image/Dockerfile

@@ -1,8 +1,8 @@
 # Copyright 2023-2024 The MathWorks, Inc.
 
 # To specify which MATLAB release to install in the container, edit the value of the MATLAB_RELEASE argument.
-# Use lower case to specify the release, for example: ARG MATLAB_RELEASE=r2021b
-ARG MATLAB_RELEASE=r2024a
+# Use uppercase to specify the release, for example: ARG MATLAB_RELEASE=R2021b
+ARG MATLAB_RELEASE=R2024a
 
 # Specify the extra products to install into the image. These products can either be toolboxes or support packages.
 ARG ADDITIONAL_PRODUCTS="Symbolic_Math_Toolbox Deep_Learning_Toolbox_Model_for_ResNet-50_Network"

alternates/building-on-matlab-docker-image/README.md

@@ -25,18 +25,18 @@ cd matlab-dockerfile/alternates/building-on-matlab-docker-image
 ### Quick start
 Build a container with a name and tag.
 ```bash
-docker build -t matlab_with_add_ons:r2024a .
+docker build -t matlab_with_add_ons:R2024a .
 ```
 
 You can then run the container with the "batch" option. Test the container by running an example MATLAB command such as `ver` to display the installed toolboxes.
 ```bash
-docker run --init --rm -e MLM_LICENSE_FILE=27000@MyServerName matlab_with_add_ons:r2024a -batch ver
+docker run --init --rm -e MLM_LICENSE_FILE=27000@MyServerName matlab_with_add_ons:R2024a -batch ver
 ```
 You can check the installed support packages using the MATLAB command `matlabshared.supportpkg.getInstalled`.
 
 You can also run the container with the "browser" option to access MATLAB in a browser.
 ```bash
-docker run --init --rm -it -p 8888:8888 matlab_with_add_ons:r2024a -browser
+docker run --init --rm -it -p 8888:8888 matlab_with_add_ons:R2024a -browser
 ```
 For more information, see [Run the Container](#run-the-container).
 
@@ -51,7 +51,7 @@ The `ADDITIONAL_PRODUCTS` argument must be a space separated list surrounded by
 By default, `ADDITIONAL_PRODUCTS` includes example products, which you can replace.
 For example, to build an image containing MATLAB and the Deep Learning Toolbox™:
 ```bash
-docker build --build-arg ADDITIONAL_PRODUCTS="Deep_Learning_Toolbox" -t matlab_with_add_ons:r2024a .
+docker build --build-arg ADDITIONAL_PRODUCTS="Deep_Learning_Toolbox" -t matlab_with_add_ons:R2024a .
 ```
 
 For a successful build, include at least one product.
@@ -67,7 +67,7 @@ The [Dockerfile](https://github.com/mathworks-ref-arch/matlab-dockerfile/blob/ma
 
 | Argument Name | Default value | Effect |
 |---|---|---|
-| [MATLAB_RELEASE](#build-an-image-for-a-different-release-of-matlab) | r2024a | The MATLAB release to install. Must be lower-case, for example: `r2020b`.|
+| [MATLAB_RELEASE](#build-an-image-for-a-different-release-of-matlab) | R2024a | The MATLAB release to install. Must be lower-case, for example: `R2020b`.|
 | [ADDITIONAL_PRODUCTS](#customize-products-to-install-using-matlab-package-manager-mpm) | "Symbolic_Math_Toolbox Deep_Learning_Toolbox_Model_for_ResNet-50_Network" | A space separated list of toolboxes and support packages to install. For more details, see  [MATLAB Package Manager](https://github.com/mathworks-ref-arch/matlab-dockerfile/blob/main/MPM.md)|
 | [LICENSE_SERVER](#build-an-image-with-license-server-information) | *unset* | The port and hostname of a machine that is running a Network License Manager, using the `port@hostname` syntax. For example: `27000@MyServerName`. To use this build argument, the corresponding lines must be uncommented in the Dockerfile. |
 
@@ -79,12 +79,12 @@ directly in the Dockerfile.
 
 For example, to build an image for MATLAB R2022b, use the following command.
 ```bash
-docker build --build-arg MATLAB_RELEASE=r2022b -t matlab_with_add_ons:r2022b .
+docker build --build-arg MATLAB_RELEASE=R2022b -t matlab_with_add_ons:R2022b .
 ```
 
 To build an image for MATLAB R2022b with Deep Learning Toolbox and Parallel Computing Toolbox™, use the following command.
 ```bash
-docker build --build-arg MATLAB_RELEASE=r2022b --build-arg ADDITIONAL_PRODUCTS="Deep_Learning_Toolbox Parallel_Computing_Toolbox" -t matlab_with_add_ons:r2022b .
+docker build --build-arg MATLAB_RELEASE=R2022b --build-arg ADDITIONAL_PRODUCTS="Deep_Learning_Toolbox Parallel_Computing_Toolbox" -t matlab_with_add_ons:R2022b .
 ```
 For supported releases see [MATLAB Container Image on Docker Hub](https://hub.docker.com/r/mathworks/matlab).
 ### Build an Image with License Server Information
@@ -95,12 +95,12 @@ server or browser mode will not start successfully.
 
 Build container with the License Server.
 ```bash
-docker build -t matlab_with_add_ons:r2024a --build-arg LICENSE_SERVER=27000@MyServerName .
+docker build -t matlab_with_add_ons:R2024a --build-arg LICENSE_SERVER=27000@MyServerName .
 ```
 
 Run the container, without needing to pass license information.
 ```bash
-docker run --init matlab_with_add_ons:r2024a -batch ver
+docker run --init matlab_with_add_ons:R2024a -batch ver
 ```
 ## Run the Container
 The Docker container you build using this Dockerfile inherits run options from its base image.

alternates/matlab-container-offline-install/Dockerfile

@@ -4,14 +4,14 @@
 # install, and the location at which to install MATLAB.
 
 # Here is an example docker build command with the optional build arguments.
-# docker build --build-arg MATLAB_RELEASE=r2024a 
+# docker build --build-arg MATLAB_RELEASE=R2024a 
 #              --build-arg MATLAB_PRODUCT_LIST="MATLAB Deep_Learning_Toolbox Symbolic_Math_Toolbox"
 #              --build-arg MATLAB_INSTALL_LOCATION="/opt/matlab/R2024a"
 #              -t my_matlab_image_name .
 
 # To specify which MATLAB release to install in the container, edit the value of the MATLAB_RELEASE argument.
-# Use lowercase to specify the release, for example: ARG MATLAB_RELEASE=r2021b
-ARG MATLAB_RELEASE=r2024a
+# Use uppercase to specify the release, for example: ARG MATLAB_RELEASE=R2021b
+ARG MATLAB_RELEASE=R2024a
 
 # Specify the list of products to install into MATLAB.
 ARG MATLAB_PRODUCT_LIST="MATLAB"

alternates/matlab-container-offline-install/README.md

@@ -26,7 +26,7 @@ You can then store the generated Docker build and copy it to the offline or air-
 
 Build the archive image with a name and tag.
 ```bash
-docker build -t mpm-archive:r2024a -f archive.Dockerfile .
+docker build -t mpm-archive:R2024a -f archive.Dockerfile .
 ```
 
 By default, the [archive.Dockerfile](archive.Dockerfile) downloads the latest available MATLAB release without any additional toolboxes or products.
@@ -41,7 +41,7 @@ To run this step in an offline or air-gapped environment, you need:
 
 Build a container with a name and tag.
 ```bash
-DOCKER_BUILDKIT=1 docker build -t matlab-from-source:r2024a .
+DOCKER_BUILDKIT=1 docker build -t matlab-from-source:R2024a .
 ```
 
 To customize the build of the product image, refer to [Customize the Product Docker Image](#customize-the-product-docker-image).
@@ -54,7 +54,7 @@ The [archive.Dockerfile](archive.Dockerfile) supports the following Docker build
 
 | Argument Name | Default value | Effect |
 |---|---|---|
-| [MATLAB_RELEASE](#build-an-archive-image-for-a-different-release-of-matlab) | r2024a | The MATLAB release you want to install, in lower-case. For example: `r2022a` |
+| [MATLAB_RELEASE](#build-an-archive-image-for-a-different-release-of-matlab) | R2024a | The MATLAB release you want to install, in lower-case. For example: `R2022a` |
 | [MATLAB_PRODUCT_LIST](#build-an-archive-image-with-a-specific-set-of-products) | MATLAB | Products to install as a space-separated list. For more information, see [MPM.md](../../MPM.md). For example: `MATLAB Simulink Deep_Learning_Toolbox Fixed-Point_Designer` |
 
 Use these arguments with the `docker build` command to customize your image.
@@ -64,25 +64,25 @@ Alternatively, you can change the default values for these arguments directly in
 
 For example, to build an archive image for MATLAB R2023b installation files, use the following command.
 ```bash
-docker build --build-arg MATLAB_RELEASE=r2023b -t mpm-archive:r2023b -f archive.Dockerfile .
+docker build --build-arg MATLAB_RELEASE=R2023b -t mpm-archive:R2023b -f archive.Dockerfile .
 ```
 
 #### Build an Archive Image with a specific set of products
 
 For example, to build an image with MATLAB and the Statistics and Machine Learning Toolbox™ installation files, use this command.
 ```bash
-docker build --build-arg MATLAB_PRODUCT_LIST="MATLAB Statistics_and_Machine_Learning_Toolbox" -t mpm-archive:r2024a -f archive.Dockerfile .
+docker build --build-arg MATLAB_PRODUCT_LIST="MATLAB Statistics_and_Machine_Learning_Toolbox" -t mpm-archive:R2024a -f archive.Dockerfile .
 ```
 
 ### Customize the Product Docker Image
 The [Dockerfile](Dockerfile) supports the following Docker build-time variables:
 
 | Argument Name | Default value | Effect |
 |---|---|---|
-| [MATLAB_RELEASE](#build-an-image-for-a-different-release-of-matlab) | r2024a | The MATLAB release you want to install, in lower-case. For example: `r2022a`. :warning: This release must match the `MATLAB_RELEASE` you use to build the archive image. |
+| [MATLAB_RELEASE](#build-an-image-for-a-different-release-of-matlab) | R2024a | The MATLAB release you want to install, in lower-case. For example: `R2022a`. :warning: This release must match the `MATLAB_RELEASE` you use to build the archive image. |
 | [MATLAB_PRODUCT_LIST](#build-an-image-with-a-specific-set-of-products) | MATLAB | Products to install as a space-separated list. For more information, see [MPM.md](../../MPM.md). For example: `MATLAB Simulink Deep_Learning_Toolbox Fixed-Point_Designer`. The list of products to install must be a subset of the installation files available in the archive image. |
-| [MATLAB_INSTALL_LOCATION](#build-an-image-with-matlab-installed-to-a-specific-location) | /opt/matlab/r2024a | The path to install MATLAB. |
-| [ARCHIVE_BASE_IMAGE](#build-an-image-from-a-different-archive) | mpm-archive:r2024a | The name of the Docker® image containing the product installation files. |
+| [MATLAB_INSTALL_LOCATION](#build-an-image-with-matlab-installed-to-a-specific-location) | /opt/matlab/R2024a | The path to install MATLAB. |
+| [ARCHIVE_BASE_IMAGE](#build-an-image-from-a-different-archive) | mpm-archive:R2024a | The name of the Docker® image containing the product installation files. |
 | [LICENSE_SERVER](#build-an-image-configured-to-use-a-license-server) | *unset* | The port and hostname of the machine that is running the Network License Manager, using the `port@hostname` syntax. For example: `27000@MyServerName` |
 
 Use these arguments with the `docker build` command to customize your image.
@@ -93,40 +93,40 @@ Alternatively, you can change the default values for these arguments directly in
 
 For example, to build an image for MATLAB R2023b, use the following command.
 ```bash
-docker build --build-arg MATLAB_RELEASE=r2023b --build-arg ARCHIVE_BASE_IMAGE=mpm-archive:r2023b -t matlab-from-source:r2023b .
+docker build --build-arg MATLAB_RELEASE=R2023b --build-arg ARCHIVE_BASE_IMAGE=mpm-archive:R2023b -t matlab-from-source:R2023b .
 ```
 Ensure that the release of the archive base image you set in `ARCHIVE_BASE_IMAGE` matches the one in `MATLAB_RELEASE`.
 
 ### Build an Image with a Specific Set of Products
 
 For example, to build an image with MATLAB and the Statistics and Machine Learning Toolbox, use this command.
 ```bash
-docker build --build-arg MATLAB_PRODUCT_LIST="MATLAB Statistics_and_Machine_Learning_Toolbox" -t matlab-stats-from-source:r2024a .
+docker build --build-arg MATLAB_PRODUCT_LIST="MATLAB Statistics_and_Machine_Learning_Toolbox" -t matlab-stats-from-source:R2024a .
 ```
 
 ### Build an Image with MATLAB Installed to a Specific Location
 
 For example, to build an image with MATLAB installed at `/opt/matlab`, use this command.
 ```bash
-docker build --build-arg MATLAB_INSTALL_LOCATION="/opt/matlab" -t matlab-from-source:r2024a .
+docker build --build-arg MATLAB_INSTALL_LOCATION="/opt/matlab" -t matlab-from-source:R2024a .
 ```
 
 ### Build an Image from a Different Archive
 
 For example, to build an image using a different archive image, use the following command.
 ```bash
-docker build  --build-arg ARCHIVE_BASE_IMAGE=my-archive -t matlab-from-source:r2024a .
+docker build  --build-arg ARCHIVE_BASE_IMAGE=my-archive -t matlab-from-source:R2024a .
 ```
 
 #### Build an Image Configured to Use a License Server
 
 Including the license server information with the `docker build` command means you do not have to pass it when running the container.
 ```bash
 # Build container with the License Server.
-docker build --build-arg LICENSE_SERVER=27000@MyServerName -t matlab-from-source:r2024a .
+docker build --build-arg LICENSE_SERVER=27000@MyServerName -t matlab-from-source:R2024a .
 
 # Run the container, without needing to pass license information.
-docker run --init --rm matlab-from-source:r2024a -batch ver
+docker run --init --rm matlab-from-source:R2024a -batch ver
 ```
 
 For more information, see [Use the Network License Manager](../../README.md#use-the-network-license-manager).

alternates/matlab-container-offline-install/archive.Dockerfile

@@ -1,14 +1,14 @@
 # Copyright 2024 The MathWorks, Inc.
 
 # Here is an example docker build command with the optional build arguments.
-# docker build --build-arg MATLAB_RELEASE=r2024a 
+# docker build --build-arg MATLAB_RELEASE=R2024a 
 #              --build-arg MATLAB_PRODUCT_LIST="MATLAB Deep_Learning_Toolbox Symbolic_Math_Toolbox"
 #              -f archive.Dockerfile
 #              -t mpm-archive .
 
 # To specify which MATLAB release to install in the container, edit the value of the MATLAB_RELEASE argument.
-# Use lowercase to specify the release, for example: ARG MATLAB_RELEASE=r2021b
-ARG MATLAB_RELEASE=r2024a
+# Use uppercase to specify the release, for example: ARG MATLAB_RELEASE=R2021b
+ARG MATLAB_RELEASE=R2024a
 
 # Specify the list of products to install into MATLAB.
 ARG MATLAB_PRODUCT_LIST="MATLAB"

alternates/non-interactive/Dockerfile

@@ -4,14 +4,14 @@
 # version of MATLAB, list of products to install, and the location at which to install MATLAB.
 
 # Here is an example docker build command with the optional build arguments.
-# docker build --build-arg MATLAB_RELEASE=r2024a
+# docker build --build-arg MATLAB_RELEASE=R2024a
 #              --build-arg MATLAB_PRODUCT_LIST="MATLAB Deep_Learning_Toolbox Symbolic_Math_Toolbox"
 #              --build-arg MATLAB_INSTALL_LOCATION="/opt/matlab/R2024a"
 #              -t my_matlab_image_name .
 
 # To specify which MATLAB release to install in the container, edit the value of the MATLAB_RELEASE argument.
-# Use lowercase to specify the release, for example: ARG MATLAB_RELEASE=r2021b
-ARG MATLAB_RELEASE=r2024a
+# Use uppercase to specify the release, for example: ARG MATLAB_RELEASE=R2021b
+ARG MATLAB_RELEASE=R2024a
 
 # Specify the list of products to install into MATLAB.
 ARG MATLAB_PRODUCT_LIST="MATLAB"

alternates/non-interactive/README.md

@@ -26,12 +26,12 @@ cd matlab-dockerfile/alternates/non-interactive
 
 Build a container with a name and tag.
 ```bash
-docker build -t matlab-non-interactive:r2024a .
+docker build -t matlab-non-interactive:R2024a .
 ```
 
 You can then run the container and use the `matlab-batch` command. Test the container by running an example MATLAB command such as `rand`.
 ```bash
-docker run --init --rm matlab-non-interactive:r2024a matlab-batch -licenseToken "user@email.com|encodedToken" "rand"
+docker run --init --rm matlab-non-interactive:R2024a matlab-batch -licenseToken "user@email.com|encodedToken" "rand"
 ```
 For more information, see [Run the Container](#run-the-container).
 
@@ -46,9 +46,9 @@ The [Dockerfile](Dockerfile) supports the following Docker build-time variables:
 
 | Argument Name | Default value | Effect |
 |---|---|---|
-| [MATLAB_RELEASE](#build-an-image-for-a-different-release-of-matlab) | r2024a | The MATLAB release you want to install, in lower-case. For example: `r2022a` |
+| [MATLAB_RELEASE](#build-an-image-for-a-different-release-of-matlab) | R2024a | The MATLAB release you want to install, in lower-case. For example: `R2022a` |
 | [MATLAB_PRODUCT_LIST](#build-an-image-with-a-specific-set-of-products) | MATLAB | Products to install as a space-separated list. For more information, see [MPM.md](../../MPM.md). For example: `MATLAB Simulink Deep_Learning_Toolbox Fixed-Point_Designer` |
-| [MATLAB_INSTALL_LOCATION](#build-an-image-with-matlab-installed-to-a-specific-location) | /opt/matlab/r2024a | The path to install MATLAB. |
+| [MATLAB_INSTALL_LOCATION](#build-an-image-with-matlab-installed-to-a-specific-location) | /opt/matlab/R2024a | The path to install MATLAB. |
 
 Use these arguments with the `docker build` command to customize your image.
 Alternatively, the default values for these arguments can be changed directly in the [Dockerfile](Dockerfile).
@@ -57,7 +57,7 @@ Alternatively, the default values for these arguments can be changed directly in
 
 For example, to build an image for MATLAB R2021b, use the following command.
 ```bash
-docker build --build-arg MATLAB_RELEASE=r2021b -t matlab-non-interactive:r2021b .
+docker build --build-arg MATLAB_RELEASE=R2021b -t matlab-non-interactive:R2021b .
 ```
 
 For supported releases see [MATLAB Batch Licensing support](MATLAB-BATCH.md#limitations).
@@ -66,14 +66,14 @@ For supported releases see [MATLAB Batch Licensing support](MATLAB-BATCH.md#limi
 
 For example, to build an image with MATLAB and the Statistics and Machine Learning Toolbox, use this command.
 ```bash
-docker build --build-arg MATLAB_PRODUCT_LIST="MATLAB Statistics_and_Machine_Learning_Toolbox" -t matlab-stats-non-interactive:r2024a .
+docker build --build-arg MATLAB_PRODUCT_LIST="MATLAB Statistics_and_Machine_Learning_Toolbox" -t matlab-stats-non-interactive:R2024a .
 ```
 
 ### Build an Image with MATLAB installed to a specific location
 
 For example, to build an image with MATLAB installed at `/opt/matlab`, use this command.
 ```bash
-docker build --build-arg MATLAB_INSTALL_LOCATION="/opt/matlab" -t matlab-non-interactive:r2024a .
+docker build --build-arg MATLAB_INSTALL_LOCATION="/opt/matlab" -t matlab-non-interactive:R2024a .
 ```
 
 ## Use MATLAB Batch Licensing
@@ -86,22 +86,22 @@ With the `docker run` command, either:
 - Specify the `-licenseToken` run-arg.
     ```bash
     # Example
-    docker run --init --rm matlab-non-interactive:r2024a matlab-batch -licenseToken "user@email.com|encodedToken" "disp('Hello, World.')"
+    docker run --init --rm matlab-non-interactive:R2024a matlab-batch -licenseToken "user@email.com|encodedToken" "disp('Hello, World.')"
     ```
 
 - Specify the `MLM_LICENSE_TOKEN` environment variable.
     ```bash
     # Example
     export MLM_LICENSE_TOKEN="user@email.com|encodedToken"
-    docker run --init --rm -e MLM_LICENSE_TOKEN matlab-non-interactive:r2024a matlab-batch "disp('Hello, World.')"
+    docker run --init --rm -e MLM_LICENSE_TOKEN matlab-non-interactive:R2024a matlab-batch "disp('Hello, World.')"
     ```
 
 ## Run the Container
 This Dockerfile's default entrypoint is a shell session. Once you start the container, use `matlab-batch` to start MATLAB with a MATLAB batch licensing token.
 
 ```bash
 # Launch MATLAB, print Hello, World., and exit:
-docker run --init --rm matlab-non-interactive:r2024a matlab-batch -licenseToken "user@email.com|encodedToken" "disp('Hello, World.')"
+docker run --init --rm matlab-non-interactive:R2024a matlab-batch -licenseToken "user@email.com|encodedToken" "disp('Hello, World.')"
 ```
 
 You can set your MATLAB batch licensing token at the container level by setting the `MLM_LICENSE_TOKEN` environment variable, as shown in the examples below.
@@ -111,15 +111,15 @@ To start the container, run a MATLAB command and exit, execute:
 ```bash
 # Container runs the command RAND in MATLAB and exits.
 export MLM_LICENSE_TOKEN="user@email.com|encodedToken"
-docker run --init --rm -e MLM_LICENSE_TOKEN matlab-non-interactive:r2024a matlab-batch rand
+docker run --init --rm -e MLM_LICENSE_TOKEN matlab-non-interactive:R2024a matlab-batch rand
 ```
 
 ### Run a MATLAB script
 To start the container, run a MATLAB script and exit, execute:
 ```bash
 # Container runs the script myscript.m in MATLAB and exits.
 export MLM_LICENSE_TOKEN="user@email.com|encodedToken"
-docker run --init --rm -v $(pwd):/content -w /content -e MLM_LICENSE_TOKEN matlab-non-interactive:r2024a matlab-batch "myscript"
+docker run --init --rm -v $(pwd):/content -w /content -e MLM_LICENSE_TOKEN matlab-non-interactive:R2024a matlab-batch "myscript"
 ```
 
 ## More MATLAB Docker Resources

tests/README.md

@@ -20,7 +20,7 @@ To run the tests, set the following environment variables:
 
 | Environment Variable | Example                                 | Notes                                                                                                                                                                                                                  |
 | -------------------- | --------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `IMAGE_NAME`         | `IMAGE_NAME=matlab-docker-image:r2020a` | The tests will run against the Docker image named `${IMAGE_NAME}`. If no such image is found, the tests will fail.                                                                                         |
+| `IMAGE_NAME`         | `IMAGE_NAME=matlab-docker-image:R2020a` | The tests will run against the Docker image named `${IMAGE_NAME}`. If no such image is found, the tests will fail.                                                                                         |
 | `LICENSE_FILE_PATH`  | `LICENSE_FILE_PATH=path/to/license.lic` | Some tests will attempt to run MATLAB® in the Docker container and require a license file. Store the path to the license file in `${LICENSE_FILE_PATH}` |
 
 ## Structure of the Tests
@@ -75,7 +75,7 @@ To run the tests:
    ```
 3. Build the Docker image that you want to test.
    ```bash
-   docker build -t <your_image_name> --build-args MATLAB_RELASE=<r20xxx> .
+   docker build -t <your_image_name> --build-args MATLAB_RELASE=<R20xxx> .
    ```
    This operation might take a few minutes.
 4. Change current working folder to the tests folder.

tests/alternates/matlab-installer/test_failing_build.py

@@ -19,7 +19,7 @@ def setUpClass(cls):
         # set a matlab release different from the one set in VersionInfo.xml (latest)
         # matlab_release should be a valid tag for the matlab-deps image.
         # E.g., matlab-deps:latest is valid, matlab-deps:r1999b is not
-        cls.old_matlab_release = "r2019b"
+        cls.old_matlab_release = "R2019b"
         cls.dockerfile_dirpath = str(
             Path(__file__).parents[3] / helpers.get_alternates_path()
         )

tests/utils/helpers.py

@@ -38,7 +38,7 @@ def get_alternates_path():
 
 def get_release_from_string(string):
     """Get the release from a string"""
-    match = re.search("r20[2-9][0-9][ab]", string, re.IGNORECASE)
+    match = re.search("R20[2-9][0-9][ab]", string, re.IGNORECASE)
     if match:
         return match.group(0)
     else:
@@ -60,6 +60,7 @@ def remove_file(filepath):
     except OSError:
         pass
 
+
 def get_changelog_mb_version(filepath):
     """Get the latest version of matlab-batch from a .md file"""
     ## look for the vYYYY.MM.N pattern, where
@@ -69,18 +70,20 @@ def get_changelog_mb_version(filepath):
     pattern = "v(20[2-9][0-9]\.[0-9]{1,2}\.[0-9]+)"
     ver_regexp = re.compile(pattern)
 
-    headings_tree=mdparser.get_headings_tree(filepath)
-    
+    headings_tree = mdparser.get_headings_tree(filepath)
+
     target_heading = "Changelog"
     path_to_target = mdparser.find_element(headings_tree, target_heading)
     if not path_to_target:
-        raise ValueError(f"Unable to find '{target_heading}' in the heading tree of {filepath}")
-    
+        raise ValueError(
+            f"Unable to find '{target_heading}' in the heading tree of {filepath}"
+        )
+
     version_list = mdparser.get_children(headings_tree, path_to_target)
     if not version_list:
         raise ValueError(f"The heading '{target_heading}' does not have sub-headings")
-    
-    latest_version=version_list[0]
+
+    latest_version = version_list[0]
     match = ver_regexp.search(latest_version)
     if match is None:
         raise ValueError(