setiastrosuitepro 1.6.2.post1__py3-none-any.whl

setiastro/saspro/header_viewer.py

@@ -0,0 +1,448 @@
+# pro/header_viewer.py
+from __future__ import annotations
+import os
+import csv
+from typing import Optional, Dict, Any
+
+from PyQt6.QtWidgets import (
+    QDockWidget, QWidget, QVBoxLayout, QTreeWidget, QTreeWidgetItem,
+    QPushButton, QFileDialog, QMessageBox
+)
+from PyQt6.QtCore import Qt
+
+from astropy.io import fits
+try:
+    from astropy.io.fits.verify import VerifyError
+except Exception:
+    class VerifyError(Exception):
+        pass
+
+from setiastro.saspro.xisf import XISF
+
+# we’ll reuse your loader helper for FITS headers
+from setiastro.saspro.legacy.image_manager import get_valid_header, _drop_invalid_cards
+from setiastro.saspro.doc_manager import ImageDocument
+
+
+class HeaderViewerDock(QDockWidget):
+    """
+    Dock that shows metadata for the currently active ImageDocument.
+    Supports FITS headers and XISF file & image metadata.
+    """
+    def __init__(self, parent=None):
+        super().__init__(self.tr("Header Viewer"), parent)
+        self._doc: Optional[ImageDocument] = None
+        self._doc_conn = False
+
+        self._tree = QTreeWidget()
+        self._tree.setHeaderLabels([self.tr("Key"), self.tr("Value")])
+        self._tree.setColumnWidth(0, 220)
+
+        self._save_btn = QPushButton(self.tr("Save Metadata…"))
+        self._save_btn.clicked.connect(self._save_metadata)
+        self._dm = None              # <-- NEW: DocManager to query "active"
+        self._follow_hover = False   # <-- optional toggle if you ever want hover-follow
+        w = QWidget(self)
+        lay = QVBoxLayout(w)
+        lay.setContentsMargins(6, 6, 6, 6)
+        lay.addWidget(self._tree)
+        lay.addWidget(self._save_btn)
+        self.setWidget(w)
+
+    def _same_base(self, a, b) -> bool:
+        return self._unwrap_base_doc(a) is self._unwrap_base_doc(b)
+
+    def attach_doc_manager(self, dm):
+        self._dm = dm
+        try:
+            # When docs are added/removed, re-evaluate the focused base
+            dm.documentAdded.connect(lambda _doc: self._maybe_refresh_for_active())
+            dm.documentRemoved.connect(lambda _doc: self._maybe_refresh_for_active())
+
+            # DO NOT use imageRegionUpdated to retarget; it can fire from hover-driven previews.
+            # If you want to repaint the same doc on region changes, _on_doc_changed handles that.
+
+            mdi = getattr(dm, "_mdi", None)
+            if mdi and hasattr(mdi, "subWindowActivated"):
+                mdi.subWindowActivated.connect(lambda _sw: self._maybe_refresh_for_active())
+
+            # NEW: snap to truly active base (sticky, click-activated only)
+            if hasattr(dm, "activeBaseChanged"):
+                dm.activeBaseChanged.connect(lambda _doc: self._maybe_refresh_for_active())
+        except Exception:
+            pass
+
+        self._maybe_refresh_for_active()
+
+
+    def set_follow_hover(self, enabled: bool):
+        self._follow_hover = bool(enabled)
+
+    # Prefer base (true) doc over transient wrappers/proxies
+    def _unwrap_base_doc(self, d):
+        if d is None:
+            return None
+        # ROI preview wrapper → parent
+        p = getattr(d, "_parent_doc", None)
+        if isinstance(p, ImageDocument):
+            return p
+        # LiveViewDocument proxy → base
+        b = getattr(d, "_base", None)
+        if isinstance(b, ImageDocument):
+            return b
+        return d
+
+    def _active_base_doc(self):
+        if not self._dm:
+            return None
+        # Prefer DocManager’s sticky focused base if available
+        if hasattr(self._dm, "get_focused_base_document"):
+            try:
+                return self._dm.get_focused_base_document()
+            except Exception:
+                pass
+        # Fallback: unwrap whatever get_active_document returns
+        try:
+            cur = self._dm.get_active_document()
+            return self._unwrap_base_doc(cur)
+        except Exception:
+            return None
+
+
+    def _maybe_refresh_for_active(self):
+        """Rebuild only if our bound document == current active base document."""
+        active_base = self._active_base_doc()
+        if active_base is None:
+            return
+        # If we already show the same base doc, just ignore
+        if self._unwrap_base_doc(self._doc) is active_base:
+            return
+        # Else bind to the active base doc
+        self.set_document(active_base)
+
+    # ---- public API ----
+    def set_document(self, doc: Optional[ImageDocument]):
+        """
+        Hard-lock behavior:
+        - If attached to a DocManager AND hover-follow is OFF, ignore the caller's 'doc'
+            and always bind to the DocManager's *active base* doc.
+        - Otherwise, behave like a normal setter.
+        """
+        if self._dm and not self._follow_hover:
+            # Caller cannot hijack focus: resolve from DM every time
+            doc = self._active_base_doc()
+
+        # Always resolve to base (true) document for internal storage
+        base_doc = self._unwrap_base_doc(doc)
+
+        # No-op if unchanged
+        if self._same_base(self._doc, base_doc):
+            return
+
+        # Disconnect old
+        if self._doc and hasattr(self._doc, "changed"):
+            try:
+                self._doc.changed.disconnect(self._on_doc_changed)
+            except Exception:
+                pass
+
+        self._doc = base_doc
+
+        # Listen for internal changes on the *bound* doc
+        if self._doc and hasattr(self._doc, "changed"):
+            try:
+                self._doc.changed.connect(self._on_doc_changed)
+            except Exception:
+                pass
+
+        self._rebuild()
+
+
+    def _on_doc_changed(self):
+        """
+        Only rebuild if our bound doc is STILL the active base doc.
+        Prevents spurious rebuilds when focus changed between signal emit and slot run.
+        """
+        if self._dm and not self._follow_hover:
+            active_base = self._active_base_doc()
+            if not self._same_base(self._doc, active_base):
+                # We got a change from an old/hover doc — ignore and snap to active.
+                self._maybe_refresh_for_active()
+                return
+        self._rebuild()
+
+
+    # --- helpers ---------------------------------------------------------
+    def _populate_header_dict(self, d: dict, title="Header (dict)"):
+        # We translate the default title if it's the default, but often title is passed in.
+        # If title is passed in English from other methods, we should translate it at the call site or here if possible.
+        # Since title is variable, we'll leave it as is, but ensure call sites pass translated strings.
+        root = QTreeWidgetItem([title])
+        self._tree.addTopLevelItem(root)
+        for k, v in d.items():
+            root.addChild(QTreeWidgetItem([str(k), str(v)]))
+
+    def _populate_header_snapshot(self, snap: dict):
+        fmt = (snap or {}).get("format", "")
+        if fmt == "fits-cards":
+            cards = snap.get("cards") or []
+            hdr = fits.Header()
+            for k, v, c in cards:
+                try:
+                    hdr[str(k)] = (v, c)
+                except Exception:
+                    # extremely defensive: skip bad card entries
+                    pass
+            try:
+                hdr = _drop_invalid_cards(hdr)
+            except Exception:
+                pass
+            self._populate_fits_header(hdr)
+        elif fmt == "dict":
+            self._populate_header_dict(snap.get("items") or {}, self.tr("Header (snapshot)"))
+        else:
+            # generic repr fallback
+            txt = (snap or {}).get("text", "")
+            node = QTreeWidgetItem([self.tr("Header (snapshot)")])
+            self._tree.addTopLevelItem(node)
+            node.addChild(QTreeWidgetItem(["repr", str(txt)]))
+
+
+    def _try_populate_from_doc(self, meta: dict) -> bool:
+        """Return True if we showed any header from the document metadata."""
+        # 1) direct astropy header
+        hdr = meta.get("original_header") or meta.get("fits_header") or meta.get("header")
+        if isinstance(hdr, fits.Header):
+            try:
+                hdr = _drop_invalid_cards(hdr.copy())
+            except Exception:
+                pass
+            self._populate_fits_header(hdr)
+            return True
+
+        # 2) dict-style header (e.g., XISF-style properties captured as dict)
+        if isinstance(hdr, dict):
+            self._populate_header_dict(hdr, self.tr("Header (dict from document)"))
+            return True
+
+        # 3) JSON-safe snapshot captured by DocManager
+        snap = meta.get("__header_snapshot__")
+        if isinstance(snap, dict):
+            self._populate_header_snapshot(snap)
+            return True
+
+        # 4) XISF properties stored in metadata (common keys)
+        for k in ("xisf_header", "xisf_properties"):
+            if isinstance(meta.get(k), dict):
+                self._populate_header_dict(meta[k], self.tr("XISF Properties (document)"))
+                return True
+
+        return False
+
+    def _try_populate_from_file(self, path: str, meta: dict) -> bool:
+        """Return True if we read & showed header from the backing file."""
+        if not path:
+            return False
+        p = path.lower()
+
+        # FITS (and MEF and .fz) via legacy helper
+        if p.endswith((".fits", ".fit", ".fz", ".fits.fz", ".fit.fz")):
+            # prefer the on-disk header if not already in meta
+            file_hdr = meta.get("original_header")
+            if isinstance(file_hdr, fits.Header):
+                try:
+                    file_hdr = _drop_invalid_cards(file_hdr.copy())
+                except Exception:
+                    pass
+            else:
+                file_hdr, _ = get_valid_header(path)
+
+            if isinstance(file_hdr, fits.Header):
+                self._populate_fits_header(file_hdr)
+                return True
+
+        # XISF: try to open and show basic properties if available
+        if p.endswith(".xisf"):
+            try:
+                xisf = XISF(path)
+                props = getattr(xisf, "properties", None)
+                if isinstance(props, dict):
+                    self._populate_header_dict(props, self.tr("XISF Properties"))
+                    return True
+            except Exception:
+                pass
+
+        return False
+
+
+    # --- main ------------------------------------------------------------
+    def _rebuild(self):
+        self._tree.clear()
+        base_doc = self._unwrap_base_doc(self._doc)
+        if not base_doc:
+            self.setWindowTitle(self.tr("Header Viewer"))
+            return
+        self._doc = base_doc
+
+        meta = self._doc.metadata or {}
+        path = (meta.get("file_path") or "") if isinstance(meta.get("file_path"), str) else ""
+        base = os.path.basename(path) if path else (meta.get("display_name") or self.tr("Untitled"))
+        self.setWindowTitle(self.tr("Header: {0}").format(base))
+
+        try:
+            # 1) Prefer header data already stored with the document
+            shown_any = self._try_populate_from_doc(meta)
+
+            # 2) If we didn't render anything yet, fall back to the file on disk
+            if not shown_any:
+                shown_any = self._try_populate_from_file(path, meta)
+
+            # 3) If there is a real astropy.wcs.WCS object, render it as key/value rows
+            try:
+                from astropy.wcs import WCS as _WCS
+                wcs_obj = meta.get("wcs")
+                if isinstance(wcs_obj, _WCS):
+                    self._populate_wcs(wcs_obj)
+            except Exception:
+                pass
+
+            # 4) Always show remaining lightweight metadata (skip heavy blobs we already rendered)
+            info_root = QTreeWidgetItem([self.tr("Metadata")])
+            self._tree.addTopLevelItem(info_root)
+            for k, v in meta.items():
+                if k in ("original_header", "fits_header", "header", "wcs", "__header_snapshot__", "xisf_header", "xisf_properties"):
+                    continue
+                info_root.addChild(QTreeWidgetItem([str(k), str(v)]))
+
+            self._tree.expandAll()
+
+        except Exception:
+            # per request: fail silently on final exception
+            pass
+
+
+    # ---- population helpers ----
+    def _populate_fits_header(self, header: Any):
+        root = QTreeWidgetItem([self.tr("FITS Header")])
+        self._tree.addTopLevelItem(root)
+
+        # FITS Header: sanitize and iterate cards defensively
+        if isinstance(header, fits.Header):
+            try:
+                header = _drop_invalid_cards(header)
+            except Exception:
+                pass
+
+            for card in header.cards:
+                try:
+                    k = str(card.keyword)
+                    v = str(card.value)
+                except VerifyError as e:
+                    # Skip invalid/unparsable card
+                    print(f"[HeaderViewer] Skipping invalid FITS card {getattr(card, 'keyword', '?')!r}: {e}")
+                    continue
+                except Exception as e:
+                    print(f"[HeaderViewer] Error reading FITS card: {e}")
+                    continue
+                root.addChild(QTreeWidgetItem([k, v]))
+
+        # Plain dict fallback (e.g., XISF-style dict)
+        elif isinstance(header, dict):
+            for k, v in header.items():
+                try:
+                    root.addChild(QTreeWidgetItem([str(k), str(v)]))
+                except Exception:
+                    continue
+
+
+    def _populate_wcs(self, wcs_obj):
+        """Show a real astropy.wcs.WCS as header-like key/values."""
+        root = QTreeWidgetItem([self.tr("WCS")])
+        self._tree.addTopLevelItem(root)
+        try:
+            # Use relax=True so SIP/etc. are included if present.
+            wcs_hdr = wcs_obj.to_header(relax=True)
+            for k, v in wcs_hdr.items():
+                root.addChild(QTreeWidgetItem([str(k), str(v)]))
+        except Exception:
+            # Fallback: parse the repr into lines (better than a single blob).
+            for line in str(wcs_obj).splitlines():
+                s = line.strip()
+                if not s:
+                    continue
+                if ":" in s:
+                    a, b = s.split(":", 1)
+                    root.addChild(QTreeWidgetItem([a.strip(), b.strip()]))
+                else:
+                    root.addChild(QTreeWidgetItem(["", s]))
+
+
+    def _populate_from_xisf(self, path: str):
+        x = XISF(path)
+        file_meta: Dict[str, Any] = x.get_file_metadata()
+        img_meta_list = x.get_images_metadata()
+        img_meta: Dict[str, Any] = img_meta_list[0] if img_meta_list else {}
+
+        # File-level metadata
+        froot = QTreeWidgetItem([self.tr("XISF File Metadata")])
+        self._tree.addTopLevelItem(froot)
+        for k, v in file_meta.items():
+            vstr = v.get("value", "") if isinstance(v, dict) else v
+            froot.addChild(QTreeWidgetItem([str(k), str(vstr)]))
+
+        # Image-level metadata
+        iroot = QTreeWidgetItem([self.tr("XISF Image Metadata")])
+        self._tree.addTopLevelItem(iroot)
+
+        # FITS-like keywords (nested)
+        if "FITSKeywords" in img_meta:
+            fits_item = QTreeWidgetItem(["FITSKeywords"])
+            iroot.addChild(fits_item)
+            for kw, entries in img_meta["FITSKeywords"].items():
+                for ent in entries:
+                    fits_item.addChild(QTreeWidgetItem([kw, str(ent.get("value", ""))]))
+
+        # XISFProperties (nested)
+        if "XISFProperties" in img_meta:
+            props_item = QTreeWidgetItem(["XISFProperties"])
+            iroot.addChild(props_item)
+            for prop_name, prop in img_meta["XISFProperties"].items():
+                props_item.addChild(QTreeWidgetItem([prop_name, str(prop.get("value", ""))]))
+
+        # Any remaining flat fields
+        for k, v in img_meta.items():
+            if k in ("FITSKeywords", "XISFProperties"):
+                continue
+            iroot.addChild(QTreeWidgetItem([k, str(v)]))
+
+        self._tree.expandAll()
+
+    # ---- export ----
+    def _save_metadata(self):
+        if not self._doc:
+            return
+        path, _ = QFileDialog.getSaveFileName(self, self.tr("Save Metadata"), "", self.tr("CSV (*.csv)"))
+        if not path:
+            return
+
+        # Flatten the QTreeWidget contents into key/value rows
+        rows = []
+        def walk(item: QTreeWidgetItem, prefix: str = ""):
+            key = item.text(0)
+            val = item.text(1)
+            full = f"{prefix}.{key}" if prefix else key
+            if key and val:
+                rows.append((full, val))
+            for i in range(item.childCount()):
+                walk(item.child(i), full)
+
+        for i in range(self._tree.topLevelItemCount()):
+            walk(self._tree.topLevelItem(i))
+
+        try:
+            with open(path, "w", newline="", encoding="utf-8") as f:
+                w = csv.writer(f)
+                w.writerow(["Key", "Value"])
+                w.writerows(rows)
+        except Exception as e:
+            QMessageBox.critical(self, self.tr("Save Metadata"), self.tr("Failed to save:\n{0}").format(e))

setiastro/saspro/headless_utils.py

@@ -0,0 +1,88 @@
+# pro/headless_utils.py
+from __future__ import annotations
+
+def unwrap_docproxy(x, max_depth: int = 8):
+    """
+    Safely unwrap live/roi/doc proxies to a real ImageDocument when possible.
+    - Recurses a few levels.
+    - Understands LiveViewDocument (_current/_base) and ROI wrappers (_parent_doc).
+    - Never unwraps to None unless input was None.
+    """
+    if x is None:
+        return None
+
+    seen = set()
+    y = x
+
+    for _ in range(max_depth):
+        if y is None or id(y) in seen:
+            break
+        seen.add(id(y))
+
+        # LiveViewDocument / similar: prefer its resolver
+        cur = getattr(y, "_current", None)
+        if callable(cur):
+            try:
+                z = cur()
+                if z is not None and z is not y:
+                    y = z
+                    continue
+            except Exception:
+                pass
+
+        # Common doc proxy fields (ordered)
+        for attr in (
+            "_base", "base",
+            "_parent_doc", "parent_doc",
+            "base_document", "_base_document",
+            "_target", "target",
+            "_doc", "doc",
+            "_obj", "obj",
+            "_proxied", "proxied",
+            "_wrapped", "wrapped",
+        ):
+            try:
+                z = getattr(y, attr, None)
+            except Exception:
+                z = None
+            if z is not None and z is not y:
+                y = z
+                break
+        else:
+            break
+
+    return y
+
+
+
+def normalize_headless_main(main_or_ctx, target_doc=None):
+    """
+    Returns (main_window, doc, doc_manager)
+    Ensures doc + dm are fully unwrapped and ROI-aware.
+    """
+    ctx = None
+    main = main_or_ctx
+
+    if hasattr(main_or_ctx, "app") and hasattr(main_or_ctx, "active_document"):
+        ctx = main_or_ctx
+        main = getattr(ctx, "app", None)
+        if target_doc is None:
+            try:
+                # Prefer dm.get_active_document() if possible (ROI-aware, real doc type)
+                dm0 = getattr(main, "doc_manager", None) or getattr(main, "dm", None)
+                dm0 = unwrap_docproxy(dm0)
+                if dm0 is not None and hasattr(dm0, "get_active_document"):
+                    target_doc = dm0.get_active_document()
+                else:
+                    target_doc = ctx.active_document()
+            except Exception:
+                target_doc = None
+
+    doc = unwrap_docproxy(target_doc)
+
+    dm = None
+    if main is not None:
+        dm = getattr(main, "doc_manager", None) or getattr(main, "dm", None)
+
+
+    return main, doc, dm