Introducing support for MacOS.

Works best with MATLAB R2022b.

Author: Prabhakar Kumar

README.md

@@ -25,8 +25,6 @@ The MATLAB Proxy is under active development. For support or to report issues, s
 - [Feedback](#feedback)
 
 ## Requirements
-* Linux® or a Windows® Operating System
-
 * MATLAB® R2020b or later is installed and on the system PATH.
   ```bash
   # Confirm MATLAB is on the PATH
@@ -52,6 +50,12 @@ The MATLAB Proxy is under active development. For support or to report issues, s
 * Python versions: **3.7** | **3.8** | **3.9**  | **3.10**
 * [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 )
+    * MacOS (starting v0.5.0 of matlab-proxy )    
+See [Platform Support](#platform-support) for more information 
+
 ## Installation
 
 ### PyPI
@@ -138,20 +142,25 @@ This package is fully supported for the Linux Operating System.
 
 ### Windows
 
-Windows® Operating System support was introduced in package version `v0.4.0`. If you encounter any errors, see the [Feedback](#feedback) section to report them.
-
+Windows® Operating System support was introduced in package version `v0.4.0`.
 Install the version >=0.4.0 to use the package on Windows.
 ```bash
 # To upgrade an existing installation of matlab-proxy package:
 $ pip install --upgrade matlab-proxy>=0.4.0
-
-# Or to make a new installation of the latest version:
-$ pip install matlab-proxy 
 ```
 
 ### MacOS
 
-This package is not supported for the Apple® Mac Operating System. 
+MacOS support was introduced in package version `v0.5.0`. 
+It works best for MATLAB versions newer than R2022b.
+Note: Figures *also* open in a separate windows on versions of MATLAB older than R2022b.
+
+Install the version >=0.5.0 to use the package on MacOS.
+
+```bash
+# To upgrade an existing installation of matlab-proxy package:
+$ pip install --upgrade matlab-proxy>=0.5.0
+```
 
 ## Limitations
 This package supports the same subset of MATLAB features and commands as MATLAB® Online, except there is no support for Simulink® Online.

matlab_proxy/app_state.py

@@ -196,12 +196,16 @@ async def get_matlab_state(self):
         matlab = self.processes["matlab"]
         xvfb = self.processes["xvfb"]
 
-        if system.is_posix():
+        if system.is_linux():
             if xvfb is None or xvfb.returncode is not None:
                 return "down"
 
             if matlab is None or matlab.returncode is not None:
                 return "down"
+
+        elif system.is_mac():
+            if matlab is None or matlab.returncode is not None:
+                return "down"
         else:
             if matlab is None or not matlab.is_running():
                 return "down"
@@ -573,7 +577,7 @@ async def __setup_env_for_matlab(self) -> dict:
         # DDUX info for MATLAB
         matlab_env["MW_CONTEXT_TAGS"] = self.settings.get("mw_context_tags")
 
-        if system.is_posix():
+        if system.is_linux():
             # Adding DISPLAY key which is only available after starting Xvfb successfully.
             matlab_env["DISPLAY"] = self.settings["matlab_display"]
 
@@ -710,7 +714,7 @@ async def start_matlab(self, restart_matlab=False):
         self.logs["matlab"].clear()
 
         # Start Xvfb process if in a posix system
-        if system.is_posix():
+        if system.is_linux():
             xvfb = await self.__start_xvfb_process()
 
             # xvfb variable would be None if creation of the process failed.

matlab_proxy/settings.py

@@ -152,6 +152,7 @@ def get(config_name=matlab_proxy.get_default_config_name(), dev=False):
             "matlab_version": get_matlab_version(matlab_path),
             "matlab_cmd": [
                 "matlab",
+                "-webui",
                 "-nosplash",
                 "-nodesktop",
                 "-softwareopengl",

setup.py

@@ -66,7 +66,7 @@ def run(self):
 
 setuptools.setup(
     name="matlab-proxy",
-    version="0.4.0",
+    version="0.5.0",
     url=config["doc_url"],
     author="The MathWorks, Inc.",
     author_email="[email protected]",