Metadata-Version: 2.2
Name: py-troya-connect
Version: 0.1.27
Summary: A Python interface for Attachmate Extra Terminal sessions
Home-page: https://github.com/tolgakurtuluss/py-troya-connect
Author: Tolga Kurtulus
Author-email: tolgakurtulus95@gmail.com
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: Microsoft :: Windows
Requires-Python: >=3.6
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: pywin32>=223
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

# py-troya-connect

A Python interface for Attachmate Extra Terminal sessions.

## Installation

```bash
pip install py-troya-connect
```

## Quick Start

```python
from py_troya_connect import ExtraTerminal

# Connect to first available session
terminal = ExtraTerminal("1")

# Send command and read response
terminal.send_command("your_command")
screen_text = terminal.read_screen()
```

## Interactive Session Selection

```python
# Let user choose session
session_choice = ExtraTerminal.select_session()
terminal = ExtraTerminal(session_choice)

# Read current screen
screen_text = terminal.read_screen()
```

## Error Handling

```python
from py_troya_connect import ExtraTerminal, TerminalBusyError

try:
    terminal = ExtraTerminal("1")
    terminal.send_command("command")
    
    # Wait for specific text with timeout
    if terminal.wait_for_text("Expected text", timeout=10):
        print("Text found!")
except TerminalBusyError:
    print("Terminal is busy")
```

## System Status Check

```python
terminal = ExtraTerminal("1")
status = terminal.check_system_status()
# Returns: {'Extra Version': '1.0', 'Session Count': 2, 'Available Sessions': ['Session1', 'Session2']}
```

## Requirements

- Windows OS
- Attachmate Extra! Terminal
- Python 3.6+
- pywin32

## License

MIT License
