Improved error message handling and updates minimum version dependency of matlab-proxy to v0.25.0

Author: krisctl

pyproject.toml

@@ -43,7 +43,7 @@ dependencies = [
     "ipykernel>=6.0.3",
     "jupyter-client",
     "jupyter-server-proxy>=4.1.0",
-    "matlab-proxy>=0.23.3",
+    "matlab-proxy>=0.25.0",
     "psutil",
     "requests",
 ]

src/jupyter_matlab_kernel/mpm_kernel.py

@@ -1,4 +1,4 @@
-# Copyright 2024 The MathWorks, Inc.
+# Copyright 2024-2025 The MathWorks, Inc.
 
 """This module contains derived class implementation of MATLABKernel that uses
 MATLAB Proxy Manager to manage interactions with matlab-proxy & MATLAB.
@@ -93,7 +93,7 @@ async def do_shutdown(self, restart):
     async def perform_startup_checks(self):
         """Overriding base function to provide a different iframe source"""
         await super().perform_startup_checks(
-            self.jupyter_base_url, f'{self.matlab_proxy_base_url.lstrip("/")}/'
+            self.jupyter_base_url, f"{self.matlab_proxy_base_url.lstrip('/')}/"
         )
 
     # Helper functions
@@ -139,19 +139,23 @@ async def _initialize_matlab_proxy_with_mpm(self, _logger: Logger):
                 parent_id=self.parent_pid,
                 is_shared_matlab=True,
             )
+            err = response.get("errors")
+            if err:
+                raise MATLABConnectionError(err)
             return (
                 response.get("absolute_url"),
                 response.get("mwi_base_url"),
                 response.get("headers"),
                 response.get("mpm_auth_token"),
             )
         except Exception as e:
-            _logger.error(
-                f"MATLAB Kernel could not start matlab-proxy using proxy manager with error: {e}"
-            )
+            _logger.error(f"MATLAB Kernel could not start matlab-proxy, Reason: {e}")
             raise MATLABConnectionError(
-                """
-                Error: MATLAB Kernel could not start the MATLAB proxy process via proxy manager.
+                f"""
+                Error: MATLAB Kernel could not start the MATLAB proxy process.
+                Reason: {e}
+                Resolution: Run the troubleshooting script described in the file `troubleshooting.md`.
+                If the issue persists, create an issue on Github: https://github.com/mathworks/jupyter-matlab-proxy/issues.
                 """
             ) from e
 

tests/unit/jupyter_matlab_kernel/test_mpm_kernel.py

@@ -1,4 +1,4 @@
-# Copyright 2024 The MathWorks, Inc.
+# Copyright 2024-2025 The MathWorks, Inc.
 
 import uuid
 
@@ -59,10 +59,7 @@ async def test_initialize_matlab_proxy_with_mpm_exception(mocker, mpm_kernel_ins
         await mpm_kernel_instance._initialize_matlab_proxy_with_mpm(
             mpm_kernel_instance.log
         )
-    assert (
-        "Error: MATLAB Kernel could not start the MATLAB proxy process via proxy manager."
-        in str(exc_info.value)
-    )
+    assert "Simulated failure" in str(exc_info.value)
 
 
 async def test_initialize_mwi_comm_helper(mocker, mpm_kernel_instance):