deployment debug

Author: Heerpa

picasso_workflow/_launcher.py

@@ -0,0 +1,53 @@
+"""Entry point wrapper for the picasso-workflow GUI.
+
+Using pythonw / a windowless executable means that any uncaught exception
+before the Qt event loop starts is completely invisible — no terminal output,
+no dialog.  This module wraps the real startup so that:
+
+  1. A crash log is always written to ~/picasso-workflow-crash.log.
+  2. A Qt error dialog is shown if Qt can be imported at all.
+
+The gui-scripts entry point in pyproject.toml points here instead of
+directly to picasso_workflow.gui:main.
+"""
+
+
+def main() -> None:
+    import sys
+    from pathlib import Path
+
+    crash_log = Path.home() / "picasso-workflow-crash.log"
+
+    try:
+        from picasso_workflow.gui import main as _gui_main
+
+        _gui_main()
+    except SystemExit:
+        raise
+    except Exception:
+        import traceback
+
+        msg = traceback.format_exc()
+
+        # Always write to a location that is writable regardless of cwd.
+        try:
+            crash_log.write_text(msg, encoding="utf-8")
+        except Exception:
+            pass
+
+        # Best-effort Qt dialog so the user sees something on screen.
+        try:
+            from PyQt5 import QtWidgets
+
+            _app = QtWidgets.QApplication.instance()
+            if _app is None:
+                _app = QtWidgets.QApplication(sys.argv)
+            QtWidgets.QMessageBox.critical(
+                None,
+                "picasso-workflow failed to start",
+                f"{msg}\n\nFull crash log:\n{crash_log}",
+            )
+        except Exception:
+            pass
+
+        sys.exit(1)

picasso_workflow/gui.py

@@ -11713,20 +11713,36 @@ def on_module_changed(self, text):
 
 def main():
     app = QtWidgets.QApplication(sys.argv)
-    window = Window()
-    window.show()
 
-    def excepthook(type, value, tback):
-        lib.cancel_dialogs()
-        QtCore.QCoreApplication.instance().processEvents()
-        message = "".join(traceback.format_exception(type, value, tback))
-        errorbox = QtWidgets.QMessageBox.critical(
-            window, "An error occured", message
+    # Keep a reference so the excepthook closure can use it even before
+    # Window() returns.  It is None only if construction itself raises.
+    window = None
+
+    def excepthook(exc_type, exc_value, exc_tb):
+        message = "".join(traceback.format_exception(exc_type, exc_value, exc_tb))
+        try:
+            lib.cancel_dialogs()
+            QtCore.QCoreApplication.instance().processEvents()
+        except Exception:
+            pass
+        # QMessageBox.critical already shows the dialog and returns the
+        # clicked button (an int) — do not call .exec_() on the return value.
+        QtWidgets.QMessageBox.critical(
+            window, "An error occurred", message
         )
-        errorbox.exec_()
-        sys.__excepthook__(type, value, tback)
+        sys.__excepthook__(exc_type, exc_value, exc_tb)
 
+    # Install before creating Window so construction errors are caught.
     sys.excepthook = excepthook
+
+    try:
+        window = Window()
+    except Exception:
+        message = traceback.format_exc()
+        QtWidgets.QMessageBox.critical(None, "Startup error", message)
+        sys.exit(1)
+
+    window.show()
     sys.exit(app.exec_())
 
 

pyproject.toml

@@ -32,13 +32,14 @@ dependencies = [
     "memory-profiler>=0.61.0",
     "loguru>=0.7.3",
     "h5py",
+    "memory_profiler",
     # "mpi4py",
     # "openmpi"
 ]
 keywords = ["picasso"]
 
 [project.gui-scripts]
-picasso-workflow-gui = "picasso_workflow.gui:main"
+picasso-workflow-gui = "picasso_workflow._launcher:main"
 
 [project.optional-dependencies]
 cluster = [

tools/deploy_gui_mac.sh

@@ -62,6 +62,9 @@ mkdir -p "$APP_BUNDLE/Contents/Resources"
 # -- Launcher script (runs inside the bundle, no shell environment assumed) --
 cat > "$APP_BUNDLE/Contents/MacOS/$APP_NAME" <<LAUNCHER
 #!/usr/bin/env bash
+# Use the user's home directory as working directory so that relative paths
+# (e.g. the logs/ directory created by config_logger) land somewhere writable.
+cd "\$HOME"
 source "${CONDA_SH}"
 conda activate "${CONDA_ENV_PATH}"
 exec "${EXEC_PATH}" "\$@"

tools/deploy_gui_shortcut.ps1

@@ -124,7 +124,7 @@ $Shell    = New-Object -ComObject WScript.Shell
 $Shortcut = $Shell.CreateShortcut($ShortcutPath)
 
 $Shortcut.TargetPath       = $ExePath
-$Shortcut.WorkingDirectory = $CondaEnvPath
+$Shortcut.WorkingDirectory = $env:USERPROFILE
 $Shortcut.Description      = "picasso-workflow GUI"
 $Shortcut.IconLocation     = "$IconPath,0"