How beeware/toga works
Toga is a Python native, OS-native GUI toolkit. An application uses the shared Toga API to define app behavior and UI; platform selection then supplies a native backend that presents widgets and handles OS events. The repository also includes shared commands, dialogs, documents, hardware access, screens, and data sources. Backend coverage is broad, but only a subset of backend source was sampled; uncertain dispatch and runtime links are therefore omitted or marked unverified.
Main entry points: platform.py Backend selection · app.py App lifecycle · command.py Commands and menus · screens.py Screens
Components 22
Shared toolkit
- App lifecycle
core/src/toga/app.py - Backend selection
core/src/toga/platform.py - Commands and menus
core/src/toga/command.py - Async handlers
core/src/toga/handlers.py - Dialogs
core/src/toga/dialogs.py - Document support
core/src/toga/documents.py
UI and data
- Widget interfaces
core/src/toga/widgets - Windows
core/src/toga/window.py - List and tree data
core/src/toga/sources - Style and layout
core/src/toga/style
Native backends
- Android backend
android/src/toga_android/app.py - Cocoa backend
cocoa/src/toga_cocoa/app.py - GTK backend
gtk/src/toga_gtk/app.py - iOS backend
iOS/src/toga_iOS/app.py - Qt backend
qt/src/toga_qt/app.py - Web backend
web/src/toga_web/app.py - Textual backend
textual/src/toga_textual/app.py - Windows backend
winforms/src/toga_winforms/app.py
Platform services
- Hardware access
core/src/toga/hardware - Screens
core/src/toga/screens.py - Icons and assets
core/src/toga/icons.py
Other components
- Python app developer
Connections 29
- Python app developer → App lifecycle: defines app
README.md - App lifecycle → Backend selection: selects backend
core/src/toga/app.py - App lifecycle → Commands and menus: creates commands
core/src/toga/app.py - App lifecycle → Dialogs: opens dialogs
core/src/toga/app.py - App lifecycle → Document support: configures documents
core/src/toga/app.py - App lifecycle → Hardware access: accesses hardware
core/src/toga/app.py - App lifecycle → Screens: uses screens
core/src/toga/app.py - App lifecycle → Icons and assets: uses icons
core/src/toga/app.py - Commands and menus → Async handlers: wraps handlers
core/src/toga/command.py - Commands and menus → Icons and assets: uses icons
core/src/toga/command.py - Backend selection → Android backend: loads backend
- Backend selection → Cocoa backend: loads backend
cocoa/src/toga_cocoa/app.py - Backend selection → GTK backend: loads backend
- Backend selection → iOS backend: loads backend
- Backend selection → Qt backend: loads backend
- Backend selection → Web backend: loads backend
- Backend selection → Textual backend: loads backend
- Backend selection → Windows backend: loads backend
- Android backend → Screens: implements screens
- Cocoa backend → Commands and menus: builds menus
cocoa/src/toga_cocoa/app.py - GTK backend → Commands and menus: registers actions
gtk/src/toga_gtk/app.py - iOS backend → Screens: uses screens
iOS/src/toga_iOS/app.py - Qt backend → Commands and menus: uses commands
qt/src/toga_qt/app.py - Web backend → Screens: uses screens
web/src/toga_web/app.py - Textual backend → Screens: uses screens
textual/src/toga_textual/app.py - Windows backend → Dialogs: uses dialogs
winforms/src/toga_winforms/app.py - Widget interfaces → List and tree data: uses data sources
- Widget interfaces → Style and layout: uses styling
- Widget interfaces → Windows: displayed in