pgwidgets-python

Python bindings for the pgwidgets JavaScript widget library. Build desktop-style browser UIs from Python with a familiar Qt/GTK-style API.

from pgwidgets.sync import Application

app = Application()

@app.on_connect
def setup(session):
    Widgets = session.get_widgets()
    top = Widgets.TopLevel(title="Hello", resizable=True)
    top.resize(400, 300)

    vbox = Widgets.VBox(spacing=8, padding=10)
    btn = Widgets.Button("Click me")
    label = Widgets.Label("Ready")

    btn.on("activated", lambda: label.set_text("Clicked!"))

    vbox.add_widget(btn, 0)
    vbox.add_widget(label, 1)
    top.set_widget(vbox)
    top.show()

app.run()

User Guide

• Getting Started
  • Installation
  • Quick Start
  • Running the Examples
  • Choosing Sync vs Async
• Architecture
  • Overview
  • Servers
  • JSON Protocol
  • Session Model
  • Reconnection and Reconstruction
  • Multi-Browser Synchronization
  • Headless Sessions
  • Widget References
• Synchronous API
  • Application
  • Session
  • Concurrency Modes
  • Full Example
• Asynchronous API
  • Application
  • Session
  • Concurrency Modes
  • Full Example
• Using an External Web Server
  • Setup Overview
  • nginx
  • FastAPI
  • Flask
  • Apache
  • Caddy
  • Security Considerations
• Widget Reference
  • Base Methods
  • Layout Containers
  • Windows
  • Buttons and Controls
  • Text
  • Selectors
  • Color
  • Data Display
  • Non-Visual
  • Menus and Toolbars
• Subclassing Widgets
  • Widget Class Basics
  • Importing Widget Classes
  • Subclassing with get_widgets()
  • Subclassing with Module-Level Imports
  • Async Subclassing
  • Constructor Parameters
  • Internal Construction
• Callback System
  • Registering Callbacks
  • Callback Signatures
  • File Transfers (Chunked Protocol)

API Reference

• API Reference
  • pgwidgets.sync
  • pgwidgets.async_