matlab-proxy 0.20.0__py3-none-any.whl → 0.21.0__py3-none-any.whl

matlab_proxy/settings.py

@@ -493,7 +493,7 @@ def create_xvfb_cmd():
         str(dpipe[1]),
         "-screen",
         "0",
-        "1600x1200x24",
+        "3840x2160x24",
         "-dpi",
         "100",
         # "-ac",

{matlab_proxy-0.20.0.dist-info → matlab_proxy-0.21.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: matlab-proxy
-Version: 0.20.0
+Version: 0.21.0
 Summary: Python® package enables you to launch MATLAB® and access it from a web browser.
 Home-page: https://github.com/mathworks/matlab-proxy/
 Author: The MathWorks, Inc.
@@ -22,6 +22,7 @@ Requires-Dist: aiohttp-session[secure]
 Requires-Dist: importlib-metadata
 Requires-Dist: importlib-resources
 Requires-Dist: psutil
+Requires-Dist: watchdog
 Provides-Extra: dev
 Requires-Dist: aiohttp-devtools; extra == "dev"
 Requires-Dist: black; extra == "dev"

{matlab_proxy-0.20.0.dist-info → matlab_proxy-0.21.0.dist-info}/RECORD

@@ -4,21 +4,21 @@ matlab_proxy/app_state.py,sha256=pt6s3Yy6NV6LB-GxT1Y4cOpeDaTFMm_ItN_qPstDTwE,712
 matlab_proxy/constants.py,sha256=-gEUNjBATe3_4Cd7CN-VhkEn-iMRfiZ-zdDDD6fM_II,1161
 matlab_proxy/default_configuration.py,sha256=DxQaHzAivzstiPl_nDfxs8SOyP9oaK9v3RP4LtroJl4,843
 matlab_proxy/devel.py,sha256=nR6XPVBUEdQ-RZGtYvX1YHTp8gj9cuw5Hp8ahasMBc8,14310
-matlab_proxy/settings.py,sha256=Jrk6vkYCKt-cFogkkNpfMcEzZcrDgzfeHqSl6ndgkUA,26722
+matlab_proxy/settings.py,sha256=63pyCUvT7WLBRUpUr3F4r4nL13pQ2Hn6-oZODAhuGLo,26722
 matlab_proxy/gui/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-matlab_proxy/gui/asset-manifest.json,sha256=FIqY-YJXdswnTR3PplkXTm1ovUWpvfsN9EvnweOFJaA,3516
+matlab_proxy/gui/asset-manifest.json,sha256=IarJ9XmKoHJovFfsx1gHk1frgKLGgyCzzYmZNz1DT3A,3516
 matlab_proxy/gui/favicon.ico,sha256=7w7Ki1uQP2Rgwc64dOV4-NrTu97I3WsZw8OvRSoY1A0,130876
-matlab_proxy/gui/index.html,sha256=g044AdWTU8FxXh9klGlneK8YF4swSUr_A8ZNe5mG6kk,637
+matlab_proxy/gui/index.html,sha256=BvGtBVGQxdCjSKGhUFEXZPK3SaFXB7TF3gbFxyx7miQ,637
 matlab_proxy/gui/manifest.json,sha256=NwDbrALM5auYyj2bbEf4aGwAUDqNl1FzMFQpPiG2Ty4,286
 matlab_proxy/gui/robots.txt,sha256=kNJLw79pisHhc3OVAimMzKcq3x9WT6sF9IS4xI0crdI,67
 matlab_proxy/gui/static/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 matlab_proxy/gui/static/css/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-matlab_proxy/gui/static/css/main.da9c4eb8.css,sha256=etg2mMerqvNiYKBJgve5vBUc-X8ZnnCVnf5gc-DMaPA,274453
-matlab_proxy/gui/static/css/main.da9c4eb8.css.map,sha256=favITMsubUPvF7E0vWcdc2RXJ9Pj5ljIWdPuhSBfDVU,351326
+matlab_proxy/gui/static/css/main.6cd0caba.css,sha256=Ks90yx_8kQC9UQXlkvh5ecz2vk2jEN2FKkMCLn0hTb8,269168
+matlab_proxy/gui/static/css/main.6cd0caba.css.map,sha256=-pczDWw0U0T9Yd7pVYDklDlsc6OJqxCYlGmS6qtAhqU,350517
 matlab_proxy/gui/static/js/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-matlab_proxy/gui/static/js/main.9c68c75c.js,sha256=iJwMC3mRnN8nVfU1tv4nkDQ0P5lp7ziT6Q0mupcchPk,298434
-matlab_proxy/gui/static/js/main.9c68c75c.js.LICENSE.txt,sha256=3cj3DrwM51esz1ogL9VVU1ZyXyXJ6u-Ec2CI9CCcI_A,1689
-matlab_proxy/gui/static/js/main.9c68c75c.js.map,sha256=VUnC1tai6A0N5CaBcyXMLlcy2eo_30-JcCTnq6uLqhM,955703
+matlab_proxy/gui/static/js/main.61c661b8.js,sha256=w44nS4qbZOF7mS5ASEhmhDPLk1KPDP4f4qF3eNZRzBg,283166
+matlab_proxy/gui/static/js/main.61c661b8.js.LICENSE.txt,sha256=uJRPpXtA1Wzfw2dMAUGOPgwqYk2GvDcIafoGMMNLECQ,1539
+matlab_proxy/gui/static/js/main.61c661b8.js.map,sha256=02MznaDjhNTG_3yo4quVaeyxtnsJVacK_LbN4pTXJdA,911172
 matlab_proxy/gui/static/media/MATLAB-env-blur.4fc94edbc82d3184e5cb.png,sha256=QpmQTLDvBu2-b7ev83Rvpt0Q72R6wdQGkuJMPPpjv7M,220290
 matlab_proxy/gui/static/media/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 matlab_proxy/gui/static/media/arrow.0c2968b90bd9a64c8c3f.svg,sha256=XtmvDWzGZnwCZm08TKBnqt5hc1wphJnNupG0Fx_faAY,327
@@ -71,6 +71,23 @@ matlab_proxy/util/mwi/validators.py,sha256=br-22Gyef_vxVSSH2Qkb97Nfph9sfl7fyhQ8-
 matlab_proxy/util/mwi/embedded_connector/__init__.py,sha256=Vfl2hNC7V1IwoK9_wrwfENs4BC8P-Mvvqh4BNGi2n48,119
 matlab_proxy/util/mwi/embedded_connector/helpers.py,sha256=aOn-AvcDy6jBQJIffiv_agIa4UVldAIl3--QnDpXWDM,3656
 matlab_proxy/util/mwi/embedded_connector/request.py,sha256=-IzTDjy3qViHfLJpK3OnFtEyV7dgwJKPQAfav9lqILc,4317
+matlab_proxy_manager/__init__.py,sha256=CMqm2aSYUWo5sxV3vyqWudrQU31muouSqZRDesJNJSA,178
+matlab_proxy_manager/lib/__init__.py,sha256=KfwQxxM5a1kMRtNbhz8tb7YfHp8e2d0tNLB55wYvDS8,37
+matlab_proxy_manager/lib/api.py,sha256=X-VSbZ41TPosqGODve8PSG6G9dZfqi0kmY_iGWFW3EA,10615
+matlab_proxy_manager/storage/__init__.py,sha256=KfwQxxM5a1kMRtNbhz8tb7YfHp8e2d0tNLB55wYvDS8,37
+matlab_proxy_manager/storage/file_repository.py,sha256=U4FAw0zFN9z7YNlaMsYZXWm5ccs3rp3bzZL-W2BNhxA,5187
+matlab_proxy_manager/storage/interface.py,sha256=pnRRD0Ku3gzbruAOM3J3NI2Kk8do3-_yRw9Pag1IqnE,1883
+matlab_proxy_manager/storage/server.py,sha256=kQ4jtG2xqCa8c7zqDBFYxOhxMxwZwqTIITBxcJRDcvE,4848
+matlab_proxy_manager/utils/__init__.py,sha256=KfwQxxM5a1kMRtNbhz8tb7YfHp8e2d0tNLB55wYvDS8,37
+matlab_proxy_manager/utils/auth.py,sha256=60vi16eQ7LWp3I4CNv2easTjObw50irEm518fiMA5YI,2526
+matlab_proxy_manager/utils/constants.py,sha256=pyg-bkk6wWfmy60nvhroZDMZt__FcbZbuvU-b9m2Fkg,163
+matlab_proxy_manager/utils/environment_variables.py,sha256=rbDeWnyJp77Yr6btK3eXKZQ5thwiwhOGZcvDetGPOH8,1436
+matlab_proxy_manager/utils/helpers.py,sha256=5yTRM0NjGUC6lcQ6O8ilDrG2AnICGfvJYdIPho41Egw,9193
+matlab_proxy_manager/utils/logger.py,sha256=GSRGD-yf518o-2b1BxEeJYuNiEz2eEqpl0Solqbwpb4,1869
+matlab_proxy_manager/web/__init__.py,sha256=KfwQxxM5a1kMRtNbhz8tb7YfHp8e2d0tNLB55wYvDS8,37
+matlab_proxy_manager/web/app.py,sha256=Lu6sl3Mft98oL-Z1NwBdmmG1OvnwYEN31pU2bOdzFi0,16572
+matlab_proxy_manager/web/monitor.py,sha256=Gj0DxwX0c1PEAly5jWmuIGqNJYGDDjTkQIzbVXu4zCQ,1589
+matlab_proxy_manager/web/watcher.py,sha256=aNa_UDwvzaZrIdHyvWGX7dILH199uc6xVH4odrKU5-E,1817
 tests/integration/__init__.py,sha256=ttzJ8xKWGxOJZz56qOiWOn6sp5LGomkZMn_w4KJLRMU,42
 tests/integration/integration_tests_with_license/__init__.py,sha256=vVYZCur-QhmIGCxUmn-WZjIywtDQidaLDmlmrRHRlgY,37
 tests/integration/integration_tests_with_license/conftest.py,sha256=sCaIXB8d4vf05C7JWSVA7g5gnPjbpRq3dftuBpWyp1s,1599
@@ -83,7 +100,7 @@ tests/integration/utils/integration_tests_utils.py,sha256=IbJ9CedFHiz3k85FBY-8Gw
 tests/integration/utils/licensing.py,sha256=rEBjvMXO8R3mL6KnePu2lojmOsjD4GXl9frf9N0Wacs,4842
 tests/unit/__init__.py,sha256=KfwQxxM5a1kMRtNbhz8tb7YfHp8e2d0tNLB55wYvDS8,37
 tests/unit/conftest.py,sha256=Hfxq3h8IZuLJkRMh5jdEFiq78CIAdKvm-6KryRDZ0FY,1918
-tests/unit/test_app.py,sha256=LkIqION-F_4dDpbT0VXzdL_ue-1HGXhPRP9-AprcRKY,38443
+tests/unit/test_app.py,sha256=15kSWsfIEQpGzr6QoDoFpV501SYA5XkszrwDp8pJi74,38442
 tests/unit/test_app_state.py,sha256=ZtM79HAe5W6pVVWV-NICjDJBlmuxJ4NnZn-urGGtH-E,33429
 tests/unit/test_constants.py,sha256=2nXxTmDP8utr8krsfZ4c_Bh4_mWPcDO5uI8MXeq4Usg,158
 tests/unit/test_ddux.py,sha256=a2J2iM8j_nnfJVuMI38p5AjwrRdoMj3N88gFgS2I4hg,713
@@ -104,9 +121,9 @@ tests/unit/util/mwi/embedded_connector/test_helpers.py,sha256=vYTWNUTuDeaygo16JG
 tests/unit/util/mwi/embedded_connector/test_request.py,sha256=PR-jddnXDEiip-lD7A_QSvRwEkwo3eQ8owZlk-r9vnk,1867
 tests/utils/__init__.py,sha256=ttzJ8xKWGxOJZz56qOiWOn6sp5LGomkZMn_w4KJLRMU,42
 tests/utils/logging_util.py,sha256=VBy_NRvwau3C_CVTBjK5RMROrQimnJYHO2U0aKSZiRw,2234
-matlab_proxy-0.20.0.dist-info/LICENSE.md,sha256=oF0h3UdSF-rlUiMGYwi086ZHqelzz7yOOk9HFDv9ELo,2344
-matlab_proxy-0.20.0.dist-info/METADATA,sha256=xQBYP0FaWmdGuubXOWSYQs-EhU61M1A139fkywkLbvg,10166
-matlab_proxy-0.20.0.dist-info/WHEEL,sha256=eOLhNAGa2EW3wWl_TU484h7q1UNgy0JXjjoqKoxAAQc,92
-matlab_proxy-0.20.0.dist-info/entry_points.txt,sha256=DbBLYgnRt8UGiOpd0zHigRTyyMdZYhMdvCvSYP7wPN0,244
-matlab_proxy-0.20.0.dist-info/top_level.txt,sha256=9uVTjsUCAS4TwsxueTBxrBg3PdBiTSsYowAkHPv9VY0,19
-matlab_proxy-0.20.0.dist-info/RECORD,,
+matlab_proxy-0.21.0.dist-info/LICENSE.md,sha256=oF0h3UdSF-rlUiMGYwi086ZHqelzz7yOOk9HFDv9ELo,2344
+matlab_proxy-0.21.0.dist-info/METADATA,sha256=gnssXFWPF13KwXQjNiEuEaaE1IN-zOHHslCQ8TnnpGU,10190
+matlab_proxy-0.21.0.dist-info/WHEEL,sha256=eOLhNAGa2EW3wWl_TU484h7q1UNgy0JXjjoqKoxAAQc,92
+matlab_proxy-0.21.0.dist-info/entry_points.txt,sha256=ZAlCUsgKzGcAeQaMZOq31FrTB5tQ8Ypq8Op_8U600-A,305
+matlab_proxy-0.21.0.dist-info/top_level.txt,sha256=KF-347aoRGsfHTpiSqfIPUZ95bzK5-oMIu8S_TUcu-w,40
+matlab_proxy-0.21.0.dist-info/RECORD,,

{matlab_proxy-0.20.0.dist-info → matlab_proxy-0.21.0.dist-info}/entry_points.txt

@@ -1,6 +1,7 @@
 [console_scripts]
 matlab-proxy-app = matlab_proxy.app:main
 matlab-proxy-app-list-servers = matlab_proxy.util.list_servers:print_server_info
+matlab-proxy-manager-app = matlab_proxy_manager.web.app:main
 
 [matlab_proxy_configs]
 default_configuration_matlab_proxy = matlab_proxy.default_configuration:config

matlab_proxy-0.21.0.dist-info/top_level.txt

@@ -0,0 +1,3 @@
+matlab_proxy
+matlab_proxy_manager
+tests

matlab_proxy_manager/__init__.py

@@ -0,0 +1,6 @@
+# Copyright 2024 The MathWorks, Inc.
+
+
+def get_executable_name() -> str:
+    """Fetches and returns matlab proxy manager executable name"""
+    return "matlab-proxy-manager-app"

matlab_proxy_manager/lib/__init__.py

@@ -0,0 +1 @@
+# Copyright 2024 The MathWorks, Inc.

matlab_proxy_manager/lib/api.py

@@ -0,0 +1,295 @@
+# Copyright 2024 The MathWorks, Inc.
+import asyncio
+import os
+import secrets
+import subprocess
+from typing import Optional
+
+import matlab_proxy
+import matlab_proxy.util.system as mwi_sys
+from matlab_proxy_manager.storage.file_repository import FileRepository
+from matlab_proxy_manager.storage.server import ServerProcess
+from matlab_proxy_manager.utils import constants, helpers, logger
+
+# Used to list all the public-facing APIs exported by this module.
+__all__ = ["shutdown", "start_matlab_proxy_for_kernel", "start_matlab_proxy_for_jsp"]
+
+log = logger.get()
+shutdown_lock = asyncio.Lock()
+log = logger.get(init=True)
+
+
+async def start_matlab_proxy_for_kernel(
+    caller_id: str, parent_id: str, is_isolated_matlab: bool
+):
+    """
+    Starts a MATLAB proxy server specifically for MATLAB Kernel.
+
+    This function is a wrapper around the `start_matlab_proxy` function, with mpm_auth_token
+    set to None, for starting the MATLAB proxy server via proxy manager.
+    """
+    return await _start_matlab_proxy(
+        caller_id=caller_id, ctx=parent_id, is_isolated_matlab=is_isolated_matlab
+    )
+
+
+async def start_matlab_proxy_for_jsp(
+    parent_id: str, is_isolated_matlab: bool, mpm_auth_token: str
+):
+    """
+    Starts a MATLAB proxy server specifically for Jupyter Server Proxy (JSP) - Open MATLAB launcher.
+
+    This function is a wrapper around the `start_matlab_proxy` function, providing
+    a more specific context (mpm_auth_token) for starting the MATLAB proxy server via proxy manager.
+    """
+    return await _start_matlab_proxy(
+        caller_id="jsp",
+        ctx=parent_id,
+        is_isolated_matlab=is_isolated_matlab,
+        mpm_auth_token=mpm_auth_token,
+    )
+
+
+async def _start_matlab_proxy(**options) -> Optional[dict]:
+    """
+    Start a MATLAB proxy server.
+
+    This function starts a MATLAB proxy server based on the provided context and caller ID.
+    It handles the creation of new servers and the reuse of existing ones.
+
+    Args (keyword arguments):
+        - caller_id (str): The identifier for the caller (kernel id for kernels, "jsp" for JSP).
+        - ctx (str): The context in which the server is being started (parent pid).
+        - is_isolated_matlab (bool, optional): Whether to start an isolated MATLAB proxy instance.
+        Defaults to False.
+        - mpm_auth_token (str, optional): The MATLAB proxy manager token. If not provided,
+        a new token is generated. Defaults to None.
+
+    Returns:
+        ServerProcess: The process representing the MATLAB proxy server.
+
+    Raises:
+        ValueError: If `caller_id` is "default" and `is_isolated_matlab` is True.
+    """
+    caller_id: str = options.get("caller_id")
+    ctx: str = options.get("ctx")
+    is_isolated_matlab: bool = options.get("is_isolated_matlab", False)
+    mpm_auth_token: Optional[str] = options.get("mpm_auth_token", None)
+
+    if is_isolated_matlab and caller_id == "default":
+        raise ValueError(
+            "Caller id cannot be default when isolated_matlab is set to true"
+        )
+
+    mpm_auth_token = mpm_auth_token or secrets.token_hex(32)
+
+    # Cleanup stale entries before starting new instance of matlab proxy server
+    helpers._are_orphaned_servers_deleted(ctx)
+
+    ident = caller_id if is_isolated_matlab else "default"
+    key = f"{ctx}_{ident}"
+    log.debug("Starting matlab proxy using %s, %s, %s", ctx, ident, is_isolated_matlab)
+
+    data_dir = helpers.create_and_get_proxy_manager_data_dir()
+    server_process = ServerProcess.find_existing_server(data_dir, key)
+
+    if server_process:
+        log.debug("Found existing server for aliasing")
+
+        # Create a backend file for this caller for reference tracking
+        helpers.create_state_file(data_dir, server_process, f"{ctx}_{caller_id}")
+
+    # Create a new matlab proxy server
+    else:
+        server_process: ServerProcess | None = (
+            await _start_subprocess_and_check_for_readiness(
+                ident, ctx, key, is_isolated_matlab, mpm_auth_token
+            )
+        )
+
+        # Store the newly created server into filesystem
+        if server_process:
+            helpers.create_state_file(data_dir, server_process, f"{ctx}_{caller_id}")
+
+    return server_process.as_dict() if server_process else None
+
+
+async def _start_subprocess_and_check_for_readiness(
+    server_id: str, ctx: str, key: str, isolated: bool, mpm_auth_token: str
+) -> Optional[ServerProcess]:
+    """
+    Starts a MATLAB proxy server.
+
+    This function performs the following steps:
+    1. Prepares the command and environment variables required to start the MATLAB proxy server.
+    2. Initializes the MATLAB proxy process.
+    3. Checks if the MATLAB proxy server is ready.
+    4. Creates and returns a ServerProcess instance if the server is ready.
+
+    Returns:
+        Optional[ServerProcess]: An instance of ServerProcess if the server is successfully started,
+        otherwise None.
+    """
+    log.debug("Starting new matlab proxy server")
+
+    # Prepare matlab proxy command and required environment variables
+    matlab_proxy_cmd, matlab_proxy_env = _prepare_cmd_and_env_for_matlab_proxy()
+
+    # Start the matlab proxy process
+    process_id, url, mwi_base_url = await _start_subprocess(
+        matlab_proxy_cmd, matlab_proxy_env, server_id
+    )
+
+    server_process = None
+
+    # Check for the matlab proxy server readiness
+    if helpers.is_server_ready(f"{url}{mwi_base_url}"):
+        log.debug("Matlab proxy process info: %s, %s", url, mwi_base_url)
+        server_process = ServerProcess(
+            server_url=url,
+            mwi_base_url=mwi_base_url,
+            headers=helpers.convert_mwi_env_vars_to_header_format(
+                matlab_proxy_env, "MWI"
+            ),
+            pid=process_id,
+            parent_pid=ctx,
+            id=key,
+            type="named" if isolated else "shared",
+            mpm_auth_token=mpm_auth_token,
+        )
+    else:
+        log.error("Could not start matlab proxy")
+
+    return server_process
+
+
+def _prepare_cmd_and_env_for_matlab_proxy():
+    """
+    Prepare the command and environment variables for starting the MATLAB proxy.
+
+    Returns:
+        Tuple: A tuple containing the MATLAB proxy command and environment variables.
+    """
+    from jupyter_matlab_proxy import config
+
+    # Get the command to start matlab-proxy
+    matlab_proxy_cmd: list = [
+        matlab_proxy.get_executable_name(),
+        "--config",
+        config.get("extension_name"),
+    ]
+
+    input_env: dict = {
+        "MWI_AUTH_TOKEN": secrets.token_urlsafe(32),
+    }
+
+    matlab_proxy_env: dict = os.environ.copy()
+    matlab_proxy_env.update(input_env)
+
+    return matlab_proxy_cmd, matlab_proxy_env
+
+
+async def _start_subprocess(cmd, env, server_id) -> Optional[int]:
+    """
+    Initializes and starts a subprocess using the specified command and provided environment.
+
+    Returns:
+        Optional[int]: The process ID if the process is successfully created, otherwise None.
+    """
+    process = None
+    mwi_base_url: str = f"{constants.MWI_BASE_URL_PREFIX}{server_id}"
+
+    # Get a free port, closer to starting the matlab proxy appx
+    port: str = helpers.find_free_port()
+    env.update(
+        {
+            "MWI_APP_PORT": port,
+            "MWI_BASE_URL": mwi_base_url,
+        }
+    )
+
+    # Using loopback address so that DNS resolution doesn't add latency in Windows
+    url: str = f"http://127.0.0.1:{port}"
+
+    if mwi_sys.is_posix():
+        process = await asyncio.create_subprocess_exec(
+            *cmd,
+            env=env,
+        )
+        log.debug("Started matlab proxy subprocess for posix")
+    else:
+        process = subprocess.Popen(
+            cmd,
+            env=env,
+        )
+        log.debug("Started matlab proxy subprocess for windows")
+
+    if not process:
+        log.error("Matlab proxy process not created %d", process.returncode)
+        return None
+
+    process_pid = process.pid
+    log.debug("MATLAB proxy info: pid = %s, rc = %s", process_pid, process.returncode)
+    return process_pid, url, mwi_base_url
+
+
+async def shutdown(parent_pid: str, caller_id: str, mpm_auth_token: str):
+    """
+    Shutdown the MATLAB proxy server if the provided authentication token is valid.
+
+    This function attempts to shut down the MATLAB proxy server identified by the
+    given context and ID, provided the correct authentication token is supplied.
+    It ensures that the shutdown process is thread-safe using an asyncio lock.
+
+    Args:
+        parent_pid (str): The context identifier for the server.
+        caller_id (str): The unique identifier for the server.
+        mpm_auth_token (str): The authentication token for proxy manager and client communication.
+
+    Returns:
+        Optional[None]: Returns None if the shutdown process is successful or if
+                        required arguments are missing.
+
+    Raises:
+        FileNotFoundError: If the state file for the server does not exist.
+        ValueError: If the authentication token is invalid.
+        Exception: If any other error occurs during the shutdown process.
+    """
+    if not parent_pid or not caller_id or not mpm_auth_token:
+        log.debug(
+            "Required arguments (parent_pid | caller_id | mpm_auth_token) for shutdown missing"
+        )
+        return
+
+    try:
+        data_dir = helpers.create_and_get_proxy_manager_data_dir()
+        storage = FileRepository(data_dir)
+        filename = f"{parent_pid}_{caller_id}"
+        full_file_path, server = storage.get(filename)
+
+        if not server:
+            log.debug("State file for this server not found, filename: %s", filename)
+            return
+
+        if mpm_auth_token != server.mpm_auth_token:
+            raise ValueError("Invalid authentication token")
+
+        # Using asyncio lock to ensure thread-safe shutdown: clicking shutdown
+        # all on Kernel UI sends shutdown request in parallel which could lead
+        # to a scenario where the kernels' shutdown just cleans the files from
+        # filesystem and doesn't shut down the backend matlab proxy server.
+        async with shutdown_lock:
+            if helpers.is_only_reference(full_file_path):
+                server.shutdown()
+
+            # Delete the file for this server
+            storage.delete(f"{filename}.info")
+    except FileNotFoundError as e:
+        log.error("State file for server %s not found: %s", filename, e)
+        return
+    except ValueError as e:
+        log.error("Authentication error for server %s: %s", filename, e)
+        return
+    except Exception as e:
+        log.error("Error during shutdown of server %s: %s", filename, e)
+        raise

matlab_proxy_manager/storage/__init__.py

@@ -0,0 +1 @@
+# Copyright 2024 The MathWorks, Inc.

matlab_proxy_manager/storage/file_repository.py

@@ -0,0 +1,144 @@
+# Copyright 2024 The MathWorks, Inc.
+import glob
+import json
+import os
+from pathlib import Path
+from typing import Optional
+
+from matlab_proxy_manager.utils import logger
+
+from .interface import IRepository
+
+log = logger.get()
+
+
+class FileRepository(IRepository):
+    """
+    A repository for managing MATLAB proxy server processes using the file system.
+    """
+
+    def __init__(self, data_dir) -> None:
+        super().__init__()
+        self.data_dir = data_dir
+        self.encoding = "utf-8"
+
+    def get_all(self):
+        """Retrieves all server processes from the repository.
+
+        Returns:
+            A dictionary mapping file paths to server process instances.
+        """
+        from matlab_proxy_manager.storage.server import ServerProcess
+
+        servers = {}
+
+        # Read all the files in data_dir
+        all_files = glob.glob(f"{self.data_dir}/**/*.info", recursive=True)
+
+        for file in all_files:
+            try:
+                with open(file, "r", encoding=self.encoding) as f:
+                    data = f.read().strip()
+
+                    # Convert the content of each file to ServerProcess
+                    if data:
+                        server_process = ServerProcess.instantiate_from_string(data)
+                        servers[file] = server_process
+            except Exception as ex:
+                log.debug("ServerProcess instantiation failed for %s: %s", file, ex)
+        return servers
+
+    def get(self, name) -> tuple:
+        """
+        Retrieves a server process from the repository by its filename.
+
+        Args:
+            name (str): The name of the server process file.
+
+        Returns:
+            Tuple[Optional[str], Optional[ServerProcess]]: A tuple containing the file path
+            and the server process instance.
+        """
+        from matlab_proxy_manager.storage.server import ServerProcess
+
+        server_process = None
+        full_file_path: Optional[str] = None
+        current_files = glob.glob(f"{self.data_dir}/**/{name}.info", recursive=True)
+        if current_files:
+            full_file_path = current_files[0]
+            with open(full_file_path, "r", encoding=self.encoding) as f:
+                try:
+                    data = f.read().strip()
+                    if data:
+                        server_process = ServerProcess.instantiate_from_string(data)
+                except Exception as ex:
+                    log.debug(
+                        "ServerProcess instantiation failed for %s: %s",
+                        full_file_path,
+                        ex,
+                    )
+
+        return full_file_path, server_process
+
+    def add(self, server, filename: str) -> None:
+        """
+        Adds a server process to the repository.
+        Creates a directory like <ctx>_default|<kernel_id> and then creates a file as
+        default|<kernel_id>.info in that dir
+
+        Args:
+            server (ServerProcess): The server process instance to add.
+            filename (str): The filename to associate with the server process.
+        """
+        # Creates a child dir under the data_dir
+        server_dir = Path(f"{self.data_dir}", f"{server.id}")
+        Path.mkdir(server_dir, parents=True, exist_ok=True)
+        server_dict = {}
+
+        server_file = Path(server_dir, f"{filename}.info")
+        with open(server_file, "w", encoding=self.encoding) as f:
+            server_dict[server.id] = server.as_dict()
+            file_content = json.dumps(server_dict)
+            f.write(file_content)
+
+    def delete(self, filename: str) -> None:
+        """
+        Deletes a server process from the repository by its filename.
+
+        Args:
+            filename (str): The filename associated with the server process to delete.
+        """
+        # <path to proxy manager dir>/<parent_pid>_<name>/<name>.info
+        full_file_path, parent_dir = FileRepository._find_file_and_get_parent(
+            self.data_dir, filename
+        )
+        if full_file_path:
+            Path(full_file_path).unlink(missing_ok=True)
+            log.debug("Deleted file: %s", filename)
+
+            # delete the sub-directory (<parent_pid>_<id>) only if it is empty
+            if parent_dir and not len(os.listdir(parent_dir)):
+                os.rmdir(parent_dir)
+                log.debug("Deleted dir: %s", parent_dir)
+
+    @staticmethod
+    def _find_file_and_get_parent(data_dir: str, filename: str):
+        """
+        Finds the file and its parent directory in the given data directory.
+
+        Args:
+            data_dir (str): The base directory to search within.
+            filename (str): The filename to search for.
+
+        Returns:
+            Tuple[Optional[str], Optional[str]]: A tuple containing the full file path and the parent directory.
+        """
+        for dirpath, _, filenames in os.walk(data_dir):
+            # Check if target file is in the current directory's files
+            if filename in filenames:
+                full_path = os.path.join(dirpath, filename)
+                parent_dir = os.path.dirname(full_path)
+                return full_path, parent_dir
+
+        # Return None if the file was not found
+        return None, None

matlab_proxy_manager/storage/interface.py

@@ -0,0 +1,62 @@
+# Copyright 2024 The MathWorks, Inc.
+from typing import Protocol
+
+
+class IRepository(Protocol):
+    """
+    Protocol for a repository that manages MATLAB proxy server processes.
+    This protocol defines the required methods for adding, retrieving, and deleting
+    server process instances to the storage system (files).
+    """
+
+    def add(self, server, filename: str):
+        """
+        Adds a server process to the repository.
+
+        Args:
+            server (server.ServerProcess): The server process instance to add.
+            filename (str): The filename to associate with the server process.
+
+        Raises:
+            NotImplementedError
+        """
+        raise NotImplementedError("add not implemented")
+
+    def get(self, name: str) -> tuple:
+        """
+        Retrieves a server process from the repository by its filename.
+
+        Args:
+            filename (str): The filename associated with the server process.
+
+        Returns:
+            tuple (str, server.ServerProcess): Full file path and the retrieved server process instance.
+
+        Raises:
+            NotImplementedError
+        """
+        raise NotImplementedError("get not implemented")
+
+    def get_all(self):
+        """
+        Retrieves all server processes from the repository.
+
+        Returns:
+            Dict[str, server.ServerProcess]: Dict with filename as key and corresponding server process as value.
+
+        Raises:
+            NotImplementedError
+        """
+        raise NotImplementedError("get_all not implemented")
+
+    def delete(self, filename: str) -> None:
+        """
+        Deletes a server process from the repository by its filename.
+
+        Args:
+            filename (str): The filename associated with the server process to delete.
+
+        Raises:
+            NotImplementedError
+        """
+        raise NotImplementedError("delete not implemented")