Metadata-Version: 2.4
Name: htty
Version: 0.2.25
Summary: Headless Terminal - Python library for terminal automation
Project-URL: Homepage, https://github.com/MatrixManAtYrService/ht
Project-URL: Documentation, https://github.com/MatrixManAtYrService/ht
Project-URL: Repository, https://github.com/MatrixManAtYrService/ht
Project-URL: Issues, https://github.com/MatrixManAtYrService/ht/issues
Author-email: Matt Rixman <MatrixManAtYrService@users.noreply.github.com>
License: MIT
License-File: LICENSE
Keywords: automation,headless,pty,python,subprocess,terminal
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
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
Classifier: Topic :: Software Development :: Testing
Classifier: Topic :: System :: Shells
Classifier: Topic :: Terminals
Requires-Python: >=3.8
Requires-Dist: ansi2html
Requires-Dist: htty-core==0.2.25
Description-Content-Type: text/markdown

# htty - Headless Terminal

A Python library for terminal automation using a headless terminal interface.

## Installation

```bash
pip install htty
```

This will automatically install `htty-core` as a dependency, which provides the underlying Rust binary.

## Quick Start

```python
import htty

# Run a command and capture output
with htty.terminal_session("echo 'Hello World'") as proc:
    snapshot = proc.snapshot()
    print(snapshot.text)
```

## Command Line Tools

After installation, you get the `htty` command for terminal automation tasks.

## Documentation

[Full documentation and examples coming soon]

## Architecture

This package depends on [`htty-core`](../htty-core/README.md), which contains the Rust binary with minimal Python bindings. This two-package approach works around maturin limitations while providing a clean user experience.

## See also

- **[htty-core](../htty-core/README.md)** - The underlying Rust binary package
- **[Project README](../README.md)** - Overview of the entire project