v0.3.0 Release to PyPi

Author: prabhakk-mw

Advanced-Usage.md

@@ -20,10 +20,27 @@ The following table describes all the environment variables that you can set to
 | **MWI_LOG_LEVEL** | string | `"CRITICAL"` | Specify the Python log level to be one of the following `NOTSET`, `DEBUG`, `INFO`, `WARN`, `ERROR`, or `CRITICAL`. For more information on Python log levels, see [Logging Levels](https://docs.python.org/3/library/logging.html#logging-levels) .<br />The default value is `INFO`. |
 | **MWI_LOG_FILE** | string | `"/tmp/logs.txt"` | Specify the full path to the file where you want the logs to be written. |
 | **MWI_WEB_LOGGING_ENABLED** | string | `"True"` | Set this value to `"true"` to see additional web server logs. |
-| **MWI_CUSTOM_HTTP_HEADERS** | string  |`'{"Content-Security-Policy": "frame-ancestors *.example.com:*"}'`<br /> OR <br />`"/path/to/your/custom/http-headers.json"` |Specify valid HTTP headers as JSON data in a string format. <br /> Alternatively, specify the full path to the JSON file containing valid HTTP headers instead. These headers are injected into the HTTP response sent to the browser. </br> For  more information, see the [Custom HTTP Headers](#custom_http_headers) section.|
+| **MWI_CUSTOM_HTTP_HEADERS** | string  |`'{"Content-Security-Policy": "frame-ancestors *.example.com:*"}'`<br /> OR <br />`"/path/to/your/custom/http-headers.json"` |Specify valid HTTP headers as JSON data in a string format. <br /> Alternatively, specify the full path to the JSON file containing valid HTTP headers instead. These headers are injected into the HTTP response sent to the browser. </br> For  more information, see the [Custom HTTP Headers](#custom-http-headers) section.|
 
+## Usage outside of Jupyter environment
 
-### Custom HTTP Headers 
+This package can be run outside of the Jupyter environment by executing the python console script
+`matlab-jupyter-app`.
+
+Execute this command on the machine in which MATLAB is installed with the environment variables `MWI_BASE_URL` and `MWI_APP_PORT` set as follows:
+```bash
+env MWI_BASE_URL="/my_base_url" MWI_APP_PORT=8080 matlab-jupyter-app
+```
+
+You can then access the web server on the link
+```html
+http://localhost:8080/my_base_url/index.html
+```
+
+These environment variables are implicitly set by the Jupyter environment, and 
+you do not need to set them when accessing the integration through Jupyter. 
+
+## Custom HTTP Headers 
 If the web browser renders the MATLAB Integration for Jupyter with some other content, then the browser could block the integration because of mismatch of `Content-Security-Policy` header in the response headers from the integration.
 To avoid this, provide custom HTTP headers. This allows browsers to load the content.
 

Development_Customization_Info.md renamed to Development-Customization-Info.md

@@ -17,7 +17,7 @@ Once you have a Jupyter environment with the `jupyter-matlab-proxy` package inst
   <img width="600" src="img/combined_launchers.png">
 </p>
 
-3. If prompted to do so, enter credentials for a MathWorks account associated with a MATLAB license. If you are using a network license manager, change to the _Network License Manager_ tab and enter the license server address instead. To determine the appropriate method for your license type, consult [MATLAB Licensing Info](./MATLAB_Licensing_Info.md).
+3. If prompted to do so, enter credentials for a MathWorks account associated with a MATLAB license. If you are using a network license manager, change to the _Network License Manager_ tab and enter the license server address instead. To determine the appropriate method for your license type, consult [MATLAB Licensing Info](./MATLAB-Licensing-Info.md).
 
 <p align="center">
   <img width="400" src="img/licensing_GUI.png">

MATLAB_Licensing_Info.md renamed to MATLAB-Licensing-Info.md

@@ -62,7 +62,7 @@ function LicensingGatherer() {
                                     <p id="LicensingGathererNote">
                                         For more details, see&nbsp;
                                         <a
-                                            href="https://github.com/mathworks/jupyter-matlab-proxy/blob/main/MATLAB_Licensing_Info.md"
+                                            href="https://github.com/mathworks/jupyter-matlab-proxy/blob/main/MATLAB-Licensing-Info.md"
                                             target="_blank"
                                             rel="noopener noreferrer"
                                         >

README.md

@@ -408,6 +408,14 @@ def main():
     logger = mwi_logger.get(init=True)
 
     logger.info("Starting MATLAB proxy-app")
+    logger.info(
+        f" with base_url: {os.environ[mwi_env.get_env_name_base_url()]} and "
+        f"app_port:{os.environ[mwi_env.get_env_name_app_port()]}."
+    )
+    if os.environ.get(mwi_env.get_env_name_mhlm_context()) is None:
+        logger.info(
+            f"\n The webdesktop can be accessed on http://localhost:{os.environ[mwi_env.get_env_name_app_port()]}{os.environ[mwi_env.get_env_name_base_url()]}/index.html"
+        )
 
     app = create_app()
 

gui/src/components/LicensingGatherer/index.js

@@ -19,7 +19,7 @@ def __get_licensing_url():
     Returns:
         String: Licensing URL
     """
-    return "https://github.com/mathworks/jupyter-matlab-proxy/blob/main/MATLAB_Licensing_Info.md"
+    return "https://github.com/mathworks/jupyter-matlab-proxy/blob/main/MATLAB-Licensing-Info.md"
 
 
 async def fetch_entitlements(mhlm_api_endpoint, access_token, matlab_release):

jupyter_matlab_proxy/app.py

@@ -51,7 +51,7 @@ def run(self):
 
 setuptools.setup(
     name="jupyter-matlab-proxy",
-    version="0.2.0",
+    version="0.3.0",
     url="https://github.com/mathworks/jupyter-matlab-proxy",
     author="The MathWorks, Inc.",
     author_email="[email protected]",