PyMieSimX 0.1.0__py3-none-any.whl

PyMieSimX/__init__.py

@@ -0,0 +1,5 @@
+"""Dash graphical interface for PyMieSim."""
+
+from PyMieSimX.gui.interface import OpticalSetupGUI, create_dash_app
+
+__all__ = ["OpticalSetupGUI", "create_dash_app"]

PyMieSimX/__main__.py

@@ -0,0 +1,35 @@
+"""Entry point for launching the PyMieSimX dashboard."""
+
+import argparse
+import logging
+
+from PyMieSimX.gui.interface import OpticalSetupGUI
+
+
+def _build_argument_parser() -> argparse.ArgumentParser:
+    """Create the CLI parser for the dashboard launcher."""
+    parser = argparse.ArgumentParser(description="Launch the PyMieSimX dashboard.")
+    parser.add_argument("--host", default="0.0.0.0", help="Host interface for the Dash server.")
+    parser.add_argument("--port", default="8050", help="Port for the Dash server.")
+    parser.add_argument("--debug", action="store_true", help="Enable Dash debug mode and verbose debug logging.")
+    parser.add_argument("--no-browser", action="store_true", help="Start the server without opening a browser window.")
+    return parser
+
+
+def main(argv: list[str] | None = None) -> None:
+    """Launch the PyMieSimX dashboard from a console entry point."""
+    args = _build_argument_parser().parse_args(argv)
+    logging.basicConfig(
+        level=logging.DEBUG if args.debug else logging.INFO,
+        format="%(asctime)s | %(levelname)s | %(name)s | %(message)s",
+    )
+    OpticalSetupGUI().run(
+        host=args.host,
+        port=args.port,
+        open_browser=not args.no_browser,
+        debug=args.debug,
+    )
+
+
+if __name__ == "__main__":
+    main()

PyMieSimX/gui/__init__.py

@@ -0,0 +1,5 @@
+"""Dash dashboard for configuring and running PyMieSim experiment sets."""
+
+from PyMieSimX.gui.interface import OpticalSetupGUI, create_dash_app
+
+__all__ = ["OpticalSetupGUI", "create_dash_app"]

PyMieSimX/gui/assets/card-state.js

@@ -0,0 +1,41 @@
+(function () {
+  "use strict";
+
+  const storagePrefix = "pymiesim-card-state:";
+
+  function restoreCard(card) {
+    if (!card.id || !card.matches("details.workflow-card")) {
+      return;
+    }
+
+    const savedState = window.sessionStorage.getItem(storagePrefix + card.id);
+    if (savedState === "open") {
+      card.open = true;
+    } else if (savedState === "closed") {
+      card.open = false;
+    }
+
+    if (!card.dataset.statePersistenceBound) {
+      card.addEventListener("toggle", function () {
+        window.sessionStorage.setItem(storagePrefix + card.id, card.open ? "open" : "closed");
+      });
+      card.dataset.statePersistenceBound = "true";
+    }
+  }
+
+  function scan(root) {
+    if (root instanceof HTMLElement) {
+      restoreCard(root);
+      root.querySelectorAll("details.workflow-card").forEach(restoreCard);
+    }
+  }
+
+  document.addEventListener("DOMContentLoaded", function () {
+    scan(document.body);
+    new MutationObserver(function (mutations) {
+      mutations.forEach(function (mutation) {
+        mutation.addedNodes.forEach(scan);
+      });
+    }).observe(document.body, { childList: true, subtree: true });
+  });
+})();