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

Uploaded Python 3

File details

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

File metadata

  • Download URL: textual_drivers-0.5.0.tar.gz
  • Upload date:
  • Size: 18.5 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.0.tar.gz
Algorithm Hash digest
SHA256 0b86c63c870a588dfe9d9d4a1d4c5fca44ce2a77efcc45929ae581e2ddd763c9
MD5 f559e90c263a1aefdb29b39a220f017f
BLAKE2b-256 5240aad3e7494d0eb44b2cc23e2d76845a9d7016d981edc673bd4bb4525abbbb

See more details on using hashes here.

File details

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

File metadata

  • Download URL: textual_drivers-0.5.0-py3-none-any.whl
  • Upload date:
  • Size: 25.7 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.0-py3-none-any.whl
Algorithm Hash digest
SHA256 7546526fa36c43bc19bb2d79d4c761a43e9bef954c049d3440192d338edb57c9
MD5 33f3f985e867b2a316e1188990016252
BLAKE2b-256 cda78dffaaff1530b296ac257396c8794275f0753cd816c834cea2c07407fcf2

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