handling better when jupyter is not installed or is launched on Windows where jupyter is not part of the build process yet

Author: lindakladivova

gui/icons/grass/jupyter-inactive.png

@@ -24,6 +24,7 @@
 """
 
 from core.gcmd import RunCommand
+from grass.workflows.server import is_jupyter_installed
 from gui_core.toolbars import BaseToolbar, AuiToolbar, BaseIcons
 from icons.icon import MetaIcon
 
@@ -212,11 +213,25 @@ def _toolbarData(self):
                 img="python", label=_("Open a simple Python code editor")
             ),
             "jupyter": MetaIcon(img="jupyter", label=_("Start Jupyter Notebook")),
+            "jupyter-inactive": MetaIcon(
+                img="jupyter-inactive",
+                label=_(
+                    "Start Jupyter Notebook - requires Jupyter Notebook, click for more info"
+                ),
+            ),
             "script-load": MetaIcon(
                 img="script-load", label=_("Launch user-defined script")
             ),
         }
 
+        # Decide if Jupyter is available
+        if is_jupyter_installed():
+            jupyter_icon = icons["jupyter"]
+            jupyter_handler = self.parent.OnJupyterNotebook
+        else:
+            jupyter_icon = icons["jupyter-inactive"]
+            jupyter_handler = self.parent.OnShowJupyterInfo
+
         return self._getToolbarData(
             (
                 (
@@ -252,9 +267,9 @@ def _toolbarData(self):
                     self.parent.OnSimpleEditor,
                 ),
                 (
-                    ("jupyter", icons["jupyter"].label),
-                    icons["jupyter"],
-                    self.parent.OnJupyterNotebook,
+                    ("jupyter", jupyter_icon.label),
+                    jupyter_icon,
+                    jupyter_handler,
                 ),
                 (
                     ("script-load", icons["script-load"].label),

gui/icons/grass/jupyter-inactive.svg

@@ -919,6 +919,26 @@ def OnJupyterNotebook(self, event=None, cmd=None):
         # add map display panel to notebook and make it current
         self.mainnotebook.AddPage(jupyter_panel, _("Jupyter Notebook"))
 
+    def OnShowJupyterInfo(self, event=None):
+        """Show information dialog when Jupyter Notebook is not installed."""
+        if sys.platform.startswith("win"):
+            message = _(
+                "Jupyter Notebook is currently not included in the Windows GRASS build process.\n"
+                "This feature will be available in a future release."
+            )
+        else:
+            message = _(
+                "To use notebooks in GRASS, you need to have the Jupyter Notebook "
+                "package installed. After the installation, please restart GRASS to enable this feature."
+            )
+
+        wx.MessageBox(
+            message=message,
+            caption=_("Jupyter Notebook not available"),
+            style=wx.OK | wx.ICON_INFORMATION,
+            parent=self,
+        )
+
     def OnPsMap(self, event=None, cmd=None):
         """Launch Cartographic Composer. See OnIClass documentation"""
         from psmap.frame import PsMapFrame

gui/wxpython/lmgr/toolbars.py

@@ -14,6 +14,8 @@
 This module provides two classes for managing Jupyter Notebook servers
 programmatically within GRASS GIS tools or scripting environments:
 
+Functions:
+- `is_jupyter_installed()`: Check if Jupyter Notebook is installed on the system.
 Classes:
 - `JupyterServerInstance`: Manages a single Jupyter Notebook server instance.
 - `JupyterServerRegistry`: Manages multiple `JupyterServerInstance` objects
@@ -51,6 +53,33 @@
 import shutil
 
 
+def is_jupyter_installed():
+    """Check if Jupyter Notebook is installed.
+
+    - On Linux/macOS: returns True if the presence command succeeds, False otherwise.
+    - On Windows: currently always returns False because Jupyter is
+    not bundled.
+    TODO: Once Jupyter becomes part of the Windows build
+    process, this method should simply return True without additional checks.
+
+    :return: True if Jupyter Notebook is installed and available, False otherwise.
+    """
+    if sys.platform.startswith("win"):
+        # For now, always disabled on Windows
+        return False
+
+    try:
+        result = subprocess.run(
+            ["jupyter", "notebook", "--version"],
+            stdout=subprocess.DEVNULL,
+            stderr=subprocess.DEVNULL,
+            check=True,
+        )
+        return result.returncode == 0
+    except (subprocess.CalledProcessError, FileNotFoundError):
+        return False
+
+
 class JupyterServerInstance:
     """Manage the lifecycle of a Jupyter server instance."""
 
@@ -96,17 +125,6 @@ def _handle_exit_signal(self, signum, frame):
         finally:
             sys.exit(0)
 
-    @staticmethod
-    def is_jupyter_notebook_installed():
-        """Check if Jupyter Notebook is installed.
-        :return: True if Jupyter Notebook is installed, False otherwise (bool).
-        """
-        try:
-            subprocess.check_output(["jupyter", "notebook", "--version"])
-            return True
-        except (subprocess.CalledProcessError, FileNotFoundError):
-            return False
-
     @staticmethod
     def find_free_port():
         """Find a free port on the local machine.
@@ -137,7 +155,7 @@ def is_server_running(self, retries=10, delay=0.2):
     def start_server(self):
         """Run Jupyter server in the given directory on a free port."""
         # Check if Jupyter Notebook is installed
-        if not JupyterServerInstance.is_jupyter_notebook_installed():
+        if not is_jupyter_installed():
             raise RuntimeError(_("Jupyter Notebook is not installed"))
 
         # Find free port and build server url