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.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.9.0
File Size Uploaded
textual_drivers-0.9.0.tar.gz 23.5 kB Details

Built distribution (wheel)

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

Total release size: 54.1 kB

Release files / textual_drivers-0.9.0.tar.gz

Download URL textual_drivers-0.9.0.tar.gz
Size 23.5 kB
Tags Source
SHA-256 checksum
How to use checksums
7b8f654c51f2cfa156a4f5873f36767f6dbb49f5b025c846e4e05a617787263d
BLAKE2b-256 checksum
How to use checksums
92cbfc26013d080a9a5b2480e411c5e708b3a6a15dfacd50e4b6a211fe84ce59
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.0-py3-none-any.whl

Download URL textual_drivers-0.9.0-py3-none-any.whl
Size 30.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
3896fc3b966e2f8a439bafbcd6d551460012733a936f33fa016d7a4c33535f0a
BLAKE2b-256 checksum
How to use checksums
1ec69438e50b5ff27eb5b03505d2ea6f816a64282e8e0b7cf59da5f1027a283a
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