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.4.0.tar.gz (18.1 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.4.0-py3-none-any.whl (25.7 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: textual_drivers-0.4.0.tar.gz
  • Upload date:
  • Size: 18.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.11.24 {"installer":{"name":"uv","version":"0.11.24","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.4.0.tar.gz
Algorithm Hash digest
SHA256 29c243e09a3d72a2f6be247456ecf88b6ce930d72370645ad6013d1307f5be59
MD5 04f8bf0f0e65f0f0943aa4c859c8c60b
BLAKE2b-256 bdfe06891bf460a1013841dd78b161f6f96a9ae47560c202d017c4c81b262696

See more details on using hashes here.

File details

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

File metadata

  • Download URL: textual_drivers-0.4.0-py3-none-any.whl
  • Upload date:
  • Size: 25.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.11.24 {"installer":{"name":"uv","version":"0.11.24","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.4.0-py3-none-any.whl
Algorithm Hash digest
SHA256 316fafb5b0aab983ad2cbee9729779c4b68cf248171d0a0d440dd1cbb9a54d53
MD5 b316a15acd16f798f81250d7f5439178
BLAKE2b-256 457c7b08333c9bdf80f5a82480c780431edd966a824c60915dd42c8eb629026e

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