py-troya-connect 0.1.31

A Python interface for Attachmate Extra Terminal sessions

py-troya-connect

Python interface for terminal emulation supporting Attachmate Extra, HIS 2000, and NetManage 3270.

Installation

pip install py-troya-connect

Quick Start

from py_troya_connect import ExtraTerminal, TerminalType

# Basic connection
terminal = ExtraTerminal("1")  # Connect to first session
terminal.connect()

# Send a command and read response
terminal.send_command("A10JANISTESB")
screen = terminal.read_screen()
print("\n".join(screen))

terminal.disconnect()

Examples

1. Multiple Terminal Types

# Detect and select terminal type
available_types = ExtraTerminal.detect_terminal_type()
terminal = ExtraTerminal("1", terminal_type=TerminalType.HIS)
terminal.connect()

2. Session Management

# List available sessions
sessions = terminal.list_available_sessions()
print(f"Available sessions: {sessions}")

# Select among terminals listed
terminal = ExtraTerminal("1")

# Check connection status
if terminal.is_connected():
    print("Terminal is connected")

3. Screen Operations

# Read screen with different options
raw_screen = terminal.read_screen(strip_whitespace=False)
formatted_screen = terminal.read_screen(strip_whitespace=True)

# Wait for specific text
if terminal.wait_for_text("READY", timeout=30):
    print("System is ready")

4. Command Handling

# Send commands with special keys
terminal.send_command("LOGON USERID{TAB}PASSWORD")
terminal.send_command("CLEAR", wait_for_text="Ready")

# Format commands automatically
terminal.send_command("PF3")  # Automatically adds <ENTER>

5. Error Handling

from py_troya_connect import ExtraTerminalError, ConnectionError

try:
    terminal = ExtraTerminal("1")
    terminal.connect()
    terminal.send_command("invalid_command")
except ConnectionError as e:
    print(f"Connection failed: {e}")
except ExtraTerminalError as e:
    print(f"Terminal error: {e}")

6. System Status

# Check system status
terminal = ExtraTerminal("1")
status = terminal.check_system_status()
print(f"Terminal version: {status['Extra Version']}")
print(f"Active sessions: {status['Session Count']}")

Advanced Features

• Multiple terminal type support (Extra, HIS, NetManage)
• Automatic terminal detection
• Robust error handling
• Screen content parsing
• Command formatting
• Session management
• System diagnostics

Requirements

• Windows OS
• One of the following:
  • Attachmate Extra! Terminal
  • Microsoft HIS 2000
  • NetManage 3270 Client
• Python 3.6+
• pywin32

License

MIT License