Registry / web-framework / textual-dev

textual-dev

JSON →
library1.8.0pypypiunverified

textual-dev is a Python library that provides command-line utilities and a development console to aid in building and debugging Textual TUI applications. It is released alongside the main Textual framework, which typically has a rapid release cadence, often weekly or bi-weekly for minor versions. The current version is 1.8.0.

pip install textual-dev
INSTALL
IMPORT
SIG · TEXTUAL-DEV
T
textual-dev
web-frameworkpythonv1.8.0
harness data pending
Install & Compatibility
Where this runs

No compatibility data collected yet for this library.

Code
Verified usage

To use textual-dev, first save the provided Python code as `my_app.py`. Then, open *two separate terminal windows*. In the first terminal, start the Textual development console. In the second, run your application in development mode, enabling it to connect to the console. This setup allows you to see logs, debug information, and perform live editing tasks. Terminal 1: ```bash pip install textual textual-dev textual console ``` Terminal 2: ```bash python my_app.py --dev # or, if textual is installed in path: # textual run --dev my_app.py ```

import os from textual.app import App, ComposeResult from textual.widgets import Header, Footer, Static # --- Save this as my_app.py --- class MyApp(App): BINDINGS = [("d", "toggle_dark", "Toggle dark mode")] def compose(self) -> ComposeResult: yield Header() yield Static("Hello, Textual Devtools!", id="hello") yield Footer() def action_toggle_dark(self) -> None: self.dark = not self.dark if __name__ == "__main__": app = MyApp() app.run()
textual-dev --version
Debug
Known issues
breakingThe `textual[dev]` extra was refactored into a separate `textual-dev` package in Textual v0.29.0. Users upgrading from older Textual versions (prior to 0.29.0) must now explicitly install `textual-dev` in addition to `textual` to access the development tools.
fix
`pip install textual textual-dev`
affects: <0.29.0 (of textual)
gotchaTextual, the core framework, has a rapid development cycle with frequent releases (often weekly or bi-weekly). While `textual-dev` aims to maintain compatibility, breaking changes in Textual's API can occasionally affect the functionality of the dev tools. Always check Textual's changelog for significant updates.
fix
Refer to the Textual documentation and changelog for compatibility notes before upgrading major/minor versions of either `textual` or `textual-dev`.
affects: All versions
gotchaWhile the `textual console` can display output from `print()` statements in your application, the recommended approach for logging and debugging in Textual is to use `app.log()` or the dedicated logging facilities provided by the `textual` framework. `print()` is generally discouraged for structured debugging output in Textual apps.
fix
Replace `print()` calls with `self.log("Your message")` or `self.app.log("Your message")` within your Textual application classes. Configure Textual's logging for more control.
affects: All versions
gotchaRecent releases of `textual-dev` (v1.8.0) explicitly add Python 3.14 compatibility. If you are using an older version of `textual-dev` or `textual` with Python 3.14, you may encounter unexpected issues or lack of support.
fix
Upgrade to `textual-dev` 1.8.0 or later for Python 3.14 compatibility: `pip install --upgrade textual-dev`.
affects: <1.8.0
Errors
Common errors & fixes
textual dev: command not found
The `dev` and `console` subcommands for the `textual` CLI are provided by the `textual-dev` package, which is not installed.
fix
pip install textual-dev
ModuleNotFoundError: No module named 'textual.dev'
The Python module name for the `textual-dev` package is `textual_dev`, not `textual.dev`.
fix
import textual_dev
Failed to connect to Textual application at localhost:8081
The Textual application is either not running, or it has not enabled devtools, or it is listening on a different host/port than the default.
fix
Ensure your Textual application calls `app.enable_devtools()` and is running. If necessary, specify the correct host/port: `textual console --host <APP_IP> --port <APP_PORT>`.
Incompatible Textual version. Expected textual >=0.x.x,<0.y.y, got 0.z.z
The installed version of `textual-dev` is not compatible with the installed version of the main `textual` library.
fix
Upgrade both packages to their latest compatible versions: `pip install --upgrade textual textual-dev`.
Upgrade
Version history
1.8.0latest on PyPI · released Oct 11, 2025
Audit
Dependencies
textualrequiredtextual-dev provides tools for Textual applications and requires Textual to function. It is highly recommended to install both together for development.
aiohttpoptionalUsed for the devtools connection and serving applications in a browser.
clickoptionalCommon dependency for building command-line interfaces.
Agent activity
6 hits · last 30 days
node
6
Resources
textual-dev — pip install textual-dev · libregistry