This release is a pre-release and may not be stable for production use.
lazy-cuh
lazy-cuh is an experimental Python framework for building lazygit-style
terminal user interfaces on top of Textual.
It provides reusable building blocks for terminal apps that need pane-based navigation, compact key hints, modal flows, and list/tree content that behaves consistently.
Status
Pre-alpha. The package is useful for experimentation and early dogfooding, but APIs are expected to change before a stable release.
Features
- bordered panels with numbered titles and tabs
- vim-like item navigation and optional line numbers
- reusable list, tree, text, and option-style views
- contextual keybars and expandable help hints
- confirm, input, info, and notice models
- action, command, and keybinding primitives
- clear separation between app state, rendering, navigation, viewport, and Textual widget adapters
Installation
pip install lazy-cuh
Pre-release versions may need:
pip install --pre lazy-cuh
Quick Example
from rich.text import Text
from lazy_cuh import (
LineNumberMode,
LineNumberSpec,
ListViewModel,
ListViewSpec,
NavigableItem,
)
items = (
NavigableItem(id="panels", label=Text("Composable panels and tabs")),
NavigableItem(id="navigation", label=Text("Vim-style item navigation")),
NavigableItem(id="keybars", label=Text("Context-aware keybars")),
)
view = ListViewModel(
items=items,
cursor_index=1,
spec=ListViewSpec(
width=60,
line_numbers=LineNumberSpec(LineNumberMode.RELATIVE),
),
)
for line in view.rendered_lines():
print(line.plain)
Examples
After installing from source, run the interactive demo:
uv run lazy-cuh-demo
Focused examples are also available:
uv run lazy-cuh-example-text-wrap
uv run lazy-cuh-example-help-modal
uv run lazy-cuh-example-help-keybar
uv run lazy-cuh-example-options
Documentation
The documentation lives in docs/ and is built with Astro Starlight. Start
with the quick start for a minimal view, then use the app-structure guide for
the recommended full-app composition path. The docs also cover lists, trees,
panels, keybars, modals, and Textual adapters.
Development
For local development:
uv sync --extra dev --extra release
uv run pytest
uv run pyright
uv run ruff check .
Nix users can enter the packaged development shell with:
nix develop
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file lazy_cuh-0.1.0a2.tar.gz.
File metadata
- Download URL: lazy_cuh-0.1.0a2.tar.gz
- Upload date:
- Size: 67.0 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
2a08d2a37b283bc5d31a10516066232c0eab338c7a1ced503d1d19450fd66d67
|
|
| MD5 |
2a1efff5ddac1e93546fd3e680a4eba1
|
|
| BLAKE2b-256 |
613e97142a2e4c261af8ebe3163371e2b2c65111e3bd35e1b717814e1da12cad
|
Provenance
The following attestation bundles were made for lazy_cuh-0.1.0a2.tar.gz:
Publisher:
release.yml on janthmueller/lazy-cuh
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
lazy_cuh-0.1.0a2.tar.gz -
Subject digest:
2a08d2a37b283bc5d31a10516066232c0eab338c7a1ced503d1d19450fd66d67 - Sigstore transparency entry: 1886836819
- Sigstore integration time:
-
Permalink:
janthmueller/lazy-cuh@bda1cacf8fb2d2687487057daf127a8a7d497585 -
Branch / Tag:
refs/heads/main - Owner: https://github.com/janthmueller
-
Access:
private
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@bda1cacf8fb2d2687487057daf127a8a7d497585 -
Trigger Event:
workflow_run
-
Statement type:
File details
Details for the file lazy_cuh-0.1.0a2-py3-none-any.whl.
File metadata
- Download URL: lazy_cuh-0.1.0a2-py3-none-any.whl
- Upload date:
- Size: 66.9 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
5e7e0f2083c1873ab31133820d277feba3f33d94443a4a5f8567e3e71ba5c84d
|
|
| MD5 |
6def74326c4bfa5ef4f4c449f504bc0a
|
|
| BLAKE2b-256 |
85af2a8d3e08aabe7e74e3d44984d2c3a25927d7908c49915f1c4e5e53854dda
|
Provenance
The following attestation bundles were made for lazy_cuh-0.1.0a2-py3-none-any.whl:
Publisher:
release.yml on janthmueller/lazy-cuh
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
lazy_cuh-0.1.0a2-py3-none-any.whl -
Subject digest:
5e7e0f2083c1873ab31133820d277feba3f33d94443a4a5f8567e3e71ba5c84d - Sigstore transparency entry: 1886836895
- Sigstore integration time:
-
Permalink:
janthmueller/lazy-cuh@bda1cacf8fb2d2687487057daf127a8a7d497585 -
Branch / Tag:
refs/heads/main - Owner: https://github.com/janthmueller
-
Access:
private
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@bda1cacf8fb2d2687487057daf127a8a7d497585 -
Trigger Event:
workflow_run
-
Statement type:
