PyPI - ptn - Versions diffs - 0.1.4__py3-none-any.whl - Mend

ptn 0.1.4__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (73) hide show

porterminal/__init__.py +288 -0
porterminal/__main__.py +8 -0
porterminal/app.py +381 -0
porterminal/application/__init__.py +1 -0
porterminal/application/ports/__init__.py +7 -0
porterminal/application/ports/connection_port.py +34 -0
porterminal/application/services/__init__.py +13 -0
porterminal/application/services/management_service.py +279 -0
porterminal/application/services/session_service.py +249 -0
porterminal/application/services/tab_service.py +286 -0
porterminal/application/services/terminal_service.py +426 -0
porterminal/asgi.py +38 -0
porterminal/cli/__init__.py +19 -0
porterminal/cli/args.py +91 -0
porterminal/cli/display.py +157 -0
porterminal/composition.py +208 -0
porterminal/config.py +195 -0
porterminal/container.py +65 -0
porterminal/domain/__init__.py +91 -0
porterminal/domain/entities/__init__.py +16 -0
porterminal/domain/entities/output_buffer.py +73 -0
porterminal/domain/entities/session.py +86 -0
porterminal/domain/entities/tab.py +71 -0
porterminal/domain/ports/__init__.py +12 -0
porterminal/domain/ports/pty_port.py +80 -0
porterminal/domain/ports/session_repository.py +58 -0
porterminal/domain/ports/tab_repository.py +75 -0
porterminal/domain/services/__init__.py +18 -0
porterminal/domain/services/environment_sanitizer.py +61 -0
porterminal/domain/services/rate_limiter.py +63 -0
porterminal/domain/services/session_limits.py +104 -0
porterminal/domain/services/tab_limits.py +54 -0
porterminal/domain/values/__init__.py +25 -0
porterminal/domain/values/environment_rules.py +156 -0
porterminal/domain/values/rate_limit_config.py +21 -0
porterminal/domain/values/session_id.py +20 -0
porterminal/domain/values/shell_command.py +37 -0
porterminal/domain/values/tab_id.py +24 -0
porterminal/domain/values/terminal_dimensions.py +45 -0
porterminal/domain/values/user_id.py +25 -0
porterminal/infrastructure/__init__.py +20 -0
porterminal/infrastructure/cloudflared.py +295 -0
porterminal/infrastructure/config/__init__.py +9 -0
porterminal/infrastructure/config/shell_detector.py +84 -0
porterminal/infrastructure/config/yaml_loader.py +34 -0
porterminal/infrastructure/network.py +43 -0
porterminal/infrastructure/registry/__init__.py +5 -0
porterminal/infrastructure/registry/user_connection_registry.py +104 -0
porterminal/infrastructure/repositories/__init__.py +9 -0
porterminal/infrastructure/repositories/in_memory_session.py +70 -0
porterminal/infrastructure/repositories/in_memory_tab.py +124 -0
porterminal/infrastructure/server.py +161 -0
porterminal/infrastructure/web/__init__.py +7 -0
porterminal/infrastructure/web/websocket_adapter.py +78 -0
porterminal/logging_setup.py +48 -0
porterminal/pty/__init__.py +46 -0
porterminal/pty/env.py +97 -0
porterminal/pty/manager.py +163 -0
porterminal/pty/protocol.py +84 -0
porterminal/pty/unix.py +162 -0
porterminal/pty/windows.py +131 -0
porterminal/static/assets/app-BQiuUo6Q.css +32 -0
porterminal/static/assets/app-YNN_jEhv.js +71 -0
porterminal/static/icon.svg +34 -0
porterminal/static/index.html +139 -0
porterminal/static/manifest.json +31 -0
porterminal/static/sw.js +66 -0
porterminal/updater.py +257 -0
ptn-0.1.4.dist-info/METADATA +191 -0
ptn-0.1.4.dist-info/RECORD +73 -0
ptn-0.1.4.dist-info/WHEEL +4 -0
ptn-0.1.4.dist-info/entry_points.txt +2 -0
ptn-0.1.4.dist-info/licenses/LICENSE +661 -0

porterminal/static/icon.svg ADDED Viewed

@@ -0,0 +1,34 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16" shape-rendering="crispEdges">
+  <rect width="16" height="16" fill="#1e1e1e"/>
+  <rect x="1" y="2" width="1" height="1" fill="#FFFFFF"/>
+  <rect x="2" y="2" width="1" height="1" fill="#FFFFFF"/>
+  <rect x="3" y="2" width="1" height="1" fill="#FFFFFF"/>
+  <rect x="2" y="3" width="1" height="1" fill="#FFFFFF"/>
+  <rect x="3" y="3" width="1" height="1" fill="#FFFFFF"/>
+  <rect x="4" y="3" width="1" height="1" fill="#FFFFFF"/>
+  <rect x="3" y="4" width="1" height="1" fill="#FFFFFF"/>
+  <rect x="4" y="4" width="1" height="1" fill="#FFFFFF"/>
+  <rect x="5" y="4" width="1" height="1" fill="#FFFFFF"/>
+  <rect x="4" y="5" width="1" height="1" fill="#FFFFFF"/>
+  <rect x="5" y="5" width="1" height="1" fill="#FFFFFF"/>
+  <rect x="6" y="5" width="1" height="1" fill="#FFFFFF"/>
+  <rect x="3" y="6" width="1" height="1" fill="#FFFFFF"/>
+  <rect x="4" y="6" width="1" height="1" fill="#FFFFFF"/>
+  <rect x="5" y="6" width="1" height="1" fill="#FFFFFF"/>
+  <rect x="2" y="7" width="1" height="1" fill="#FFFFFF"/>
+  <rect x="3" y="7" width="1" height="1" fill="#FFFFFF"/>
+  <rect x="4" y="7" width="1" height="1" fill="#FFFFFF"/>
+  <rect x="1" y="8" width="1" height="1" fill="#FFFFFF"/>
+  <rect x="2" y="8" width="1" height="1" fill="#FFFFFF"/>
+  <rect x="3" y="8" width="1" height="1" fill="#FFFFFF"/>
+  <rect x="8" y="8" width="1" height="1" fill="#FFFFFF"/>
+  <rect x="9" y="8" width="1" height="1" fill="#FFFFFF"/>
+  <rect x="10" y="8" width="1" height="1" fill="#FFFFFF"/>
+  <rect x="11" y="8" width="1" height="1" fill="#FFFFFF"/>
+  <rect x="12" y="8" width="1" height="1" fill="#FFFFFF"/>
+  <rect x="8" y="9" width="1" height="1" fill="#FFFFFF"/>
+  <rect x="9" y="9" width="1" height="1" fill="#FFFFFF"/>
+  <rect x="10" y="9" width="1" height="1" fill="#FFFFFF"/>
+  <rect x="11" y="9" width="1" height="1" fill="#FFFFFF"/>
+  <rect x="12" y="9" width="1" height="1" fill="#FFFFFF"/>
+</svg>

porterminal/static/index.html ADDED Viewed

@@ -0,0 +1,139 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=no, viewport-fit=cover">
+    <meta name="apple-mobile-web-app-capable" content="yes">
+    <meta name="apple-mobile-web-app-status-bar-style" content="black-translucent">
+    <meta name="apple-mobile-web-app-title" content="Terminal">
+    <meta name="theme-color" content="#1e1e1e">
+    <meta name="mobile-web-app-capable" content="yes">
+    <meta name="application-name" content="Terminal">
+    <meta name="msapplication-TileColor" content="#1e1e1e">
+    <meta name="msapplication-tap-highlight" content="no">
+    <meta name="format-detection" content="telephone=no">
+    <title>Terminal</title>
+    <!-- PWA -->
+    <link rel="manifest" href="/static/manifest.json">
+    <link rel="icon" type="image/svg+xml" href="/static/icon.svg">
+    <link rel="apple-touch-icon" href="/static/icon-192.png">
+  <script type="module" crossorigin src="/static/assets/app-YNN_jEhv.js"></script>
+  <link rel="stylesheet" crossorigin href="/static/assets/app-BQiuUo6Q.css">
+</head>
+<body>
+    <div id="app">
+        <!-- Tab Bar with Shell Selector -->
+        <div id="tab-bar">
+            <span id="connection-dot"></span>
+            <!-- Tabs rendered by JS -->
+            <div id="shell-selector">
+                <select id="shell-select"><option>...</option></select>
+                <button id="btn-info" title="Help">ⓘ</button>
+                <button id="btn-textview" title="Plain Text View">≡</button>
+                <button id="btn-shutdown" title="Shutdown">⏻</button>
+            </div>
+        </div>
+        <!-- Terminal Area -->
+        <div id="terminal-container">
+            <div id="terminal"></div>
+        </div>
+        <!-- Bottom Toolbar - Two rows -->
+        <div id="toolbar">
+            <div class="toolbar-row">
+                <button class="tool-btn" id="btn-escape">Esc</button>
+                <button class="tool-btn arrow" data-key="ArrowLeft">←</button>
+                <button class="tool-btn arrow" data-key="ArrowDown">↓</button>
+                <button class="tool-btn arrow" data-key="ArrowUp">↑</button>
+                <button class="tool-btn arrow" data-key="ArrowRight">→</button>
+                <button class="tool-btn icon" data-key="Tab">⇥</button>
+                <button class="tool-btn" data-key="Home">Home</button>
+                <button class="tool-btn" data-key="End">End</button>
+                <button class="tool-btn icon" id="btn-backspace">⌫</button>
+                <button class="tool-btn" data-key="Delete">Del</button>
+                <button class="tool-btn icon enter" data-key="Enter">↵</button>
+            </div>
+            <div class="toolbar-row">
+                <button class="tool-btn modifier" id="btn-ctrl">Ctl</button>
+                <button class="tool-btn modifier" id="btn-alt">Alt</button>
+                <button class="tool-btn modifier" id="btn-shift">Sft</button>
+                <button class="tool-btn" data-key="ShiftTab">Sft⇥</button>
+                <button class="tool-btn danger" data-key="Ctrl+C">^C</button>
+                <button class="tool-btn icon" id="btn-paste">⎘</button>
+                <button class="tool-btn" data-key="1">1</button>
+                <button class="tool-btn" data-key="2">2</button>
+                <button class="tool-btn" data-key="3">3</button>
+                <button class="tool-btn" data-key="@">@</button>
+                <button class="tool-btn" data-key="/">/</button>
+                <button class="tool-btn" data-key="\Enter">\↵</button>
+            </div>
+        </div>
+    </div>
+    <!-- Floating Copy Button (iOS) -->
+    <button id="copy-button">Copy</button>
+    <!-- Connection Lost Overlay -->
+    <div id="disconnect-overlay" class="hidden">
+        <div id="disconnect-content">
+            <div id="disconnect-icon">○</div>
+            <div id="disconnect-text">Connection Lost</div>
+            <button id="disconnect-retry">Retry</button>
+        </div>
+    </div>
+    <!-- Help Popup -->
+    <div id="help-overlay" class="hidden">
+        <div id="help-content">
+            <div id="help-header">
+                <span>Touch Controls</span>
+                <button id="help-close">×</button>
+            </div>
+            <div id="help-body">
+                <div class="help-section">
+                    <div class="help-title">Swipe</div>
+                    <div class="help-item"><span class="help-key">←</span> ↑ Last command</div>
+                    <div class="help-item"><span class="help-key">→</span> ↓ Next command</div>
+                </div>
+                <div class="help-section">
+                    <div class="help-title">Selection</div>
+                    <div class="help-item"><span class="help-key">Long press</span> Start selection</div>
+                    <div class="help-item"><span class="help-key">Drag</span> Extend selection</div>
+                    <div class="help-item"><span class="help-key">Double tap</span> Select word</div>
+                    <div class="help-item"><span class="help-key">Tap</span> Clear selection</div>
+                </div>
+                <div class="help-section">
+                    <div class="help-title">Zoom</div>
+                    <div class="help-item"><span class="help-key">Pinch</span> Change font size</div>
+                </div>
+                <div class="help-section">
+                    <div class="help-title">Modifiers (Ctl, Alt, Sft)</div>
+                    <div class="help-item"><span class="help-key">Tap</span> Sticky (one use)</div>
+                    <div class="help-item"><span class="help-key">Double tap</span> Lock on/off</div>
+                </div>
+                <div class="help-section">
+                    <div class="help-title">Tabs</div>
+                    <div class="help-item"><span class="help-key">Hold ×</span> Close tab</div>
+                </div>
+            </div>
+        </div>
+    </div>
+    <!-- Plain Text View Popup -->
+    <div id="textview-overlay" class="hidden">
+        <div id="textview-content">
+            <div id="textview-header">
+                <span id="textview-title">Text</span>
+                <button class="textview-zoom-btn" id="textview-zoom-out">−</button>
+                <button class="textview-zoom-btn" id="textview-zoom-in">+</button>
+                <button id="textview-close">×</button>
+            </div>
+            <pre id="textview-body"></pre>
+        </div>
+    </div>
+</body>
+</html>

porterminal/static/manifest.json ADDED Viewed

@@ -0,0 +1,31 @@
+{
+  "name": "Porterminal",
+  "short_name": "Terminal",
+  "description": "Mobile terminal via Cloudflare Tunnel",
+  "start_url": "/",
+  "display": "standalone",
+  "orientation": "any",
+  "background_color": "#1e1e1e",
+  "theme_color": "#252526",
+  "icons": [
+    {
+      "src": "/static/icon.svg",
+      "sizes": "any",
+      "type": "image/svg+xml",
+      "purpose": "any maskable"
+    }
+  ],
+  "categories": ["developer", "utilities"],
+  "shortcuts": [
+    {
+      "name": "PowerShell",
+      "url": "/?shell=powershell",
+      "description": "Open PowerShell terminal"
+    },
+    {
+      "name": "CMD",
+      "url": "/?shell=cmd",
+      "description": "Open Command Prompt"
+    }
+  ]
+}

porterminal/static/sw.js ADDED Viewed

@@ -0,0 +1,66 @@
+/**
+ * Service Worker for Porterminal PWA
+ * Caches UI assets for offline access
+ */
+const CACHE_NAME = 'porterminal-v1';
+const STATIC_ASSETS = [
+    '/',
+    '/static/index.html',
+    '/static/manifest.json',
+    '/static/icon.svg',
+];
+// Install - cache static assets
+self.addEventListener('install', (event) => {
+    event.waitUntil(
+        caches.open(CACHE_NAME).then((cache) => {
+            return cache.addAll(STATIC_ASSETS);
+        })
+    );
+    self.skipWaiting();
+});
+// Activate - clean old caches
+self.addEventListener('activate', (event) => {
+    event.waitUntil(
+        caches.keys().then((keys) => {
+            return Promise.all(
+                keys.filter((key) => key !== CACHE_NAME)
+                    .map((key) => caches.delete(key))
+            );
+        })
+    );
+    self.clients.claim();
+});
+// Fetch - serve from cache, fallback to network
+self.addEventListener('fetch', (event) => {
+    const url = new URL(event.request.url);
+    // Don't cache WebSocket or API requests
+    if (url.pathname.startsWith('/ws') || url.pathname.startsWith('/api')) {
+        return;
+    }
+    event.respondWith(
+        caches.match(event.request).then((cached) => {
+            // Return cached version or fetch from network
+            return cached || fetch(event.request).then((response) => {
+                // Cache successful responses
+                if (response.ok && event.request.method === 'GET') {
+                    const clone = response.clone();
+                    caches.open(CACHE_NAME).then((cache) => {
+                        cache.put(event.request, clone);
+                    });
+                }
+                return response;
+            });
+        }).catch(() => {
+            // Offline fallback
+            if (event.request.destination === 'document') {
+                return caches.match('/');
+            }
+        })
+    );
+});

porterminal/updater.py ADDED Viewed

@@ -0,0 +1,257 @@
+"""Update functionality for Porterminal."""
+import json
+import shutil
+import subprocess
+import sys
+import time
+from pathlib import Path
+from urllib.error import URLError
+from urllib.request import Request, urlopen
+from porterminal import __version__
+PACKAGE_NAME = "porterminal"
+PYPI_URL = f"https://pypi.org/pypi/{PACKAGE_NAME}/json"
+CACHE_DIR = Path.home() / ".cache" / PACKAGE_NAME
+CACHE_FILE = CACHE_DIR / "update_check.json"
+CACHE_TTL = 86400  # 24 hours
+def parse_version(version: str) -> tuple[int, ...]:
+    """Parse version string into comparable tuple.
+    Handles PEP 440 versions like "0.1.0", "1.0.0a1", "2.0.0.post1".
+    Args:
+        version: Version string.
+    Returns:
+        Tuple of integers for comparison (ignores pre/post/dev).
+    """
+    version = version.lstrip("v")
+    # Extract just the release numbers (before any pre/post/dev markers)
+    base = version.split("a")[0].split("b")[0].split("rc")[0]
+    base = base.split(".dev")[0].split(".post")[0].split("+")[0]
+    parts = []
+    for p in base.split("."):
+        try:
+            parts.append(int(p))
+        except ValueError:
+            break
+    return tuple(parts) if parts else (0,)
+def get_latest_version() -> str | None:
+    """Fetch the latest version from PyPI.
+    Returns:
+        Latest version string or None if fetch failed.
+    """
+    try:
+        request = Request(PYPI_URL, headers={"User-Agent": f"{PACKAGE_NAME}/{__version__}"})
+        with urlopen(request, timeout=5) as response:
+            data = json.loads(response.read().decode())
+            return data["info"]["version"]
+    except (URLError, json.JSONDecodeError, KeyError, TimeoutError):
+        return None
+def get_cached_version() -> str | None:
+    """Get cached latest version if still valid.
+    Returns:
+        Cached version string or None if cache expired/missing.
+    """
+    if not CACHE_FILE.exists():
+        return None
+    try:
+        data = json.loads(CACHE_FILE.read_text())
+        if time.time() - data.get("timestamp", 0) < CACHE_TTL:
+            return data.get("version")
+    except (json.JSONDecodeError, KeyError):
+        pass
+    return None
+def cache_version(version: str) -> None:
+    """Cache the latest version.
+    Args:
+        version: Version string to cache.
+    """
+    try:
+        CACHE_DIR.mkdir(parents=True, exist_ok=True)
+        CACHE_FILE.write_text(
+            json.dumps(
+                {
+                    "version": version,
+                    "timestamp": time.time(),
+                }
+            )
+        )
+    except OSError:
+        pass  # Ignore cache write failures
+def check_for_updates(use_cache: bool = True) -> tuple[bool, str | None]:
+    """Check if a newer version is available.
+    Args:
+        use_cache: Whether to use cached version check.
+    Returns:
+        Tuple of (update_available, latest_version).
+    """
+    # Try cache first
+    if use_cache:
+        latest = get_cached_version()
+        if latest:
+            try:
+                return parse_version(latest) > parse_version(__version__), latest
+            except (ValueError, TypeError):
+                pass
+    # Fetch from PyPI
+    latest = get_latest_version()
+    if latest is None:
+        return False, None
+    # Cache the result
+    cache_version(latest)
+    try:
+        return parse_version(latest) > parse_version(__version__), latest
+    except (ValueError, TypeError):
+        return False, latest
+def detect_install_method() -> str:
+    """Detect how porterminal was installed.
+    Returns:
+        One of: 'uv', 'pipx', 'pip'
+    """
+    executable = sys.executable
+    file_path = str(Path(__file__).resolve())
+    # Check for uv tool install
+    uv_patterns = [
+        "/.local/share/uv/tools/",
+        "/uv/tools/",
+        "\\uv\\tools\\",
+    ]
+    for pattern in uv_patterns:
+        if pattern in executable or pattern in file_path:
+            return "uv"
+    # Check for pipx install
+    pipx_patterns = [
+        "/pipx/venvs/",
+        "/.local/share/pipx/",
+        "/.local/pipx/",
+        "\\pipx\\venvs\\",
+    ]
+    for pattern in pipx_patterns:
+        if pattern in executable or pattern in file_path:
+            return "pipx"
+    # Default to pip
+    return "pip"
+def get_upgrade_command() -> str:
+    """Get the appropriate upgrade command for the installation method.
+    Returns:
+        Shell command string to upgrade porterminal.
+    """
+    method = detect_install_method()
+    commands = {
+        "uv": f"uv tool upgrade {PACKAGE_NAME}",
+        "pipx": f"pipx upgrade {PACKAGE_NAME}",
+        "pip": f"pip install --upgrade {PACKAGE_NAME}",
+    }
+    return commands.get(method, commands["pip"])
+def update_package() -> bool:
+    """Update porterminal to the latest version.
+    Returns:
+        True if update succeeded, False otherwise.
+    """
+    method = detect_install_method()
+    # Check if update is available first
+    has_update, latest = check_for_updates(use_cache=False)
+    if not has_update:
+        if latest:
+            print(f"Already at latest version ({__version__})")
+        else:
+            print("Could not check for updates (network error)")
+        return True
+    print(f"Updating {PACKAGE_NAME} {__version__} → {latest}")
+    try:
+        if method == "uv":
+            if not shutil.which("uv"):
+                print("uv not found, falling back to pip")
+                method = "pip"
+            else:
+                cmd = ["uv", "tool", "upgrade", PACKAGE_NAME]
+        if method == "pipx":
+            if not shutil.which("pipx"):
+                print("pipx not found, falling back to pip")
+                method = "pip"
+            else:
+                cmd = ["pipx", "upgrade", PACKAGE_NAME]
+        if method == "pip":
+            cmd = [sys.executable, "-m", "pip", "install", "--upgrade", PACKAGE_NAME]
+        result = subprocess.run(cmd, timeout=120)
+        if result.returncode == 0:
+            print(f"Successfully updated to {latest}")
+            print("Restart porterminal to use the new version")
+            return True
+        else:
+            print(f"Update failed (exit code {result.returncode})")
+            print(f"Try manually: {get_upgrade_command()}")
+            return False
+    except subprocess.TimeoutExpired:
+        print("Update timed out")
+        print(f"Try manually: {get_upgrade_command()}")
+        return False
+    except FileNotFoundError as e:
+        print(f"Command not found: {e}")
+        print(f"Try manually: {get_upgrade_command()}")
+        return False
+def print_update_notice(latest: str) -> None:
+    """Print a styled update notice.
+    Args:
+        latest: Latest available version.
+    """
+    from rich.console import Console
+    from rich.panel import Panel
+    console = Console(stderr=True)
+    upgrade_cmd = get_upgrade_command()
+    console.print()
+    console.print(
+        Panel(
+            f"[yellow]Update available:[/yellow] {__version__} → [green]{latest}[/green]\n"
+            f"[dim]Run:[/dim] [cyan]{upgrade_cmd}[/cyan]",
+            title="[bold]Porterminal[/bold]",
+            border_style="yellow",
+            padding=(0, 2),
+        )
+    )