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
  • DnD: kitty drag-and-drop protocol via DNDApp

The docs/ folder in this repo mirrors the wiki and can be pushed to it with:

./sync-wiki.sh

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

textual_drivers-0.5.1.tar.gz (18.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

textual_drivers-0.5.1-py3-none-any.whl (25.9 kB view details)

Uploaded Python 3

File details

Details for the file textual_drivers-0.5.1.tar.gz.

File metadata

  • Download URL: textual_drivers-0.5.1.tar.gz
  • Upload date:
  • Size: 18.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.11.25 {"installer":{"name":"uv","version":"0.11.25","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}

File hashes

Hashes for textual_drivers-0.5.1.tar.gz
Algorithm Hash digest
SHA256 0f596a4d24e6d8d7047a409d007f1894b3e2507c4b1b5c23368971c6eb1ead4b
MD5 e767879b6bcfb0a571ab59e715bfdd14
BLAKE2b-256 c01ad2dad6a02fbfcfdb9cc25849c81617b13d490900acc7a2c5ebbc26bdcce3

See more details on using hashes here.

File details

Details for the file textual_drivers-0.5.1-py3-none-any.whl.

File metadata

  • Download URL: textual_drivers-0.5.1-py3-none-any.whl
  • Upload date:
  • Size: 25.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.11.25 {"installer":{"name":"uv","version":"0.11.25","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}

File hashes

Hashes for textual_drivers-0.5.1-py3-none-any.whl
Algorithm Hash digest
SHA256 87d8b69b908b9bdde91dc66bd5bbefa3ee0ab6f2e03510f1eafc7a1a3b1c3f5d
MD5 a06e2229adb0dadf92bc147f1b5cf21a
BLAKE2b-256 99673ee71f4f584b25c927b3ff84a33b51585af8410339f13f91a31e6e0a178b

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page