Skip to main content

textual-drivers

Drop-in subclasses of Textual's built-in terminal drivers with two extra capabilities:

  • lock_stdin: pause the driver's stdin thread and silence terminal events so you can run terminal queries or subprocesses without interference
  • register_event_handler: bind a pattern against raw stdin; when it matches, a Message is posted into Textual's event system

A higher-level DNDApp base class builds on these to implement the full kitty drag-and-drop protocol (drag-in and drag-out).

Installation

uv add textual-drivers

Quick start

from textual_drivers import DrivenApp

class MyApp(DrivenApp):
    ...

MyApp().run()

DrivenApp picks the right platform driver automatically.

Documentation

Full docs are on the wiki:

  • Drivers: driver classes, DrivenApp, and mixin usage
  • lock_stdin: exclusive stdin ownership for terminal queries and subprocesses
  • register_event_handler: pattern-based raw stdin -> Textual message routing
  • Drag 'n Drop: kitty drag-and-drop protocol via DNDApp (the main reason for this package)

Release files for textual-drivers 0.9.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for textual-drivers 0.9.1
File Size Uploaded
textual_drivers-0.9.1.tar.gz 23.6 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for textual-drivers 0.9.1
File Interpreter ABI Platform
textual_drivers-0.9.1-py3-none-any.whl Python 3 none any Details

Total release size: 54.2 kB

Release files / textual_drivers-0.9.1.tar.gz

Download URL textual_drivers-0.9.1.tar.gz
Size 23.6 kB
Tags Source
SHA-256 checksum
How to use checksums
b449eab2e068fabbd7c6e7ddbe804b43424c411db492898b79fb05474e8b8872
BLAKE2b-256 checksum
How to use checksums
3dfe977377da3b05a151ca9b979a56d75747f95b35d9b49f842c707d661bb546
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.12.3 {"installer":{"name":"uv","version":"0.12.3","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Release files / textual_drivers-0.9.1-py3-none-any.whl

Download URL textual_drivers-0.9.1-py3-none-any.whl
Size 30.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
7af40c67a71c3779ca723db0dc6927c0fd733fc5bfb97f4a127fef2a5aaedbc2
BLAKE2b-256 checksum
How to use checksums
ae38a88e84da326ed749494a7d0bb9d6872aac01517e9b5fadc2b4ba08bab11a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.12.3 {"installer":{"name":"uv","version":"0.12.3","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page