Metadata-Version: 2.4
Name: bittty
Version: 0.1.4
Summary: a pure python tty
Author-email: Gareth Davidson <gaz@bitplane.net>
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE.md
Requires-Dist: pywinpty==2.0.15; sys_platform == 'win32'
Requires-Dist: wcwidth>=0.8,<1
Requires-Dist: pre-commit ; extra == "dev"
Requires-Dist: pytest ; extra == "dev"
Requires-Dist: coverage ; extra == "dev"
Requires-Dist: pytest-cov ; extra == "dev"
Requires-Dist: pytest-asyncio ; extra == "dev"
Requires-Dist: plotext ; extra == "dev"
Requires-Dist: build ; extra == "dev"
Requires-Dist: twine ; extra == "dev"
Requires-Dist: ruff ; extra == "dev"
Requires-Dist: pydoc-markdown ; extra == "dev"
Requires-Dist: snakeviz ; extra == "dev"
Provides-Extra: dev

# bittty

A pure Python terminal emulator library. `Board` is an embeddable, headless
emulator core; the demo and `textual-tty` provide terminal frontends.

It was written as an alternative to `pyte`, and currently does not have a
graphical front-end.

## Demo

Run the standalone demo:

```bash
python ./demo/terminal.py
```

Or use the textual demo to see it in a TUI:

```bash
uvx textual-tty
```

## Links

* [🏠 home](https://bitplane.net/dev/python/bittty)
  * [📖 pydoc](https://bitplane.net/dev/python/bittty/pydoc)
  * [🚦 terminal mode support](https://bitplane.net/dev/python/bittty/DEC_private.html)
* [🐍 pypi](https://pypi.org/project/bittty)
* [🐱 github](https://github.com/bitplane/bittty)

## License

WTFPL with one additional clause

1. Don't blame me

Do wtf you want, but don't blame me when it rips a hole in your trousers.

## Known limitations

- Resizing is not atomic with concurrent PTY output.
- There is no scrollback buffer or reflow on resize.

