WxPython Desktop Frontend

The wxPython desktop client for Pytigon provides a native GUI experience using the wxWidgets toolkit.

Overview

Pytigon GUI (pytigon_gui) is the wxPython desktop frontend for the Pytigon framework. It provides a rich set of GUI components — frames, pages, notebooks, toolbars, grids, form controls, and popups — all integrated with the Django web backend.

Architecture

Tag-based UI Definition → Tag Parser → wxPython Widget Tree → Native Desktop Window
         ↑                                                        |
         └──────── Django Backend via HTTP/WebSocket ─────────────┘

The desktop client parses XML-like tag syntax (<ctrl>, <button>, <grid>) into native wxPython widgets. Each tag attributes map to widget properties, and the resulting control tree is rendered as a native desktop application.

Key Components

Module Purpose
pytigon.py Main application entry point (~50K lines)
wxauto.py wxPython automation utilities
guictrl/ GUI controls — tags, buttons, grids, inputs, popups
guiframe/ Application frames — app, browser, form, notebook, page
guilib/ GUI library — events, images, login, threading, WebSocket
toolbar/ Toolbars — modern, standard, tree, generic, menu bar

Quick Start

from pytigon_gui.pytigon import main
main()

Key Design Patterns

  • Tag-based UI — XML-like tag syntax parsed into wxPython widgets
  • Device Context — Shared rendering abstraction with pytigon_lib.schhtml
  • Notebook/Page — Tabbed document interface with dynamic page creation
  • Signal System — Event-driven communication between components
  • WebSocket Bridge — Real-time communication with the Django backend

Dependencies

  • Python 3.12+
  • wxPython 4.x+
  • Django
  • pytigon (backend framework)
  • pytigon_lib (core library)
?: WxPython ?: WxPython