Metadata-Version: 2.4
Name: provide-uterm
Version: 0.5.1
Summary: Shared terminal I/O primitives for the provide ecosystem
Author: provide.io llc
License-Expression: AGPL-3.0-or-later
Project-URL: Homepage, https://github.com/provide-io/provide-uterm
Project-URL: Repository, https://github.com/provide-io/provide-uterm
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: System :: Networking
Classifier: Topic :: Terminals
Classifier: Framework :: FastAPI
Requires-Python: >=3.11
Description-Content-Type: text/markdown
Requires-Dist: provide-telemetry>=0.7
Requires-Dist: aiosqlite>=0.22
Requires-Dist: pydantic>=2.0
Provides-Extra: emulator
Requires-Dist: pyte>=0.8; extra == "emulator"
Provides-Extra: ssh
Requires-Dist: asyncssh>=2.14; extra == "ssh"
Provides-Extra: client
Requires-Dist: httpx2>=2.10; extra == "client"
Provides-Extra: all
Requires-Dist: pyte>=0.8; extra == "all"
Requires-Dist: asyncssh>=2.14; extra == "all"
Requires-Dist: httpx2>=2.10; extra == "all"

# provide-uterm

Core shared package for the [provide-uterm](../../README.md) platform. It
contains terminal I/O primitives, screen parsing, replay helpers, detection,
rendering, and small operator-facing utilities used by the split companion
packages.

## What's in this package

| Module | Purpose |
|--------|---------|
| `ansi.py`, `colors/`, `render/` | ANSI processing, color transforms, render helpers |
| `screen.py`, `detection/` | Screen cleanup, prompt parsing, semantic extraction |
| `telnet_session.py`, `line_editor.py` | Terminal session and local editing helpers |
| `replay/`, `session_logger.py` | Recording and replay utilities |
| Root package exports | Curated shared primitives such as `strip_ansi`, `normalize_colors`, `LineEditor`, and file loaders |

## Installation

```bash
pip install 'provide-uterm[all]'
```

See the [main README](../../README.md) for extras and quick start guides.

## Split Packages

| Package | Owns |
|---------|--------|
| `provide-uterm` | Shared terminal primitives and root facade exports, plus `provide.uterm.bridge` (HijackableMixin, contracts, schemas) |
| `provide-uterm-server` | `provide.uterm.server` (incl. `provide.uterm.server.bridge`), `provide.uterm.gateway`, `provide.uterm.tunnel` |
| `provide-uterm-platform` | `provide.uterm.manager`, `provide.uterm.pty` |
| `provide-uterm-client` | Client-side session control and MCP tooling |

## Related Packages

This package depends on several companion packages via workspace symlinks. See the [package ecosystem table](../../README.md#package-ecosystem) for the full list.

## License

AGPL-3.0-or-later. Copyright (c) 2025-2026 provide.io llc.
