kigo-gui-framework 3.1__tar.gz → 3.2__tar.gz

{kigo_gui_framework-3.1/kigo_gui_framework.egg-info → kigo_gui_framework-3.2}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: kigo-gui-framework
-Version: 3.1
-Summary: Kigo has two CLI commands now. kigo run runs your app and kigo doctor checks your app for bugs
+Version: 3.2
+Summary: Kigo has Time Freeze Debugging and a Visual Inspector now.
 Author: Anand Kumar
 License: Zlib
 Keywords: gui,qt,pyqt,webengine,opengl,wasm,android,chromeos,framework

kigo_gui_framework-3.2/README.txt

@@ -0,0 +1,2 @@
+Kigo now has time freeze debugging and a scene inspector using my Neolog
+engine (well, it is based off of Qt's things, but who cares, neolog is a good name)

kigo_gui_framework-3.2/kigo/debug/__init__.py

@@ -0,0 +1,3 @@
+from .freeze import freeze
+
+__all__ = ["freeze"]

kigo_gui_framework-3.2/kigo/debug/freeze.py

@@ -0,0 +1,54 @@
+# SPDX-License-Identifier: Zlib
+# kigo/debug/freeze.py
+
+from kigo.qt.backend import QtCore, QtWidgets
+
+
+def freeze(reason: str = "Execution paused", *, data: dict | None = None):
+    """
+    Freeze execution while keeping the Qt event loop alive.
+    Used for visual + state debugging.
+
+    This does NOT crash or block Qt internally.
+    """
+
+    # Dialog shown during freeze
+    dialog = QtWidgets.QDialog()
+    dialog.setWindowTitle("Kigo Time Freeze")
+    dialog.setModal(False)
+    dialog.setWindowFlags(
+        QtCore.Qt.WindowType.WindowStaysOnTopHint
+        | QtCore.Qt.WindowType.Dialog
+    )
+
+    layout = QtWidgets.QVBoxLayout(dialog)
+
+    label = QtWidgets.QLabel(f"🧊 {reason}")
+    label.setStyleSheet("font-weight: bold; font-size: 14px;")
+    layout.addWidget(label)
+
+    if data:
+        text = QtWidgets.QPlainTextEdit()
+        text.setReadOnly(True)
+        pretty = "\n".join(f"{k}: {v}" for k, v in data.items())
+        text.setPlainText(pretty)
+        layout.addWidget(text)
+
+    btn = QtWidgets.QPushButton("Resume")
+    layout.addWidget(btn)
+
+    # Local event loop = time freeze
+    loop = QtCore.QEventLoop()
+
+    btn.clicked.connect(loop.quit)
+    dialog.finished.connect(loop.quit)
+
+    dialog.show()
+
+    # Process paint events before freezing
+    QtWidgets.QApplication.processEvents()
+
+    #  TIME FREEZE STARTS HERE
+    loop.exec()
+
+    dialog.close()

kigo_gui_framework-3.2/kigo/inspector/__init__.py

@@ -0,0 +1,3 @@
+from .inspector import enable_inspector
+
+__all__ = ["enable_inspector"]

kigo_gui_framework-3.2/kigo/inspector/inspector.py

@@ -0,0 +1,50 @@
+# SPDX-License-Identifier: Zlib
+# kigo/inspector/inspector.py
+
+from kigo.qt.backend import QtCore, QtWidgets
+from kigo.inspector.overlay import Overlay
+from kigo.inspector.panel import InspectorPanel
+
+
+class Inspector(QtCore.QObject):
+    def __init__(self, app: QtWidgets.QApplication):
+        super().__init__()
+        self.app = app
+        self.overlay = Overlay()
+        self.panel = InspectorPanel()
+
+        self.app.installEventFilter(self)
+
+    def attach(self):
+        for w in self.app.topLevelWidgets():
+            if isinstance(w, QtWidgets.QMainWindow):
+                w.addDockWidget(
+                    QtCore.Qt.DockWidgetArea.RightDockWidgetArea,
+                    self.panel,
+                )
+                self.overlay.setParent(w)
+                self.overlay.resize(w.size())
+
+    def eventFilter(self, obj, event):
+        if isinstance(event, QtCore.QEvent):
+            if event.type() == QtCore.QEvent.Type.MouseMove:
+                widget = self.app.widgetAt(event.globalPosition().toPoint())
+                if widget:
+                    rect = widget.rect()
+                    top_left = widget.mapToGlobal(rect.topLeft())
+                    self.overlay.highlight(
+                        QtCore.QRect(top_left, rect.size())
+                    )
+
+            elif event.type() == QtCore.QEvent.Type.MouseButtonPress:
+                widget = self.app.widgetAt(event.globalPosition().toPoint())
+                self.panel.inspect(widget)
+                return True
+
+        return False
+
+
+def enable_inspector(app: QtWidgets.QApplication):
+    inspector = Inspector(app)
+    inspector.attach()
+    return inspector

kigo_gui_framework-3.2/kigo/inspector/overlay.py

@@ -0,0 +1,36 @@
+# SPDX-License-Identifier: Zlib
+# kigo/inspector/overlay.py
+
+from kigo.qt.backend import QtWidgets, QtGui, QtCore
+
+
+class Overlay(QtWidgets.QWidget):
+    def __init__(self, parent=None):
+        super().__init__(parent)
+        self.setAttribute(QtCore.Qt.WidgetAttribute.WA_TransparentForMouseEvents)
+        self.setAttribute(QtCore.Qt.WidgetAttribute.WA_NoSystemBackground)
+        self.setAttribute(QtCore.Qt.WidgetAttribute.WA_AlwaysStackOnTop)
+        self.hide()
+
+        self._rect = None
+
+    def highlight(self, rect: QtCore.QRect):
+        self._rect = rect
+        self.setGeometry(rect.adjusted(-2, -2, 2, 2))
+        self.show()
+        self.raise_()
+        self.update()
+
+    def clear(self):
+        self._rect = None
+        self.hide()
+
+    def paintEvent(self, event):
+        if not self._rect:
+            return
+
+        painter = QtGui.QPainter(self)
+        painter.setRenderHint(QtGui.QPainter.RenderHint.Antialiasing)
+        pen = QtGui.QPen(QtGui.QColor(0, 180, 255), 2, QtCore.Qt.PenStyle.DashLine)
+        painter.setPen(pen)
+        painter.drawRect(self.rect().adjusted(1, 1, -1, -1))

kigo_gui_framework-3.2/kigo/inspector/panel.py

@@ -0,0 +1,41 @@
+# SPDX-License-Identifier: Zlib
+# kigo/inspector/panel.py
+
+from kigo.qt.backend import QtWidgets
+
+
+class InspectorPanel(QtWidgets.QDockWidget):
+    def __init__(self):
+        super().__init__("Kigo Inspector")
+        self.setAllowedAreas(
+            self.DockWidgetArea.LeftDockWidgetArea
+            | self.DockWidgetArea.RightDockWidgetArea
+        )
+
+        self.text = QtWidgets.QPlainTextEdit()
+        self.text.setReadOnly(True)
+        self.setWidget(self.text)
+
+    def inspect(self, widget):
+        if widget is None:
+            self.text.setPlainText("No widget")
+            return
+
+        info = []
+        info.append(f"Class: {widget.__class__.__name__}")
+        info.append(f"ObjectName: {widget.objectName() or '(none)'}")
+        info.append(f"Visible: {widget.isVisible()}")
+        info.append(f"Enabled: {widget.isEnabled()}")
+        info.append(f"Geometry: {widget.geometry()}")
+
+        parents = []
+        p = widget.parentWidget()
+        while p:
+            parents.append(p.__class__.__name__)
+            p = p.parentWidget()
+
+        info.append("Parent chain:")
+        for name in parents:
+            info.append(f"  ↳ {name}")
+
+        self.text.setPlainText("\n".join(info))

{kigo_gui_framework-3.1 → kigo_gui_framework-3.2/kigo_gui_framework.egg-info}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: kigo-gui-framework
-Version: 3.1
-Summary: Kigo has two CLI commands now. kigo run runs your app and kigo doctor checks your app for bugs
+Version: 3.2
+Summary: Kigo has Time Freeze Debugging and a Visual Inspector now.
 Author: Anand Kumar
 License: Zlib
 Keywords: gui,qt,pyqt,webengine,opengl,wasm,android,chromeos,framework

{kigo_gui_framework-3.1 → kigo_gui_framework-3.2}/kigo_gui_framework.egg-info/SOURCES.txt

@@ -29,12 +29,18 @@ kigo/android/ossupport.py
 kigo/cli/__init__.py
 kigo/cli/doctor.py
 kigo/cli/main.py
+kigo/debug/__init__.py
+kigo/debug/freeze.py
 kigo/ecs/__init__.py
 kigo/ecs/component.py
 kigo/ecs/entity.py
 kigo/ecs/render.py
 kigo/ecs/system.py
 kigo/ecs/world.py
+kigo/inspector/__init__.py
+kigo/inspector/inspector.py
+kigo/inspector/overlay.py
+kigo/inspector/panel.py
 kigo/logging/__init__.py
 kigo/logging/jsonlog.py
 kigo/net/__init__.py

{kigo_gui_framework-3.1 → kigo_gui_framework-3.2}/pyproject.toml

@@ -5,8 +5,8 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "kigo-gui-framework"
-version = "3.1"
-description = "Kigo has two CLI commands now. kigo run runs your app and kigo doctor checks your app for bugs"
+version = "3.2"
+description = "Kigo has Time Freeze Debugging and a Visual Inspector now."
 readme = "README.md"
 license = { text = "Zlib" }
 

kigo_gui_framework-3.1/README.txt

@@ -1,10 +0,0 @@
-Kigo now has support for networking and
-SunOS
-Solaris
-FreeBSD
-Android
-Linux
-Mac 
-Windous
-ChromeOS
-Do  not use v2.8 (missing __init__.py)