ntermqt 0.1.0__tar.gz

ntermqt-0.1.0/MANIFEST.in

@@ -0,0 +1,8 @@
+include LICENSE
+include README.md
+recursive-include nterm/terminal/resources *
+recursive-include nterm/theme/themes *.yaml
+prune nterm/examples
+prune screenshots
+global-exclude __pycache__
+global-exclude *.pyc

ntermqt-0.1.0/PKG-INFO

@@ -0,0 +1,327 @@
+Metadata-Version: 2.4
+Name: ntermqt
+Version: 0.1.0
+Summary: Modern SSH terminal widget for PyQt6 with credential vault and jump host support
+Author: Scott Peterman
+License: GPL-3.0
+Project-URL: Homepage, https://github.com/scottpeterman/nterm
+Project-URL: Repository, https://github.com/scottpeterman/nterm
+Project-URL: Issues, https://github.com/scottpeterman/nterm/issues
+Keywords: ssh,terminal,pyqt6,network,automation
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: X11 Applications :: Qt
+Classifier: Intended Audience :: System Administrators
+Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: System :: Networking
+Classifier: Topic :: Terminals :: Terminal Emulators/X Terminals
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: PyQt6>=6.4.0
+Requires-Dist: PyQt6-WebEngine>=6.4.0
+Requires-Dist: paramiko>=3.0.0
+Requires-Dist: cryptography>=41.0.0
+Requires-Dist: pyyaml>=6.0
+Provides-Extra: keyring
+Requires-Dist: keyring>=24.0.0; extra == "keyring"
+Provides-Extra: dev
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: black; extra == "dev"
+Requires-Dist: pyinstaller; extra == "dev"
+Requires-Dist: build; extra == "dev"
+Requires-Dist: twine; extra == "dev"
+
+# nterm
+
+**A modern SSH terminal for network engineers**
+
+PyQt6 terminal widget with encrypted credential vault, jump host chaining, YubiKey/FIDO2 support, and legacy device compatibility.
+
+Built for managing hundreds of devices through bastion hosts with hardware security keys.
+
+![nterm screenshot](https://raw.githubusercontent.com/scottpeterman/nterm/main/screenshots/gruvbox.png)
+
+---
+
+## Features
+
+**Terminal**
+- xterm.js rendering via QWebEngineView — full VT100/ANSI support
+- Built-in themes: Catppuccin, Dracula, Nord, Solarized, Gruvbox (dark/light/hybrid)
+- Custom YAML themes with independent terminal and UI colors
+- Tab or window per session — pop sessions to separate windows
+- Unicode, emoji, box-drawing characters
+
+**Authentication**
+- SSH Agent with YubiKey/FIDO2 hardware keys
+- Password, key file, keyboard-interactive, certificate auth
+- Multiple auth methods with automatic fallback
+- RSA SHA-1 fallback for legacy devices (OpenSSH < 7.2)
+- Legacy crypto support for old Juniper/Cisco gear
+
+**Connection Management**  
+- Jump host chaining (unlimited hops)
+- Auto-reconnection with exponential backoff
+- Connection profiles in YAML/JSON
+- Pattern-based credential resolution
+
+**Credential Vault**
+- AES-256 encryption with PBKDF2 (480,000 iterations)
+- Pattern matching — map credentials to hosts by wildcard or tag
+- Cross-platform keychain: macOS Keychain, Windows Credential Locker, Linux Secret Service
+- Full PyQt6 management UI
+
+---
+
+## Screenshots
+
+| Gruvbox Hybrid Theme | Credential Manager |
+|---------------------|-------------------|
+| ![gruvbox](https://raw.githubusercontent.com/scottpeterman/nterm/main/screenshots/gruvbox.png) | ![vault](https://raw.githubusercontent.com/scottpeterman/nterm/main/screenshots/vault.png) |
+
+| Connection Dialog                                                                            | Multi-vendor Support |
+|----------------------------------------------------------------------------------------------|---------------------|
+| ![connect](https://raw.githubusercontent.com/scottpeterman/nterm/main/screenshots/creds.png) | ![neofetch](https://raw.githubusercontent.com/scottpeterman/nterm/main/screenshots/neofetch.png) |
+
+---
+
+## Installation
+
+### From PyPI
+
+```bash
+pip install nterm
+
+# Optional: system keychain support
+pip install nterm[keyring]
+
+# Run
+nterm
+```
+
+### From Source
+
+```bash
+git clone https://github.com/scottpeterman/nterm.git
+cd nterm
+
+# Create virtual environment
+python -m venv .venv
+source .venv/bin/activate  # Linux/macOS
+# .venv\Scripts\activate   # Windows
+
+# Install in development mode
+pip install -e .
+
+# Optional: system keychain support
+pip install keyring
+
+# Run
+nterm
+# or
+python -m nterm
+```
+
+### Requirements
+
+- Python 3.10+
+- PyQt6 with WebEngine
+- paramiko
+- cryptography
+- pyyaml
+
+### Platform Support
+
+| Platform | PTY | Keychain |
+|----------|-----|----------|
+| Linux | ✅ Native | Secret Service |
+| macOS | ✅ Native | macOS Keychain |
+| Windows 10+ | ✅ pywinpty | Credential Locker |
+
+---
+
+## Quick Start
+
+### As a Widget
+
+```python
+from PyQt6.QtWidgets import QApplication, QMainWindow
+from nterm import ConnectionProfile, AuthConfig, SSHSession, TerminalWidget, Theme
+
+app = QApplication([])
+
+terminal = TerminalWidget()
+terminal.set_theme(Theme.gruvbox_hybrid())
+
+profile = ConnectionProfile(
+    name="router",
+    hostname="192.168.1.1",
+    auth_methods=[AuthConfig.password_auth("admin", "secret")],
+)
+
+session = SSHSession(profile)
+terminal.attach_session(session)
+session.connect()
+
+window = QMainWindow()
+window.setCentralWidget(terminal)
+window.resize(1000, 700)
+window.show()
+
+app.exec()
+```
+
+### With Credential Vault
+
+```python
+from nterm.vault import CredentialStore, CredentialResolver
+
+store = CredentialStore()
+store.unlock("master-password")
+
+# Add credential with pattern matching
+store.add_credential(
+    name="network-devices",
+    username="admin",
+    password="secret",
+    match_hosts=["*.network.corp", "192.168.1.*"],
+    match_tags=["cisco", "juniper"],
+)
+
+# Auto-resolve credentials by hostname
+resolver = CredentialResolver(store)
+profile = resolver.resolve_for_device("switch01.network.corp", tags=["cisco"])
+
+session = SSHSession(profile)
+session.connect()
+```
+
+---
+
+## Themes
+
+### Built-in
+
+```python
+Theme.default()         # Catppuccin Mocha
+Theme.dracula()         # Dracula
+Theme.nord()            # Nord
+Theme.solarized_dark()  # Solarized Dark
+Theme.gruvbox_dark()    # Gruvbox Dark
+Theme.gruvbox_light()   # Gruvbox Light
+Theme.gruvbox_hybrid()  # Dark UI + Light terminal
+```
+
+### Custom YAML
+
+```yaml
+# ~/.nterm/themes/my-theme.yaml
+name: my-theme
+
+terminal_colors:
+  background: "#1a1b26"
+  foreground: "#c0caf5"
+  cursor: "#c0caf5"
+  black: "#15161e"
+  red: "#f7768e"
+  green: "#9ece6a"
+  yellow: "#e0af68"
+  blue: "#7aa2f7"
+  magenta: "#bb9af7"
+  cyan: "#7dcfff"
+  white: "#a9b1d6"
+  # ... bright variants
+
+# UI chrome (can differ from terminal)
+background_color: "#1a1b26"
+foreground_color: "#c0caf5"
+border_color: "#33467c"
+accent_color: "#7aa2f7"
+```
+
+---
+
+## Jump Hosts
+
+```python
+profile = ConnectionProfile(
+    name="internal-db",
+    hostname="db01.internal.corp",
+    auth_methods=[AuthConfig.agent_auth("dbadmin")],
+    jump_hosts=[
+        JumpHostConfig(
+            hostname="bastion.corp.com",
+            auth=AuthConfig.agent_auth("youruser"),
+            requires_touch=True,
+            touch_prompt="Touch YubiKey for bastion...",
+        ),
+    ],
+)
+```
+
+---
+
+## Legacy Device Support
+
+nterm automatically handles old network equipment:
+
+- **RSA SHA-1 fallback** for OpenSSH < 7.2 servers
+- **Legacy KEX algorithms**: diffie-hellman-group14-sha1, group1-sha1
+- **Legacy ciphers**: aes128-cbc, 3des-cbc
+- **Auto-detection**: tries modern crypto first, falls back as needed
+
+Tested with:
+- Junos 14.x (2016)
+- Cisco IOS 12.2
+- Old Arista EOS
+- Any device running OpenSSH 6.x
+
+---
+
+## Architecture
+
+```
+nterm/
+├── connection/        # ConnectionProfile, AuthConfig, JumpHostConfig
+├── session/
+│   ├── ssh.py         # SSHSession (Paramiko) with legacy fallback
+│   ├── interactive_ssh.py   # Native SSH + PTY
+│   └── pty_transport.py     # Cross-platform PTY
+├── terminal/
+│   ├── widget.py      # TerminalWidget (PyQt6 + xterm.js)
+│   └── bridge.py      # Qt ↔ JavaScript bridge
+├── theme/
+│   ├── engine.py      # Theme system
+│   └── themes/        # YAML theme files
+├── vault/
+│   ├── store.py       # Encrypted credential storage
+│   ├── resolver.py    # Pattern-based resolution
+│   └── manager_ui.py  # PyQt6 credential manager
+└── manager/           # Session tree, connection dialogs
+```
+
+---
+
+## Related Projects
+
+- [TerminalTelemetry](https://github.com/scottpeterman/terminaltelemetry) — PyQt6 terminal with network monitoring
+- [Secure Cartography](https://github.com/scottpeterman/secure_cartography) — Network discovery and mapping
+
+---
+
+## License
+
+GPLv3
+
+---
+
+## Contributing
+
+Contributions welcome:
+- Additional themes
+- Windows testing  
+- Session recording/playback
+- Telnet/serial support

ntermqt-0.1.0/README.md

@@ -0,0 +1,291 @@
+# nterm
+
+**A modern SSH terminal for network engineers**
+
+PyQt6 terminal widget with encrypted credential vault, jump host chaining, YubiKey/FIDO2 support, and legacy device compatibility.
+
+Built for managing hundreds of devices through bastion hosts with hardware security keys.
+
+![nterm screenshot](https://raw.githubusercontent.com/scottpeterman/nterm/main/screenshots/gruvbox.png)
+
+---
+
+## Features
+
+**Terminal**
+- xterm.js rendering via QWebEngineView — full VT100/ANSI support
+- Built-in themes: Catppuccin, Dracula, Nord, Solarized, Gruvbox (dark/light/hybrid)
+- Custom YAML themes with independent terminal and UI colors
+- Tab or window per session — pop sessions to separate windows
+- Unicode, emoji, box-drawing characters
+
+**Authentication**
+- SSH Agent with YubiKey/FIDO2 hardware keys
+- Password, key file, keyboard-interactive, certificate auth
+- Multiple auth methods with automatic fallback
+- RSA SHA-1 fallback for legacy devices (OpenSSH < 7.2)
+- Legacy crypto support for old Juniper/Cisco gear
+
+**Connection Management**  
+- Jump host chaining (unlimited hops)
+- Auto-reconnection with exponential backoff
+- Connection profiles in YAML/JSON
+- Pattern-based credential resolution
+
+**Credential Vault**
+- AES-256 encryption with PBKDF2 (480,000 iterations)
+- Pattern matching — map credentials to hosts by wildcard or tag
+- Cross-platform keychain: macOS Keychain, Windows Credential Locker, Linux Secret Service
+- Full PyQt6 management UI
+
+---
+
+## Screenshots
+
+| Gruvbox Hybrid Theme | Credential Manager |
+|---------------------|-------------------|
+| ![gruvbox](https://raw.githubusercontent.com/scottpeterman/nterm/main/screenshots/gruvbox.png) | ![vault](https://raw.githubusercontent.com/scottpeterman/nterm/main/screenshots/vault.png) |
+
+| Connection Dialog                                                                            | Multi-vendor Support |
+|----------------------------------------------------------------------------------------------|---------------------|
+| ![connect](https://raw.githubusercontent.com/scottpeterman/nterm/main/screenshots/creds.png) | ![neofetch](https://raw.githubusercontent.com/scottpeterman/nterm/main/screenshots/neofetch.png) |
+
+---
+
+## Installation
+
+### From PyPI
+
+```bash
+pip install nterm
+
+# Optional: system keychain support
+pip install nterm[keyring]
+
+# Run
+nterm
+```
+
+### From Source
+
+```bash
+git clone https://github.com/scottpeterman/nterm.git
+cd nterm
+
+# Create virtual environment
+python -m venv .venv
+source .venv/bin/activate  # Linux/macOS
+# .venv\Scripts\activate   # Windows
+
+# Install in development mode
+pip install -e .
+
+# Optional: system keychain support
+pip install keyring
+
+# Run
+nterm
+# or
+python -m nterm
+```
+
+### Requirements
+
+- Python 3.10+
+- PyQt6 with WebEngine
+- paramiko
+- cryptography
+- pyyaml
+
+### Platform Support
+
+| Platform | PTY | Keychain |
+|----------|-----|----------|
+| Linux | ✅ Native | Secret Service |
+| macOS | ✅ Native | macOS Keychain |
+| Windows 10+ | ✅ pywinpty | Credential Locker |
+
+---
+
+## Quick Start
+
+### As a Widget
+
+```python
+from PyQt6.QtWidgets import QApplication, QMainWindow
+from nterm import ConnectionProfile, AuthConfig, SSHSession, TerminalWidget, Theme
+
+app = QApplication([])
+
+terminal = TerminalWidget()
+terminal.set_theme(Theme.gruvbox_hybrid())
+
+profile = ConnectionProfile(
+    name="router",
+    hostname="192.168.1.1",
+    auth_methods=[AuthConfig.password_auth("admin", "secret")],
+)
+
+session = SSHSession(profile)
+terminal.attach_session(session)
+session.connect()
+
+window = QMainWindow()
+window.setCentralWidget(terminal)
+window.resize(1000, 700)
+window.show()
+
+app.exec()
+```
+
+### With Credential Vault
+
+```python
+from nterm.vault import CredentialStore, CredentialResolver
+
+store = CredentialStore()
+store.unlock("master-password")
+
+# Add credential with pattern matching
+store.add_credential(
+    name="network-devices",
+    username="admin",
+    password="secret",
+    match_hosts=["*.network.corp", "192.168.1.*"],
+    match_tags=["cisco", "juniper"],
+)
+
+# Auto-resolve credentials by hostname
+resolver = CredentialResolver(store)
+profile = resolver.resolve_for_device("switch01.network.corp", tags=["cisco"])
+
+session = SSHSession(profile)
+session.connect()
+```
+
+---
+
+## Themes
+
+### Built-in
+
+```python
+Theme.default()         # Catppuccin Mocha
+Theme.dracula()         # Dracula
+Theme.nord()            # Nord
+Theme.solarized_dark()  # Solarized Dark
+Theme.gruvbox_dark()    # Gruvbox Dark
+Theme.gruvbox_light()   # Gruvbox Light
+Theme.gruvbox_hybrid()  # Dark UI + Light terminal
+```
+
+### Custom YAML
+
+```yaml
+# ~/.nterm/themes/my-theme.yaml
+name: my-theme
+
+terminal_colors:
+  background: "#1a1b26"
+  foreground: "#c0caf5"
+  cursor: "#c0caf5"
+  black: "#15161e"
+  red: "#f7768e"
+  green: "#9ece6a"
+  yellow: "#e0af68"
+  blue: "#7aa2f7"
+  magenta: "#bb9af7"
+  cyan: "#7dcfff"
+  white: "#a9b1d6"
+  # ... bright variants
+
+# UI chrome (can differ from terminal)
+background_color: "#1a1b26"
+foreground_color: "#c0caf5"
+border_color: "#33467c"
+accent_color: "#7aa2f7"
+```
+
+---
+
+## Jump Hosts
+
+```python
+profile = ConnectionProfile(
+    name="internal-db",
+    hostname="db01.internal.corp",
+    auth_methods=[AuthConfig.agent_auth("dbadmin")],
+    jump_hosts=[
+        JumpHostConfig(
+            hostname="bastion.corp.com",
+            auth=AuthConfig.agent_auth("youruser"),
+            requires_touch=True,
+            touch_prompt="Touch YubiKey for bastion...",
+        ),
+    ],
+)
+```
+
+---
+
+## Legacy Device Support
+
+nterm automatically handles old network equipment:
+
+- **RSA SHA-1 fallback** for OpenSSH < 7.2 servers
+- **Legacy KEX algorithms**: diffie-hellman-group14-sha1, group1-sha1
+- **Legacy ciphers**: aes128-cbc, 3des-cbc
+- **Auto-detection**: tries modern crypto first, falls back as needed
+
+Tested with:
+- Junos 14.x (2016)
+- Cisco IOS 12.2
+- Old Arista EOS
+- Any device running OpenSSH 6.x
+
+---
+
+## Architecture
+
+```
+nterm/
+├── connection/        # ConnectionProfile, AuthConfig, JumpHostConfig
+├── session/
+│   ├── ssh.py         # SSHSession (Paramiko) with legacy fallback
+│   ├── interactive_ssh.py   # Native SSH + PTY
+│   └── pty_transport.py     # Cross-platform PTY
+├── terminal/
+│   ├── widget.py      # TerminalWidget (PyQt6 + xterm.js)
+│   └── bridge.py      # Qt ↔ JavaScript bridge
+├── theme/
+│   ├── engine.py      # Theme system
+│   └── themes/        # YAML theme files
+├── vault/
+│   ├── store.py       # Encrypted credential storage
+│   ├── resolver.py    # Pattern-based resolution
+│   └── manager_ui.py  # PyQt6 credential manager
+└── manager/           # Session tree, connection dialogs
+```
+
+---
+
+## Related Projects
+
+- [TerminalTelemetry](https://github.com/scottpeterman/terminaltelemetry) — PyQt6 terminal with network monitoring
+- [Secure Cartography](https://github.com/scottpeterman/secure_cartography) — Network discovery and mapping
+
+---
+
+## License
+
+GPLv3
+
+---
+
+## Contributing
+
+Contributions welcome:
+- Additional themes
+- Windows testing  
+- Session recording/playback
+- Telnet/serial support

ntermqt-0.1.0/nterm/__init__.py

@@ -0,0 +1,54 @@
+"""
+nterm - A themeable SSH terminal widget for PyQt6.
+
+Clean architecture with:
+- Connection profiles (fully serializable)
+- Session management with auto-reconnect
+- Jump host / bastion support
+- YubiKey/FIDO2 agent auth (native SSH + PTY)
+- xterm.js rendering
+- Themeable UI
+
+Session types:
+- SSHSession: Paramiko-based, programmatic auth
+- InteractiveSSHSession: Native ssh with PTY for full interactive auth
+- HybridSSHSession: Interactive auth with ControlMaster reuse (Unix only)
+"""
+
+__version__ = "0.2.0"
+__author__ = "Scott Peterman"
+
+from .connection.profile import (
+    ConnectionProfile,
+    AuthConfig,
+    AuthMethod,
+    JumpHostConfig,
+)
+from .session.base import Session, SessionState
+from .session.ssh import SSHSession
+from .session.interactive_ssh import InteractiveSSHSession, HybridSSHSession
+from .session.pty_transport import is_pty_available, IS_WINDOWS
+from .terminal.widget import TerminalWidget
+from .theme.engine import Theme, ThemeEngine
+
+__all__ = [
+    # Connection
+    "ConnectionProfile",
+    "AuthConfig", 
+    "AuthMethod",
+    "JumpHostConfig",
+    # Sessions
+    "Session",
+    "SessionState",
+    "SSHSession",
+    "InteractiveSSHSession",
+    "HybridSSHSession",
+    # Utilities
+    "is_pty_available",
+    "IS_WINDOWS",
+    # Terminal
+    "TerminalWidget",
+    # Themes
+    "Theme",
+    "ThemeEngine",
+]