matlab-proxy 0.5.3__py3-none-any.whl → 0.30.1__py3-none-any.whl

{matlab_proxy-0.5.3.dist-info → matlab_proxy-0.30.1.dist-info}/METADATA

@@ -1,48 +1,65 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.4
 Name: matlab-proxy
-Version: 0.5.3
-Summary: =?utf-8?q?Python=C2=AE_package_enables_you_to_launch_MATLAB=C2=AE_and_access_it_from_a_web_browser=2E?=
-Home-page: https://github.com/mathworks/matlab-proxy/
-Author: The MathWorks, Inc.
-Author-email: cloud@mathworks.com
-License: MATHWORKS CLOUD REFERENCE ARCHITECTURE LICENSE
-Keywords: Proxy,MATLAB Proxy,MATLAB,MATLAB Javascript Desktop,MATLAB Web Desktop,Remote MATLAB Web Access
-Platform: UNKNOWN
+Version: 0.30.1
+Summary: Python® package enables you to launch MATLAB® and access it from a web browser.
+Project-URL: Homepage, https://github.com/mathworks/matlab-proxy/
+Project-URL: Documentation, https://github.com/mathworks/matlab-proxy/blob/main/README.md
+Project-URL: Issues, https://github.com/mathworks/matlab-proxy/issues
+Author-email: "The MathWorks Inc." <cloud@mathworks.com>
+License-Expression: LicenseRef-MATHWORKS-CLOUD-REFERENCE-ARCHITECTURE-LICENSE
+License-File: LICENSE.md
+Keywords: MATLAB,MATLAB Javascript Desktop,MATLAB Proxy,MATLAB Web Desktop,Proxy,Remote MATLAB Web Access
 Classifier: Intended Audience :: Developers
 Classifier: Natural Language :: English
 Classifier: Programming Language :: Python
-Classifier: Programming Language :: Python :: 3.7
-Classifier: Programming Language :: Python :: 3.8
-Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
-Requires-Python: ~=3.7
-Description-Content-Type: text/markdown
-Requires-Dist: aiohttp (>=3.7.4)
-Requires-Dist: psutil
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Requires-Python: <3.14,>=3.10
 Requires-Dist: aiohttp-session[secure]
+Requires-Dist: aiohttp>=3.7.4
+Requires-Dist: psutil
+Requires-Dist: requests
+Requires-Dist: rich
+Requires-Dist: watchdog
 Provides-Extra: dev
-Requires-Dist: aiohttp-devtools ; extra == 'dev'
-Requires-Dist: black ; extra == 'dev'
-Requires-Dist: ruamel.yaml ; extra == 'dev'
-Requires-Dist: pytest ; extra == 'dev'
-Requires-Dist: pytest-env ; extra == 'dev'
-Requires-Dist: pytest-cov ; extra == 'dev'
-Requires-Dist: pytest-mock ; extra == 'dev'
-Requires-Dist: pytest-aiohttp ; extra == 'dev'
-Requires-Dist: psutil ; extra == 'dev'
+Requires-Dist: aiohttp-devtools; extra == 'dev'
+Requires-Dist: black; extra == 'dev'
+Requires-Dist: psutil; extra == 'dev'
+Requires-Dist: pytest; extra == 'dev'
+Requires-Dist: pytest-aiohttp; extra == 'dev'
+Requires-Dist: pytest-asyncio; extra == 'dev'
+Requires-Dist: pytest-cov; extra == 'dev'
+Requires-Dist: pytest-env; extra == 'dev'
+Requires-Dist: pytest-mock; extra == 'dev'
+Requires-Dist: pytest-playwright; extra == 'dev'
+Requires-Dist: pytest-timeout; extra == 'dev'
+Requires-Dist: ruff; extra == 'dev'
+Requires-Dist: urllib3; extra == 'dev'
+Provides-Extra: test
+Requires-Dist: psutil; extra == 'test'
+Requires-Dist: pytest; extra == 'test'
+Requires-Dist: pytest-aiohttp; extra == 'test'
+Requires-Dist: pytest-asyncio; extra == 'test'
+Requires-Dist: pytest-cov; extra == 'test'
+Requires-Dist: pytest-env; extra == 'test'
+Requires-Dist: pytest-mock; extra == 'test'
+Requires-Dist: pytest-playwright; extra == 'test'
+Requires-Dist: pytest-timeout; extra == 'test'
+Requires-Dist: urllib3; extra == 'test'
+Description-Content-Type: text/markdown
 
 # MATLAB Proxy
-[![GitHub Workflow Status](https://img.shields.io/github/workflow/status/mathworks/matlab-proxy/Testing%20MATLAB%20Proxy?logo=github)](https://github.com/mathworks/matlab-proxy/actions) &nbsp; [![PyPI badge](https://img.shields.io/pypi/v/matlab-proxy.svg?logo=pypi)](https://pypi.python.org/pypi/matlab-proxy) &nbsp;  [![codecov](https://codecov.io/gh/mathworks/matlab-proxy/branch/main/graph/badge.svg?token=ZW3SESKCSS)](https://codecov.io/gh/mathworks/matlab-proxy) &nbsp; [![Downloads](https://static.pepy.tech/personalized-badge/matlab-proxy?period=month&units=international_system&left_color=grey&right_color=blue&left_text=PyPI%20downloads/month)](https://pepy.tech/project/matlab-proxy)
-
-Copyright (c) 2020-2022 The MathWorks, Inc. All rights reserved.
+[![GitHub Workflow Status](https://img.shields.io/github/actions/workflow/status/mathworks/matlab-proxy/run-tests.yml?branch=main&logo=github)](https://github.com/mathworks/matlab-proxy/actions) &nbsp; [![PyPI badge](https://img.shields.io/pypi/v/matlab-proxy.svg?logo=pypi)](https://pypi.python.org/pypi/matlab-proxy) &nbsp;  [![codecov](https://codecov.io/gh/mathworks/matlab-proxy/branch/main/graph/badge.svg?token=ZW3SESKCSS)](https://codecov.io/gh/mathworks/matlab-proxy) &nbsp; [![Downloads](https://static.pepy.tech/personalized-badge/matlab-proxy?period=month&units=international_system&left_color=grey&right_color=blue&left_text=PyPI%20downloads/month)](https://pepy.tech/project/matlab-proxy)
 
 ----
 
-`matlab-proxy` is a Python® package which enables you to launch MATLAB® and access it from a web browser.
+Use this Python® package `matlab-proxy` to start MATLAB® and access it from a web browser.
 
-Installation of this package creates an executable `matlab-proxy-app`, which launches MATLAB and provides a URL to access it. 
-
-The MATLAB Proxy is under active development. For support or to report issues, see the [Feedback](#feedback) section.
+Install this package to create an executable `matlab-proxy-app`, which starts MATLAB and provides you a URL to access it. 
+ 
+MATLAB Proxy is under active development. For support or to report issues, see [Feedback](#feedback).
 
 ----
 
@@ -58,17 +75,19 @@ The MATLAB Proxy is under active development. For support or to report issues, s
 - [Feedback](#feedback)
 
 ## Requirements
-* MATLAB® R2020b or later is installed and on the system PATH.
+* MATLAB® R2020b or later, installed and added to the system PATH.
   ```bash
   # Confirm MATLAB is on the PATH
   which matlab
   ```  
 * The dependencies required to run MATLAB.
-  Refer to the Dockerfiles in the [matlab-deps](https://github.com/mathworks-ref-arch/container-images/tree/master/matlab-deps) repository for the desired version of MATLAB.
+  For details, refer to the Dockerfiles in the [matlab-deps](https://github.com/mathworks-ref-arch/container-images/tree/master/matlab-deps) repository for your desired version of MATLAB.
+  
+* X Virtual Frame Buffer (Xvfb) (only for Linux® based systems):
 
-* X Virtual Frame Buffer (Xvfb) : (only for Linux® based systems)
+  Installing Xvfb is optional (starting v0.11.0 of matlab-proxy) but highly recommended. Xvfb enables graphical abilities like plots and figures in the MATLAB desktop. 
+  To install Xvfb on your Linux machine, use:
 
-  Install it on your linux machine using:
   ```bash
   # On a Debian/Ubuntu based system:
   $ sudo apt install xvfb
@@ -80,9 +99,20 @@ The MATLAB Proxy is under active development. For support or to report issues, s
 
   $ sudo yum install xorg-x11-server-Xvfb
   ```
-* Python versions: **3.7** | **3.8** | **3.9**  | **3.10**
-* [Browser Requirements](https://www.mathworks.com/support/requirements/browser-requirements.html)
+  
+
+* Fluxbox Window Manager (only for Linux® based systems):
+
+  Installing fluxbox is optional but required to use Simulink Online.
+
+  Install fluxbox using:
+  ```bash
+  # On a Debian/Ubuntu based system:
+  $ sudo apt install fluxbox 
+  ```
 
+* Python versions: 3.10 | 3.11 | 3.12 | 3.13
+* [Browser Requirements](https://www.mathworks.com/support/requirements/browser-requirements.html)
 * Supported Operating Systems:
     * Linux®
     * Windows® Operating System ( starting v0.4.0 of matlab-proxy )
@@ -98,7 +128,7 @@ python -m pip install matlab-proxy
 ```
 
 ### Building From Sources
-Building from sources requires Node.js® version 13 or higher. [Click here to install Node.js](https://nodejs.org/en/)
+Building from sources requires Node.js® version 24 or higher — [install it from the official site](https://nodejs.org/en/).
 
 ```bash
 git clone https://github.com/mathworks/matlab-proxy.git
@@ -118,7 +148,7 @@ which matlab-proxy-app
 
 Once the `matlab-proxy` package is installed.
 
-* Open a Linux terminal and launch the application with
+* Open a terminal and start `matlab-proxy-app`. On Linux, the command would be
   ```bash
   env MWI_BASE_URL="/matlab" matlab-proxy-app
   ```
@@ -127,7 +157,7 @@ Once the `matlab-proxy` package is installed.
 
   Running the above command will print text out on your terminal, which will contain the URL to access MATLAB. For example:
   ```
-  MATLAB can be accessed on 
+  Access MATLAB at 
   http://localhost:44549/matlab/index.html
   ```
 
@@ -155,17 +185,18 @@ The following options are available in the status panel (some options are only a
 
 | Option |  Description |
 | ---- | ---- |
-| Start MATLAB Session | Start your MATLAB session. Available if MATLAB is stopped.|
-| Restart MATLAB Session | Restart your MATLAB session. Available if MATLAB is running or starting.|
-| Stop MATLAB Session | Stop your MATLAB session. Use this option if you want to free up RAM and CPU resources. Available if MATLAB is running or starting.|
-| Sign Out | Sign out of MATLAB. Use this to stop MATLAB and sign in with an alternative account. Available if using online licensing.|
+| Start MATLAB | Start your MATLAB session. Available if MATLAB is stopped.|
+| Restart MATLAB | Restart your MATLAB session. Available if MATLAB is running or starting.|
+| Stop MATLAB | Stop your MATLAB session. Use this option if you want to free up RAM and CPU resources. Available if MATLAB is running or starting.|
+| Sign Out | Sign out of MATLAB session. Use this to stop MATLAB and sign in with an alternative account. Available if using online licensing.|
 | Unset License Server Address | Unset network license manager server address. Use this to stop MATLAB and enter new licensing information. Available if using network license manager.|
-| Feedback | Send feedback about the MATLAB Proxy. This action opens your default email application.|
+| Shut Down | Stop your MATLAB session and the `matlab-proxy` server.|
+| Feedback | Provide feedback. Opens a new tab to create an issue on GitHub.|
 | Help | Open a help pop-up for a detailed description of the options.|
 
 ## Examples
 * For installing/usage in a Docker container, see this [Dockerfile](./examples/Dockerfile) and its [README](./examples/README.md).
-* For upgrading **matlab-proxy** in an existing Docker image, see this [Dockerfile.upgrade.matlab-proxy](./examples/Dockerfile.upgrade.matlab-proxy) and its [README](./examples/README.md#upgrading-matlab-proxy-package-in-a-docker-image).*
+* For upgrading **matlab-proxy** in an existing Docker image, see this [Dockerfile.upgrade.matlab-proxy](./examples/Dockerfile.upgrade.matlab-proxy) and its [README](./examples/README.md#upgrading-matlab-proxy-package-in-a-docker-image).
 * For usage in a Jupyter environment, see [jupyter-matlab-proxy](https://github.com/mathworks/jupyter-matlab-proxy).
 
 ## Platform Support
@@ -195,9 +226,18 @@ Install the version >=0.5.0 to use the package on MacOS.
 $ pip install --upgrade matlab-proxy>=0.5.0
 ```
 
+### Windows Subsystem for Linux (WSL 2)
+
+To install `matlab-proxy` in WSL 2, follow the steps mentioned in the [Installation Guide for WSL 2](./install_guides/wsl2/README.md).
+
+## Using an already activated MATLAB with matlab-proxy
+`matlab-proxy` version `v0.7.0` introduces support for using an existing MATLAB license. Use the Existing License option only if you have an activated MATLAB. This allows you to start MATLAB without authenticating every time.
+
 ## Limitations
-This package supports the same subset of MATLAB features and commands as MATLAB® Online, except there is no support for Simulink® Online.
-[Click here for a full list of Specifications and Limitations for MATLAB Online](https://www.mathworks.com/products/matlab-online/limitations.html). 
+This package supports the same set of MATLAB features and commands as MATLAB® Online. For the full list, see 
+[Specifications and Limitations for MATLAB Online](https://www.mathworks.com/products/matlab-online/limitations.html). 
+
+Simulink Online is supported exclusively on Linux platforms starting from MATLAB R2024b.
 
 ## Security
 We take your security concerns seriously, and will attempt to address all concerns.
@@ -212,3 +252,8 @@ Using the latest version will provide the latest available security updates or p
 We encourage you to try this repository with your environment and provide feedback. 
 If you encounter a technical issue or have an enhancement request, create an issue [here](https://github.com/mathworks/matlab-proxy/issues)
 
+---
+
+Copyright 2020-2025 The MathWorks, Inc.
+
+---

matlab_proxy-0.30.1.dist-info/RECORD

@@ -0,0 +1,88 @@
+matlab_proxy/__init__.py,sha256=6cwi8buKCMtw9OeWaOYUHEoqwl5MyJ_s6GxgNuqPuNg,1673
+matlab_proxy/app.py,sha256=B8BQY5gQPJNJB2ruwj_tjsrCs1BF4MGe0hn0YxUi8n4,39059
+matlab_proxy/app_state.py,sha256=9MqzQiSyDtAactKT-SRSpUop7GxKqzSVxcOrB47VYeU,74161
+matlab_proxy/constants.py,sha256=sWMuaQg8IOxWI3Ya7udbm2D-rOwZahCTwdWIz4k2lqs,1271
+matlab_proxy/default_configuration.py,sha256=7xjsCzma4c6u0rEzio8xhHaDRy0wY2xtGXuARY2v0hc,1881
+matlab_proxy/devel.py,sha256=nR6XPVBUEdQ-RZGtYvX1YHTp8gj9cuw5Hp8ahasMBc8,14310
+matlab_proxy/settings.py,sha256=gsOLRLrIs4trAzElCijphi62rZR5NKSaHU-4Q47YsF8,29534
+matlab_proxy/gui/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+matlab_proxy/gui/favicon.ico,sha256=7w7Ki1uQP2Rgwc64dOV4-NrTu97I3WsZw8OvRSoY1A0,130876
+matlab_proxy/gui/index.html,sha256=1bD1MSwUqBupJLFaS_vjRb07qnObUTowPjiVytPcIhs,720
+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/index.BedVwcEg.css,sha256=A_qnwiZquUWPG5TmFu7Trfyu4alrxX1a3UthcIaqObw,296218
+matlab_proxy/gui/static/js/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+matlab_proxy/gui/static/js/index.pQwV1obF.js,sha256=8qU9kldsqg9L4F-n2Np9-E0BbSZjRf0t_no0CS1pUKk,281291
+matlab_proxy/gui/static/media/MATLAB-env-blur.NupTbPv_.png,sha256=QpmQTLDvBu2-b7ev83Rvpt0Q72R6wdQGkuJMPPpjv7M,220290
+matlab_proxy/gui/static/media/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+matlab_proxy/gui/static/media/glyphicons-halflings-regular.BKjkU69z.woff,sha256=omOU9-3hAMoRjv8u2ghZYnWpg5uVnCJuFUOVV6WoB0I,23424
+matlab_proxy/gui/static/media/glyphicons-halflings-regular.BUJKDMgK.eot,sha256=E2NNqH2eI_jD7ZEIzhck0YOjmtBy5z4bPYy_ZG0tBAc,20127
+matlab_proxy/gui/static/media/glyphicons-halflings-regular.CSehLiBc.svg,sha256=QvYGWdJlwaPDD5-kKry7Vr1KU69Ng9MW1t16NpA8Q-U,108738
+matlab_proxy/gui/static/media/glyphicons-halflings-regular.DrwTMapi.ttf,sha256=45UEQJN1fYKvyxOJV9BqHqk2G9zwtELQahioBRr1dFY,45404
+matlab_proxy/gui/static/media/glyphicons-halflings-regular.DzqM6ju8.woff2,sha256=_hhdEaSWdokNR7t4MxKgzaWkTEA5IUCU55V7TAQO8Rw,18028
+matlab_proxy/gui/static/media/ico-header-account-hover.-jQHo6Wx.svg,sha256=SOFeac2wYLE7Q1JXVx99TJ4XWlsBU_IJ36EaMiWCDEo,4774
+matlab_proxy/gui/static/media/ico-header-account.CJCFoo5a.svg,sha256=QBTrSvJ1PuqFdr4RdFO1-3TPBhjztEvF37YYMm4vJYc,4774
+matlab_proxy/gui/static/media/ico-sprite.DXGLgzq9.png,sha256=2gk_PEau5Friw5q0K5tjVf1cvkZ9PA1MznGgShQgsg4,11438
+matlab_proxy/gui/static/media/mathworks-eps.CGNQALa9.ttf,sha256=1kBy6J9LTaAtVnE7hnQGkxk4jzFhEXB_Q2vxWoxEkVA,6448
+matlab_proxy/gui/static/media/mathworks-eps.DrkCtQtG.svg,sha256=vCnXHeXq43vl4ZapcF5kWDf95Hthuv2xFjftt8sDsY8,16377
+matlab_proxy/gui/static/media/mathworks-eps.Ds7lQbql.woff,sha256=e6k22TjtuLMkqCYnQt_yA6UlEa1ETjaZyMg1SRHbFP8,6528
+matlab_proxy/gui/static/media/mathworks-pictograms.BdqxEfBR.woff,sha256=rJckfPFgMSriJQ-UWH4acc60LXLUelh7YCJazNm2fOo,70288
+matlab_proxy/gui/static/media/mathworks-pictograms.CCLweoD4.svg,sha256=VAHOeLtlzJKPcF6ue6ygCceljdflnBxNMrU8QaG9aSU,289658
+matlab_proxy/gui/static/media/mathworks-pictograms.DZhFdRSm.ttf,sha256=c0YyfXeIMwTXPp27qf1hJyFsqBX_jk7RxhAQ8l8-FHQ,70212
+matlab_proxy/gui/static/media/mathworks.C-qsbhDy.svg,sha256=RRmK93Ob-yNiqq8_eoNERc5fWUQUnYwhfts0339SdHc,138707
+matlab_proxy/gui/static/media/mathworks.Ceplx86V.ttf,sha256=HTmIvVEDta9_tU2RMitYA_skj5RLXrAqXgN1w_GO88U,38656
+matlab_proxy/gui/static/media/mathworks.D08X1Vp8.woff,sha256=IDXclqMxIqQK8ddT-mwCAZZgyPBo9Gi9rwavy6Zgv98,38732
+matlab_proxy/gui/static/media/trigger-error.QEdsGL-m.svg,sha256=3zzT0uTrl4M_HlAjjVy_9F6fJDY9TifdQCFYX36LCOY,5017
+matlab_proxy/gui/static/media/trigger-ok.Dzg8OIrk.svg,sha256=mD-7N9cc4ARdMBFcplnogJv6nA4Yh3jQuYbZDUi18LU,4997
+matlab_proxy/icons/matlab.svg,sha256=xh5uYebQd8I-ISvenjU9A-PkClzW_lU9wvm3doXOFKM,13366
+matlab_proxy/matlab/evaluateUserMatlabCode.m,sha256=R8w6nPdGtadR4UUFJaspcrGQL7cJwUItdrfc531w3bM,2420
+matlab_proxy/matlab/startup.m,sha256=UcA4i2lAMytwBsO783uPIQoP5Pzw1R0xrUywbBBtTjw,533
+matlab_proxy/util/__init__.py,sha256=XsY1uN29XsC0Jov8vHBlpZh39qmmpXYpQG0MT3zqqKw,11154
+matlab_proxy/util/cookie_jar.py,sha256=GceKyB53lTX5r2wp9myvf0JDWDfvSamvjb4zmjkoOtY,2401
+matlab_proxy/util/event_loop.py,sha256=sX_0tKlirCY5ImLxkss_XO4Ksj65u6JHtwMj25oGL94,1816
+matlab_proxy/util/list_servers.py,sha256=so6nj32xGNGLrua4qu5FA5jiDsocVDP-RehthtLwctk,3004
+matlab_proxy/util/mw.py,sha256=dLGSdfcTZiwKR1MMZA-39o-8na13IEPZOGBqcaHmKVI,11086
+matlab_proxy/util/system.py,sha256=XoT3Rv5MwPkdfhk2oMvUwxxlzZmADMlxzi9IRQyGgbA,1692
+matlab_proxy/util/windows.py,sha256=oXtcDUViyDVxE1yzu0bsMLWqnFv-9g2ZsgasG8RX6XM,3784
+matlab_proxy/util/mwi/__init__.py,sha256=zI-X1lafr8H3j17PyA0oSZ0q5nINfK-WDA7VmJKmSAQ,158
+matlab_proxy/util/mwi/custom_http_headers.py,sha256=kfDjSnEXEVzoF2pZuEn76LKayeD2WKoQEDu2Y9EMOAo,7154
+matlab_proxy/util/mwi/download.py,sha256=9DoDAQc5I2tEQ5r3Gz5hp0m_jPmwXpWrgfwPFQ0tY20,4556
+matlab_proxy/util/mwi/environment_variables.py,sha256=GN1abKPjr8j-pSPfUmWgSYbxsWrUWIj_E97oACzcWXY,7647
+matlab_proxy/util/mwi/exceptions.py,sha256=8o4PZmira_ZonnOROzu8ERIiSn9y-456JO89gqjCags,5446
+matlab_proxy/util/mwi/logger.py,sha256=7TSSkSP-kNif1wosK4jI_QptORH7DUbSDkjLvoLGcnE,6872
+matlab_proxy/util/mwi/session_name.py,sha256=HQAGMlJo6KMb2f9MBcavni48nw9H-cHWMeJKmXxpeys,915
+matlab_proxy/util/mwi/token_auth.py,sha256=CEmWcz8LCBnt4Z73CTLhz2-awZaJgw8oi4eqaHN0MRU,10000
+matlab_proxy/util/mwi/validators.py,sha256=MtnftriZZU6ueOAV5AO7C8TIZJB6_lf-U4xMIpL0kJI,13239
+matlab_proxy/util/mwi/embedded_connector/__init__.py,sha256=Vfl2hNC7V1IwoK9_wrwfENs4BC8P-Mvvqh4BNGi2n48,119
+matlab_proxy/util/mwi/embedded_connector/helpers.py,sha256=Pav6B2P5jA0qxQVzxvWoSCw2q7bwM3XpLcnvcT1JwH4,3653
+matlab_proxy/util/mwi/embedded_connector/request.py,sha256=RXoVvrm5fibVb2A6EZnkMWwAQkYX3J5kqDTGQDZo9p0,4316
+matlab_proxy_manager/README.md,sha256=6I0XksB7mOqvk33zRLaAUdimR-56GTR0sWV1MLJAkSI,3436
+matlab_proxy_manager/__init__.py,sha256=CMqm2aSYUWo5sxV3vyqWudrQU31muouSqZRDesJNJSA,178
+matlab_proxy_manager/lib/README.md,sha256=233q4O0NzLzeOTWsCrHIboU-i-NAMb-SBq5SBMDwyhk,2193
+matlab_proxy_manager/lib/__init__.py,sha256=KfwQxxM5a1kMRtNbhz8tb7YfHp8e2d0tNLB55wYvDS8,37
+matlab_proxy_manager/lib/api.py,sha256=NsEGdPFoKki3tHz4wj7qsbVNhyN3qDbsCMSPvgjUryo,16220
+matlab_proxy_manager/storage/README.md,sha256=OmToUE1lD7evUtmg0yCc9oHlqg5mN4rzmePfHwuXYC0,2106
+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=DuYl9Q-gYA71WElBHcKMd1N5LW5k_Ey0PGABuLAQrgM,6150
+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=7cItcaVTRnYpSfhfuGAFr3vbCY2J9iE1V7rMs-tuVos,304
+matlab_proxy_manager/utils/decorators.py,sha256=MUCIA0vRxOSRCj8VF6Z662sIX6xLzAMJ_cuAU7p2OIw,1172
+matlab_proxy_manager/utils/environment_variables.py,sha256=A1E4RfSR21vWlWuoFy0JrRXbNsDtmlXI2tRqJT8jzcc,1612
+matlab_proxy_manager/utils/exceptions.py,sha256=t_LykVJx7A4M-G6vg43PgzK7u7zE8i1c6aMhLSpqQOQ,1217
+matlab_proxy_manager/utils/helpers.py,sha256=pmlfHgo1xYBZECFjN6ih4TWWQ7xBLWRPFxGA9zKD9mE,10398
+matlab_proxy_manager/utils/logger.py,sha256=HCQNjF0rHbDBvKhMBxGWs-FVH_GLTUDKIyXDqzLMAzc,1986
+matlab_proxy_manager/web/README.md,sha256=_RADHyuBhVZiZmHV7vKXkKkxyh9c-z-rzxr67pssxQI,2578
+matlab_proxy_manager/web/__init__.py,sha256=KfwQxxM5a1kMRtNbhz8tb7YfHp8e2d0tNLB55wYvDS8,37
+matlab_proxy_manager/web/app.py,sha256=1pnuRwtMwxfnScn443hEJHpTPZ-ANfI6EfOshzxeIGA,20361
+matlab_proxy_manager/web/monitor.py,sha256=I9SfKLTAmWF9ufNB8nsBzTEVQ004wGt6TeNWs0NdTXE,1619
+matlab_proxy_manager/web/watcher.py,sha256=89JHjBAQtOrllstaJFxqrjHwckpRmu3qfUqeqPLmH2Q,2130
+matlab_proxy-0.30.1.dist-info/METADATA,sha256=SgBFdZKdfBdPeZxR-gsOq6BQoWEIRhdb3ydNUgpSg9U,11260
+matlab_proxy-0.30.1.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+matlab_proxy-0.30.1.dist-info/entry_points.txt,sha256=3wztwXpt6wdGfTwscc4qHbCeWzi0E2XhyJbMDndyQKc,304
+matlab_proxy-0.30.1.dist-info/licenses/LICENSE.md,sha256=oF0h3UdSF-rlUiMGYwi086ZHqelzz7yOOk9HFDv9ELo,2344
+matlab_proxy-0.30.1.dist-info/RECORD,,

{matlab_proxy-0.5.3.dist-info → matlab_proxy-0.30.1.dist-info}/WHEEL

@@ -1,5 +1,4 @@
 Wheel-Version: 1.0
-Generator: bdist_wheel (0.38.2)
+Generator: hatchling 1.28.0
 Root-Is-Purelib: true
 Tag: py3-none-any
-

{matlab_proxy-0.5.3.dist-info → matlab_proxy-0.30.1.dist-info}/entry_points.txt

@@ -1,7 +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_manager/README.md

@@ -0,0 +1,85 @@
+# MATLAB Proxy Manager
+
+----
+This README is intended for MathWorks® developers only.
+`matlab-proxy-manager` is part of the `matlab-proxy` package and it helps in managing the lifecycle and proxying of MATLAB proxy processes.
+
+It provides a seamless integration with Jupyter environments, allowing MATLAB to be accessed and controlled via a proxy.
+
+Upon installation, this package introduces an executable `matlab-proxy-manager-app`, which is utilized by the Jupyter Server Proxy to initiate `matlab-proxy-manager`.
+
+----
+
+**Table of Contents**
+- [Project Structure](#structure)
+- [Installation](#installation)
+  - [PyPI](#pypi)
+  - [Building From Sources](#building-from-sources)
+- [Usage](#usage)
+- [Security](#security)
+
+## Structure
+`matlab-proxy-manager` is organized into several key sub-folders:
+
+1. lib: 
+
+    * This directory contains the library APIs that facilitate the invocation of MATLAB proxy processes. It supports API calls, enabling the MATLAB Kernel to manage proxy instances effectively. For detailed information, refer to the README within the lib folder.
+
+2. storage: 
+    * The file system serves as the source of truth for `matlab-proxy-manager`, storing metadata about each MATLAB proxy server in dedicated files. A new file is generated whenever a proxy instance is launched and is removed upon termination of the instance or deletion of the Kernel that initiated it.
+
+3. web: 
+    * This component handles proxy workflows through HTTP/WebSocket requests, which are part of the executable process spawned by clients using the `matlab-proxy-manager-app`. For specific requirements and constraints, consult the README located in the web folder.
+
+4. utils: 
+    * A collection of helper functions utilized across various parts of the project, ensuring modularity and code reuse.
+
+## Installation
+
+### PyPI
+`matlab-proxy-manager` is included in the `matlab-proxy` repository and can be easily installed from the Python Package Index:
+
+```bash
+python -m pip install matlab-proxy
+```
+
+### Building From Sources
+Building from sources requires Node.js® version 24 or higher. [Click here to install Node.js](https://nodejs.org/en/)
+
+```bash
+git clone https://github.com/mathworks/matlab-proxy.git
+
+cd matlab-proxy
+
+python -m pip install .
+```
+
+Installing the package creates an executable called `matlab-proxy-app`, which is placed onto your system PATH by `pip`, usually in: `$HOME/.local/bin/`
+```bash
+# Verify its presence on the PATH
+which matlab-proxy-manager-app
+```
+
+## Usage
+`matlab-proxy-manager` can be deployed in two modes:
+
+1. Library Mode: Import the relevant module within your client code to invoke public APIs directly.
+
+    Example:
+
+    ```python
+    import matlab_proxy_manager.lib.api as mpm_lib
+    response = await mpm_lib.start_matlab_proxy_for_kernel(...)
+    await mpm_lib.shutdown(...)
+    ```
+
+2. Process Mode: This mode is primarily managed by Jupyter-Server-Proxy for proxy workflows involving web-based MATLAB desktop access.
+
+## Security
+Security is paramount in matlab-proxy-manager. Communication between the Kernel, proxy manager, and Jupyter Server Proxy is secured using authentication tokens. These tokens are mandatory for API invocations and proxy workflows. They are passed via environment variables when the proxy manager is initiated by the Jupyter Server Proxy and are included in the arguments during Kernel API calls.
+
+---
+
+Copyright 2024-2025 The MathWorks, Inc.
+
+---

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/README.md

@@ -0,0 +1,53 @@
+# MATLAB Proxy Manager - Library
+
+This README is intended for MathWorks® developers only.
+`matlab-proxy-manager` module is designed to be flexible and robust, supporting both direct library calls and process-based workflows. The lib folder contains the code blocks providing the core library APIs that facilitate the management of MATLAB proxy instances.
+
+# Key Features
+## API Invocation:
+
+The lib module allows for the invocation of MATLAB proxy processes through a well-defined set of APIs. These APIs are designed to be intuitive and easy to integrate into existing workflows, enabling developers to start, stop, and manage MATLAB proxy instances programmatically.
+
+## Integration with MATLAB Kernel:
+
+The APIs in the lib directory are used by the MATLAB Kernel to manage the lifecycle of MATLAB proxy instances. This includes starting new instances and shutting them down when they are no longer needed.
+
+## Error Handling and Logging:
+
+Comprehensive error handling mechanisms are in place to ensure that any issues encountered during the management of proxy instances are logged and reported. This aids in troubleshooting and ensures the reliability of the system. 
+
+Users are required to set `MWI_MPM_LOG_LEVEL` environment variable to their desired log level (`INFO`, `DEBUG` etc.) to enable logging in `matlab-proxy-manager`.
+
+# Usage
+To use the lib APIs, you can import the relevant module in your Python code and invoke the provided functions. Here’s a basic example of how you might start and stop a MATLAB proxy instance:
+
+```python
+
+import matlab_proxy_manager.lib.api as mpm_lib
+
+# Start a MATLAB proxy instance
+response = await mpm_lib.start_matlab_proxy_for_kernel(
+                caller_id=self.kernel_id,
+                parent_id=self.parent_pid,
+                is_shared_matlab=True,
+            )
+return (
+    response.get("absolute_url"),
+    response.get("mwi_base_url"),
+    response.get("headers"),
+    response.get("mpm_auth_token"),
+)
+
+# Perform operations with the MATLAB instance...
+
+# Shut down the MATLAB proxy instance
+await mpm_lib.shutdown(
+    self.parent_pid, self.kernel_id, self.mpm_auth_token
+)
+```
+
+---
+
+Copyright 2024 The MathWorks, Inc.
+
+---

matlab_proxy_manager/lib/__init__.py

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