cmux/tests/test_ctrl_socket.py
Lawrence Chen cd0f6200c0 Fix Ctrl+C/D handling and add Unix socket control API for testing
Key changes:
- Fix keyboard input handling for control characters in GhosttyTerminalView
  - Set consumed_mods correctly (exclude Ctrl/Cmd from consumed mods)
  - Send unmodified character text for Ctrl+key combinations
  - Add unshifted_codepoint support for proper key encoding

- Add TerminalController with Unix socket API (/tmp/ghosttytabs.sock)
  - Commands: send, send_key, list_tabs, new_tab, close_tab, select_tab
  - Supports ctrl-c, ctrl-d, ctrl-z, enter, tab, escape, etc.

- Add Python test client and automated test suite
  - tests/ghosttytabs.py - Python client library
  - tests/test_ctrl_socket.py - Main Ctrl+C/D test suite (4 tests)
  - tests/test_signals_auto.py - Standalone PTY signal tests

- Update CLAUDE.md with socket API documentation and testing guide
- Update .gitignore for Python cache files

This fixes Ctrl+C/D not working in apps like claude-code, btop, opencode
while continuing to work in simpler apps like htop.
2026-01-22 02:20:51 -08:00

248 lines
6.4 KiB
Python
Executable file

#!/usr/bin/env python3
"""
Automated tests for Ctrl+C and Ctrl+D using the GhosttyTabs socket interface.
Usage:
python3 test_ctrl_socket.py
Requirements:
- GhosttyTabs must be running with the socket controller enabled
"""
import os
import sys
import time
import tempfile
from pathlib import Path
# Add the directory containing ghosttytabs.py to the path
sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
from ghosttytabs import GhosttyTabs, GhosttyTabsError
class TestResult:
def __init__(self, name: str):
self.name = name
self.passed = False
self.message = ""
def success(self, msg: str = ""):
self.passed = True
self.message = msg
def failure(self, msg: str):
self.passed = False
self.message = msg
def test_connection(client: GhosttyTabs) -> TestResult:
"""Test that we can connect and ping the server"""
result = TestResult("Connection")
try:
if client.ping():
result.success("Connected and received PONG")
else:
result.failure("Ping failed")
except Exception as e:
result.failure(str(e))
return result
def test_ctrl_c(client: GhosttyTabs) -> TestResult:
"""
Test Ctrl+C by:
1. Starting sleep command
2. Sending Ctrl+C
3. Verifying shell responds to next command
"""
result = TestResult("Ctrl+C (SIGINT)")
marker = Path(tempfile.gettempdir()) / f"ghostty_ctrlc_{os.getpid()}"
try:
marker.unlink(missing_ok=True)
# Start a long sleep
client.send("sleep 30\n")
time.sleep(0.3)
# Send Ctrl+C to interrupt
client.send_ctrl_c()
time.sleep(0.3)
# If Ctrl+C worked, shell should accept new command
client.send(f"touch {marker}\n")
time.sleep(0.5)
if marker.exists():
result.success("Ctrl+C interrupted sleep, shell responsive")
marker.unlink(missing_ok=True)
else:
result.failure("Shell not responsive after Ctrl+C")
except Exception as e:
result.failure(f"Exception: {e}")
marker.unlink(missing_ok=True)
return result
def test_ctrl_d(client: GhosttyTabs) -> TestResult:
"""
Test Ctrl+D by:
1. Running cat command
2. Sending Ctrl+D
3. Verifying cat exits and next command runs
"""
result = TestResult("Ctrl+D (EOF)")
marker = Path(tempfile.gettempdir()) / f"ghostty_ctrld_{os.getpid()}"
try:
marker.unlink(missing_ok=True)
# Run cat (waits for input)
client.send("cat\n")
time.sleep(0.3)
# Send Ctrl+D (EOF)
client.send_ctrl_d()
time.sleep(0.3)
# If Ctrl+D worked, cat should exit and we can run another command
client.send(f"touch {marker}\n")
time.sleep(0.5)
if marker.exists():
result.success("Ctrl+D sent EOF, cat exited")
marker.unlink(missing_ok=True)
else:
result.failure("cat did not exit after Ctrl+D")
except Exception as e:
result.failure(f"Exception: {e}")
marker.unlink(missing_ok=True)
return result
def test_ctrl_c_python(client: GhosttyTabs) -> TestResult:
"""
Test Ctrl+C with Python process
"""
result = TestResult("Ctrl+C in Python")
marker = Path(tempfile.gettempdir()) / f"ghostty_pyctrlc_{os.getpid()}"
try:
marker.unlink(missing_ok=True)
# Start Python that loops forever
client.send("python3 -c 'import time; [time.sleep(1) for _ in iter(int, 1)]'\n")
time.sleep(1.0) # Give Python time to start
# Send Ctrl+C
client.send_ctrl_c()
time.sleep(0.5)
# If Ctrl+C worked, shell should accept new command
client.send(f"touch {marker}\n")
time.sleep(0.5)
if marker.exists():
result.success("Ctrl+C interrupted Python process")
marker.unlink(missing_ok=True)
else:
result.failure("Python not interrupted by Ctrl+C")
except Exception as e:
result.failure(f"Exception: {type(e).__name__}: {e}")
marker.unlink(missing_ok=True)
return result
def run_tests():
"""Run all tests"""
print("=" * 60)
print("GhosttyTabs Ctrl+C/D Automated Tests")
print("=" * 60)
print()
socket_path = GhosttyTabs.DEFAULT_SOCKET_PATH
if not os.path.exists(socket_path):
print(f"Error: Socket not found at {socket_path}")
print("Please make sure GhosttyTabs is running.")
return 1
results = []
try:
with GhosttyTabs() as client:
# Test connection
print("Testing connection...")
results.append(test_connection(client))
status = "" if results[-1].passed else ""
print(f" {status} {results[-1].message}")
print()
if not results[-1].passed:
return 1
# Test Ctrl+C
print("Testing Ctrl+C (SIGINT)...")
results.append(test_ctrl_c(client))
status = "" if results[-1].passed else ""
print(f" {status} {results[-1].message}")
print()
time.sleep(0.5)
# Test Ctrl+D
print("Testing Ctrl+D (EOF)...")
results.append(test_ctrl_d(client))
status = "" if results[-1].passed else ""
print(f" {status} {results[-1].message}")
print()
time.sleep(0.5)
# Test Ctrl+C in Python
print("Testing Ctrl+C in Python process...")
results.append(test_ctrl_c_python(client))
status = "" if results[-1].passed else ""
print(f" {status} {results[-1].message}")
print()
except GhosttyTabsError as e:
print(f"Error: {e}")
return 1
# Summary
print("=" * 60)
print("Test Results Summary")
print("=" * 60)
passed = sum(1 for r in results if r.passed)
total = len(results)
for r in results:
status = "✅ PASS" if r.passed else "❌ FAIL"
print(f" {r.name}: {status}")
if not r.passed and r.message:
print(f" {r.message}")
print()
print(f"Passed: {passed}/{total}")
if passed == total:
print("\n🎉 All tests passed!")
return 0
else:
print(f"\n⚠️ {total - passed} test(s) failed")
return 1
if __name__ == "__main__":
sys.exit(run_tests())