matlab-proxy 0.10.0__py3-none-any.whl → 0.10.1__py3-none-any.whl

matlab_proxy/settings.py

@@ -369,6 +369,14 @@ def get_matlab_settings():
             f"Set {mwi_env.get_env_name_custom_matlab_root()} to a valid MATLAB root path"
         )
 
+    mpa_flags = (
+        mwi_env.Experimental.get_mpa_flags()
+        if mwi_env.Experimental.is_mpa_enabled()
+        else ""
+    )
+    profile_matlab_startup = (
+        "-timing" if mwi_env.Experimental.is_matlab_startup_profiling_enabled() else ""
+    )
     return {
         "matlab_path": matlab_root_path,
         "matlab_version": matlab_version,
@@ -377,7 +385,10 @@ def get_matlab_settings():
             "-nosplash",
             *flag_to_hide_desktop,
             "-softwareopengl",
+            # " v=mvm ",
             *matlab_lic_mode,
+            *mpa_flags,
+            profile_matlab_startup,
             "-r",
             f"try; run('{matlab_startup_file}'); catch ME; disp(ME.message); end;",
         ],

matlab_proxy/util/mwi/environment_variables.py

@@ -1,9 +1,21 @@
-# Copyright (c) 2020-2023 The MathWorks, Inc.
+# Copyright 2020-2023 The MathWorks, Inc.
 """This file lists and exposes the environment variables which are used by the integration."""
 
 import os
 
 
+def _is_env_set_to_true(env_name: str) -> bool:
+    """Helper function that returns True if the environment variable specified is set to True.
+
+    Args:
+        env_name (str): Name of the environment variable to check the state for.
+
+    Returns:
+        bool: True if the value of the environment variable is a case insensitive match to the string "True"
+    """
+    return os.environ.get(env_name, "false").lower() == "true"
+
+
 def get_env_name_network_license_manager():
     """Specifies the path to valid license file or address of a network license server"""
     return "MLM_LICENSE_FILE"
@@ -20,19 +32,10 @@ def get_env_name_logging_level():
 
 
 def get_env_name_enable_web_logging():
-    """wef > v0.2.10 Enable the logging of asyncio web traffic by setting to true"""
+    """Enable the logging of asyncio web traffic by setting to true"""
     return "MWI_ENABLE_WEB_LOGGING"
 
 
-def get_old_env_name_enable_web_logging():
-    """
-    Enable the logging of asyncio web traffic by setting to true
-    This name is deprecated and was last published in version v0.2.10 of matlab-proxy.
-    """
-
-    return "MWI_WEB_LOGGING_ENABLED"
-
-
 def get_env_name_log_file():
     """Specifies a file into which logging content is directed"""
     return "MWI_LOG_FILE"
@@ -89,32 +92,17 @@ def get_env_name_matlab_tempdir():
 
 def is_development_mode_enabled():
     """Returns true if the app is in development mode."""
-    return os.environ.get(get_env_name_development(), "false").lower() == "true"
+    return _is_env_set_to_true(get_env_name_development())
 
 
 def is_testing_mode_enabled():
     """Returns true if the app is in testing mode."""
-    return (
-        is_development_mode_enabled()
-        and os.environ.get(get_env_name_testing(), "false").lower() == "true"
-    )
+    return is_development_mode_enabled() and _is_env_set_to_true(get_env_name_testing())
 
 
 def is_web_logging_enabled():
     """Returns true if the web logging is required to be enabled"""
-
-    if os.environ.get(get_old_env_name_enable_web_logging(), None) is not None:
-        from matlab_proxy.util import mwi
-
-        logger = mwi.logger.get()
-        logger.warning(
-            f"Usage of {get_old_env_name_enable_web_logging()} is being deprecated from v0.2.10 and will be removed in a future release.\n Use {get_env_name_enable_web_logging()} instead. "
-        )
-        return (
-            os.environ.get(get_old_env_name_enable_web_logging(), "false").lower()
-            == "true"
-        )
-    return os.environ.get(get_env_name_enable_web_logging(), "false").lower() == "true"
+    return _is_env_set_to_true(get_env_name_enable_web_logging())
 
 
 def get_env_name_ssl_cert_file():
@@ -155,3 +143,56 @@ def get_env_name_custom_matlab_root():
 def get_env_name_process_startup_timeout():
     """User specified timeout in seconds for processes launched by matlab-proxy"""
     return "MWI_PROCESS_START_TIMEOUT"
+
+
+class Experimental:
+    """This class houses functions which are undocumented APIs and Environment variables.
+    Note: Never add any state to this class. Its only intended for use as an abstraction layer
+    for functions which are not ready for prime time.
+    """
+
+    @staticmethod
+    def get_env_name_enable_simulink():
+        """Returns the environment variable name used to enable simulink support"""
+        ##NOTE: Simulink Online is unavailable for general use as of R2023b.
+        return "MWI_ENABLE_SIMULINK"
+
+    @staticmethod
+    def is_simulink_enabled():
+        """Returns true if the simulink online is enabled."""
+        return _is_env_set_to_true(Experimental.get_env_name_enable_simulink())
+
+    @staticmethod
+    def should_use_mos_html():
+        """Returns true if matlab-proxy should use MOS htmls to load MATLAB"""
+        return _is_env_set_to_true("MWI_USE_MOS") or Experimental.is_simulink_enabled()
+
+    @staticmethod
+    def should_use_mre_html():
+        """Returns true if matlab-proxy should provide MRE parameter to the htmls used to load MATLAB"""
+        return _is_env_set_to_true("MWI_USE_MRE")
+
+    @staticmethod
+    def get_env_name_enable_mpa():
+        """Returns the environment variable name used to enable MPA support"""
+        return "MWI_ENABLE_MPA"
+
+    @staticmethod
+    def is_mpa_enabled():
+        """Returns true if the simulink online is enabled."""
+        return _is_env_set_to_true(Experimental.get_env_name_enable_mpa())
+
+    @staticmethod
+    def get_env_name_profile_matlab_startup():
+        """Returns the environment variable name used to enable MPA support"""
+        return "MWI_PROFILE_MATLAB_STARTUP"
+
+    @staticmethod
+    def is_matlab_startup_profiling_enabled():
+        """Returns true if the simulink online is enabled."""
+        return _is_env_set_to_true(Experimental.get_env_name_profile_matlab_startup())
+
+    @staticmethod
+    def get_mpa_flags():
+        """Returns list of flags required to enable MPA"""
+        return ["-webui", "-externalUI"]

{matlab_proxy-0.10.0.dist-info → matlab_proxy-0.10.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: matlab-proxy
-Version: 0.10.0
+Version: 0.10.1
 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.

{matlab_proxy-0.10.0.dist-info → matlab_proxy-0.10.1.dist-info}/RECORD

@@ -1,14 +1,14 @@
 matlab_proxy/__init__.py,sha256=6cwi8buKCMtw9OeWaOYUHEoqwl5MyJ_s6GxgNuqPuNg,1673
-matlab_proxy/app.py,sha256=RXb45AniSi-6iZTKEZzjjLin1IaIqKeLAgfelsw2WHU,28548
-matlab_proxy/app_state.py,sha256=f5il5N48iCkeMbmD--vDuT7Gw0AVXngd0ditAPV3uMU,53991
+matlab_proxy/app.py,sha256=pMLiSfUbes04boTqjmmV2OZrzTmIJA5wtn5mK8jQAnY,28681
+matlab_proxy/app_state.py,sha256=OXk7-SR83CSn-BlZflu679TwuPDjviA6Vta5FvZqEF0,54552
 matlab_proxy/constants.py,sha256=mtIZmO8MVbKoHqu0jTDB0R3c8tNw_2csm4dM0vNRDIE,620
 matlab_proxy/default_configuration.py,sha256=DxQaHzAivzstiPl_nDfxs8SOyP9oaK9v3RP4LtroJl4,843
 matlab_proxy/devel.py,sha256=nR6XPVBUEdQ-RZGtYvX1YHTp8gj9cuw5Hp8ahasMBc8,14310
-matlab_proxy/settings.py,sha256=ptd4Bjc7tI9OClpFtsJUxnkNxqqeFD1UlGZFGNoR2S8,19394
+matlab_proxy/settings.py,sha256=FyctpBa9SaQEnItfFi6gF4SZ_d2Qm1ojonGug4bwRt4,19738
 matlab_proxy/gui/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-matlab_proxy/gui/asset-manifest.json,sha256=VH6xUEv0Fy6ULD8Ov5BmUtYMwK_LzTxNiB6CD3oQYko,3516
+matlab_proxy/gui/asset-manifest.json,sha256=ULnp89obzlSF90igCa2cFhgmBTKJwe4WOeBhrlydUjs,3516
 matlab_proxy/gui/favicon.ico,sha256=7w7Ki1uQP2Rgwc64dOV4-NrTu97I3WsZw8OvRSoY1A0,130876
-matlab_proxy/gui/index.html,sha256=N6vbd0aZL4jEvqGduPB3MxGyjcapXx7MBqp2lK2jX-M,637
+matlab_proxy/gui/index.html,sha256=PGUXqpG-bX2JI35hPaOsauUR6y1z84AQJPQTkRwI-ik,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
@@ -16,9 +16,9 @@ matlab_proxy/gui/static/css/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMp
 matlab_proxy/gui/static/css/main.aa888962.css,sha256=pIXlQZlx2Xn0N5a7Wvh9UBBrKOZr0DOr9eEzmEAbAeM,274104
 matlab_proxy/gui/static/css/main.aa888962.css.map,sha256=8he7DI95fPkvfLbdbx77QEcqFjuNBz4YpX3HDzFNNGw,350274
 matlab_proxy/gui/static/js/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-matlab_proxy/gui/static/js/main.daea642c.js,sha256=5T2DwlpYAIwAWwzwAqR2lagRAZVqugzxUjdsy_pUebI,288122
-matlab_proxy/gui/static/js/main.daea642c.js.LICENSE.txt,sha256=3cj3DrwM51esz1ogL9VVU1ZyXyXJ6u-Ec2CI9CCcI_A,1689
-matlab_proxy/gui/static/js/main.daea642c.js.map,sha256=-8rEAjFDDyEl1l7MGz5L7zuG89fihKyoNYQiXdRSAXU,911352
+matlab_proxy/gui/static/js/main.fbc5c728.js,sha256=CTUnx095f0hFy9BKYU_IokVIRoIrNwu3BFVfWNzpmLo,288746
+matlab_proxy/gui/static/js/main.fbc5c728.js.LICENSE.txt,sha256=3cj3DrwM51esz1ogL9VVU1ZyXyXJ6u-Ec2CI9CCcI_A,1689
+matlab_proxy/gui/static/js/main.fbc5c728.js.map,sha256=6JF-lxxluIkr1Cc8Teyf9SUzFfKBup1IV13KFuuxGac,913905
 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
@@ -61,7 +61,7 @@ matlab_proxy/util/system.py,sha256=XoT3Rv5MwPkdfhk2oMvUwxxlzZmADMlxzi9IRQyGgbA,1
 matlab_proxy/util/windows.py,sha256=R9-VA7f0snVanSR7IgbHz3kvSnthZuUYe2UhBd5QWMQ,3440
 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/environment_variables.py,sha256=tb1aoqxbI8BjGg9pqc0XTY-6NCVXOih_2GHAc2tmrqM,4961
+matlab_proxy/util/mwi/environment_variables.py,sha256=BrG7FeXZ3nTE7BGFmItdNXRYpcfRMdIBaJCvj8llle0,6554
 matlab_proxy/util/mwi/exceptions.py,sha256=93HrHbOq24KI4Md2el23XN01wIqVShEK29Pbt2V0Jr8,4628
 matlab_proxy/util/mwi/logger.py,sha256=e7wTPclrtJ-aX5mPk_pUJMX7-1QD_snGBW1P2ks-ETE,3311
 matlab_proxy/util/mwi/token_auth.py,sha256=2HiLmfvi_ejTJAEyV0_Unt-CK_osZTwfROp6yQ6SGfY,9844
@@ -69,9 +69,9 @@ matlab_proxy/util/mwi/validators.py,sha256=Do0w8pjzCpYg9EiWqUtDojnBw8iwqkMR7K3ZQ
 matlab_proxy/util/mwi/embedded_connector/__init__.py,sha256=SVSckEJ4zQQ2KkNPT_un8ndMAImcMOTrai7ShAbmFY4,114
 matlab_proxy/util/mwi/embedded_connector/helpers.py,sha256=SfrwpCnZ6QGJBko-sR2bIG4-_qZOn29zCZV9qwVBnkM,3395
 matlab_proxy/util/mwi/embedded_connector/request.py,sha256=0NyfnE7-0g3BBPTPmjbkDrTOGiTNqFDrqKDObcRc2Jw,3716
-matlab_proxy-0.10.0.dist-info/LICENSE.md,sha256=oF0h3UdSF-rlUiMGYwi086ZHqelzz7yOOk9HFDv9ELo,2344
-matlab_proxy-0.10.0.dist-info/METADATA,sha256=luuD7KIiwtOWRz7QiSQv5WncsuPU2UeYjXwToqPwGXc,9780
-matlab_proxy-0.10.0.dist-info/WHEEL,sha256=Xo9-1PvkuimrydujYJAjF7pCkriuXBpUPEjma1nZyJ0,92
-matlab_proxy-0.10.0.dist-info/entry_points.txt,sha256=DbBLYgnRt8UGiOpd0zHigRTyyMdZYhMdvCvSYP7wPN0,244
-matlab_proxy-0.10.0.dist-info/top_level.txt,sha256=3-Lxje1LZvSfK__TVoRksU4th_PCj6cMMJwhH8P0_3I,13
-matlab_proxy-0.10.0.dist-info/RECORD,,
+matlab_proxy-0.10.1.dist-info/LICENSE.md,sha256=oF0h3UdSF-rlUiMGYwi086ZHqelzz7yOOk9HFDv9ELo,2344
+matlab_proxy-0.10.1.dist-info/METADATA,sha256=cgDn7iW9yn-jCdRhfdspK5Ne7Xj1NM3aZIMBFJNXs-k,9780
+matlab_proxy-0.10.1.dist-info/WHEEL,sha256=oiQVh_5PnQM0E3gPdiz09WCNmwiHDMaGer_elqB3coM,92
+matlab_proxy-0.10.1.dist-info/entry_points.txt,sha256=DbBLYgnRt8UGiOpd0zHigRTyyMdZYhMdvCvSYP7wPN0,244
+matlab_proxy-0.10.1.dist-info/top_level.txt,sha256=3-Lxje1LZvSfK__TVoRksU4th_PCj6cMMJwhH8P0_3I,13
+matlab_proxy-0.10.1.dist-info/RECORD,,

{matlab_proxy-0.10.0.dist-info → matlab_proxy-0.10.1.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: bdist_wheel (0.41.3)
+Generator: bdist_wheel (0.42.0)
 Root-Is-Purelib: true
 Tag: py3-none-any