feat(maidr.show): use tempfile for interactive sessions (#121)

maidr/core/maidr.py

@@ -2,7 +2,10 @@
 
 import io
 import json
+import os
+import tempfile
 import uuid
+import webbrowser
 from typing import Literal
 
 from htmltools import HTML, HTMLDocument, Tag, tags
@@ -83,8 +86,11 @@ def show(self, renderer: Literal["auto", "ipython", "browser"] = "auto") -> obje
             The renderer to use for the HTML preview.
         """
         html = self._create_html_tag()
-        if Environment.is_interactive_shell() and not Environment.is_notebook():
-            return html.show("browser")
+        _renderer = Environment.get_renderer()
+        if _renderer == "browser" or (
+            Environment.is_interactive_shell() and not Environment.is_notebook()
+        ):
+            return self._open_plot_in_browser()
         return html.show(renderer)
 
     def clear(self):
@@ -94,6 +100,18 @@ def destroy(self) -> None:
         del self._plots
         del self._fig
 
+    def _open_plot_in_browser(self) -> None:
+        """
+        Open the rendered HTML content using a temporary file
+        """
+        system_temp_dir = tempfile.gettempdir()
+        static_temp_dir = os.path.join(system_temp_dir, "maidr")
+        os.makedirs(static_temp_dir, exist_ok=True)
+
+        temp_file_path = os.path.join(static_temp_dir, "maidr_plot.html")
+        html_file_path = self.save_html(temp_file_path)
+        webbrowser.open(f"file://{html_file_path}")
+
     def _create_html_tag(self) -> Tag:
         """Create the MAIDR HTML using HTML tags."""
         tagged_elements = [element for plot in self._plots for element in plot.elements]

maidr/util/environment.py

@@ -26,6 +26,20 @@ def is_notebook() -> bool:
         except ImportError:
             return False
 
+    @staticmethod
+    def get_renderer() -> str:
+        """Return renderer which can be ipython or browser."""
+        try:
+            import IPython  # pyright: ignore[reportUnknownVariableType]
+
+            ipy = (  # pyright: ignore[reportUnknownVariableType]
+                IPython.get_ipython()  # pyright: ignore[reportUnknownMemberType, reportPrivateImportUsage]
+            )
+            renderer = "ipython" if ipy else "browser"
+        except ImportError:
+            renderer = "browser"
+        return renderer
+
     @staticmethod
     def initialize_llm_secrets(unique_id: str) -> str:
         """Inject the LLM API keys into the MAIDR instance."""