Metadata-Version: 2.3
Name: textual-enhanced
Version: 0.4.0
Summary: A library of mildly-opinionated enhancements to Textual
Project-URL: Homepage, https://github.com/davep/textual-enhanced
Project-URL: Repository, https://github.com/davep/textual-enhanced
Project-URL: Documentation, https://github.com/davep/textual-enhanced/blob/main/README.md
Project-URL: Source, https://github.com/davep/textual-enhanced
Project-URL: Issues, https://github.com/davep/textual-enhanced/issues
Project-URL: Discussions, https://github.com/davep/textual-enhanced/discussions
Author-email: Dave Pearson <davep@davep.org>
License: License :: OSI Approved :: MIT License
Keywords: framework,library,terminal,tui
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Libraries
Classifier: Topic :: Terminals
Classifier: Typing :: Typed
Requires-Python: >=3.9
Requires-Dist: textual>=1.0.0
Description-Content-Type: text/markdown

# textual-enhanced

## Introduction

This library is a mildly-opinionated set of enhancements and extras for the
Textual framework, mainly aimed at how I like my own Textual apps to look
and work. I've written this as a common set of tweaks I want for my own
Textual apps. It might be useful for yours too.

## Tweaks to Textual

### App-wide

- All vertical scrollbars are set to one character in width, by default (in
  my applications I try really hard to avoid horizontal scrolling, so it's
  nice to make scrollbars less obtrusive given I almost always only have
  vertical bars).

### The `Header` widget

- The icon on the left is hidden.
- The ability to click to expand the header is disabled.

### The command palette

I've tweaked the command palette so that:

- It doesn't take up the full width of the screen.
- <kbd>super</kbd>+<kbd>x</kbd> is added as an alternative method of calling
  it.
- <kbd>:</kbd> is added as an alternative method of calling it.
- The search icon is removed by default.
- The `background` is set to `$panel` by default.

### The loading indicator

The background is set to `transparent` by default.

## Additional Features

### With-some-batteries command palette/bindings

TODO: Explain.

## Widgets

### `EnhancedOptionList`

Adds `.preserved_highlight`, which can be used like:

```python
with stuff.preserved_highlight:
   ...rebuild the content of the list...
```

Adds a few more navigation keys.

Works around https://github.com/Textualize/textual/issues/5489.

Mild style tweaks.

### `TextViewer`

## Dialogs

### `HelpScreen`

TODO: Explain.

### `QuickInput`

TODO: Explain.

## Tools

### `add_key`

TODO: Explain.

[//]: # (README.md ends here)
