How textualize/textual works
Textual is a Python framework for building asynchronous, cross-platform terminal and browser interfaces. The user workflow is to define an App and compose widgets, then run it: the App manages screens and message handling, widgets render through layout and styling, and a platform driver exchanges input and output with the terminal or browser. Other major capabilities include CSS queries, reactive state, command palettes, and rich built-in widgets such as tables, Markdown, and text areas. Edges reflect README statements and sampled source references; unsampled implementation links are omitted where evidence is insufficient.
Main entry points: widget.py Widget base · app.py App lifecycle · driver.py Driver interface · screen.py Screens
Components 24
App runtime
- App lifecycle
src/textual/app.py - Screens
src/textual/screen.py - Message dispatch
src/textual/message_pump.py - Async workers
src/textual/worker.py
UI model
- DOM tree
src/textual/dom.py - Reactive state
src/textual/reactive.py - Events
src/textual/events.py - Key bindings
src/textual/binding.py
Presentation
- CSS parsing
src/textual/css/parse.py - CSS queries
src/textual/css/query.py - Styles
src/textual/css/styles.py - Layout engine
src/textual/layout.py - Rendering
src/textual/render.py
Platform I/O
- Driver interface
src/textual/driver.py - Terminal drivers
src/textual/drivers/linux_driver.py - Browser driver
src/textual/drivers/web_driver.py
Widgets
- Widget base
src/textual/widget.py - Built-in widgets
src/textual/widgets - Text editor
src/textual/widgets/_text_area.py - Data table
src/textual/widgets/_data_table.py - Markdown viewer
src/textual/widgets/_markdown.py
Other components
- App developer
- Terminal
- Browser client
Connections 24
- App developer → App lifecycle: defines and runs
- App lifecycle → Screens: manages screens
src/textual/app.py - App lifecycle → Message dispatch: dispatches messages
- App lifecycle → Driver interface: uses driver
src/textual/driver.py - App lifecycle → Async workers: runs workers
src/textual/worker.py - Screens → Widget base: hosts widgets
- Widget base → DOM tree: extends DOM
src/textual/dom.py - Widget base → Reactive state: uses state
src/textual/reactive.py - Widget base → Events: handles events
src/textual/events.py - Widget base → Key bindings: uses bindings
src/textual/binding.py - DOM tree → CSS queries: creates queries
src/textual/dom.py - CSS queries → CSS parsing: parses selectors
src/textual/css/query.py - Widget base → Styles: applies styles
src/textual/widget.py - Widget base → Layout engine: arranges children
src/textual/widget.py - Widget base → Rendering: renders content
src/textual/widget.py - CSS parsing → Styles: builds styles
src/textual/css/styles.py - Built-in widgets → Widget base: extends base
src/textual/widgets/_data_table.py - Text editor → Widget base: extends base
src/textual/widgets/_text_area.py - Data table → Widget base: extends base
src/textual/widgets/_data_table.py - Markdown viewer → Widget base: extends base
src/textual/widgets/_markdown.py - Driver interface → Terminal drivers: selects platform
src/textual/drivers/linux_driver.py - Driver interface → Browser driver: selects platform
src/textual/drivers/web_driver.py - Terminal drivers → Terminal: exchanges I/O
- Browser driver → Browser client: exchanges I/O