Metadata-Version: 2.4
Name: larztui
Version: 0.1.0
Summary: Pretty terminal UI - panels, tables and rules - zero dependencies
Author: larz-scripter
License: MIT
Project-URL: Homepage, https://github.com/larz-scripter/larztui
Project-URL: Repository, https://github.com/larz-scripter/larztui
Project-URL: Issues, https://github.com/larz-scripter/larztui/issues
Keywords: terminal,tui,table,panel,cli,console,rich,zero-dependency,pure-python
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
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 :: Python Modules
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# larztui

**Pretty terminal UI — panels, tables and rules — zero dependencies.**

A small, rich-style toolkit for good-looking terminal output with no dependency.
Everything is **width-aware**: it measures the *visible* width (ignoring ANSI
colour codes) so columns line up even when cells are styled — and it degrades
gracefully, switching colour off automatically when output isn't a terminal or
`NO_COLOR` is set.

## Install

```bash
pip install larztui
```

## Use

```python
from larztui import panel, table, rule, style, columns

print(rule("Report"))
print(table(["Name", "Score"], [["Ada", "99"], ["Bob", "5"]],
            aligns=["left", "right"], header_style={"bold": True}))
print(panel("All systems go.", title="Status", box="rounded"))
print(style("done", fg="green", bold=True))
```

```
──────────────────────── Report ─────────────────────────
┌───────┬───────┐
│ Name  │ Score │
├───────┼───────┤
│ Ada   │    99 │
│ Bob   │     5 │
└───────┴───────┘
```

## Tests

```bash
python -m unittest discover -s tests -v   # 17 tests
```

## The Larz stack

One of 60+ pure-Python, zero-dependency libraries at
[github.com/larz-scripter](https://github.com/larz-scripter). Complements
[larzprogress](https://github.com/larz-scripter/larzprogress) (bars/spinners) and
[larzcli](https://github.com/larz-scripter/larzcli).

## License

MIT (c) larz-scripter
