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

Built distribution (wheel)

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

Total release size: 57.2 kB

Release files / textual_drivers-0.10.1.tar.gz

Download URL textual_drivers-0.10.1.tar.gz
Size 24.4 kB
Tags Source
SHA-256 checksum
How to use checksums
9b047999d98256a933e7ae0c6b22745f2384292ab5374952e61e2b6fed2f3435
BLAKE2b-256 checksum
How to use checksums
77c56ed1d41bf66467c6c84f9479fb5619be78926ff0dc9a11e2f564f392e500
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.1-py3-none-any.whl

Download URL textual_drivers-0.10.1-py3-none-any.whl
Size 32.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
2016ba226415842179633def899f7622c6cec38517794e3a9443463cdd4023d3
BLAKE2b-256 checksum
How to use checksums
6c0fe9d3631a9205d7963b994eebc725751d847c9769d6b6b582534ed5a0c134
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