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.10.0

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.10.0
File Size Uploaded
textual_drivers-0.10.0.tar.gz 24.4 kB Details

Built distribution (wheel)

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

Total release size: 57.2 kB

Release files / textual_drivers-0.10.0.tar.gz

Download URL textual_drivers-0.10.0.tar.gz
Size 24.4 kB
Tags Source
SHA-256 checksum
How to use checksums
f418f3829deebb53b01fedb966071c0ea81d02dfdbfdefba9198a115b4bb622d
BLAKE2b-256 checksum
How to use checksums
273635e5aa26f8f6b92cd56c4dba35291e17545abdab44845f2d89b3a9057c58
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.10.0-py3-none-any.whl

Download URL textual_drivers-0.10.0-py3-none-any.whl
Size 32.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
1836b0a982bb98bf48f5603a65aebd272cc59d88e6f8867651518a1266a2ad97
BLAKE2b-256 checksum
How to use checksums
2f64d6e6acbc36a113b017ca4a1d5d9895d75e7af87664ec3c67dff03e75ce6f
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