ptn 0.1.4__py3-none-any.whl → 0.2.5__py3-none-any.whl

porterminal/static/assets/app-DQePboVd.css

@@ -0,0 +1,32 @@
+/**
+ * Copyright (c) 2014 The xterm.js authors. All rights reserved.
+ * Copyright (c) 2012-2013, Christopher Jeffrey (MIT License)
+ * https://github.com/chjj/term.js
+ * @license MIT
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ *
+ * Originally forked from (with the author's permission):
+ *   Fabrice Bellard's javascript vt100 for jslinux:
+ *   http://bellard.org/jslinux/
+ *   Copyright (c) 2011 Fabrice Bellard
+ *   The original design remains. The terminal itself
+ *   has been extended to include xterm CSI codes, among
+ *   other features.
+ */.xterm{cursor:text;position:relative;user-select:none;-ms-user-select:none;-webkit-user-select:none}.xterm.focus,.xterm:focus{outline:none}.xterm .xterm-helpers{position:absolute;top:0;z-index:5}.xterm .xterm-helper-textarea{padding:0;border:0;margin:0;position:absolute;opacity:0;left:-9999em;top:0;width:0;height:0;z-index:-5;white-space:nowrap;overflow:hidden;resize:none}.xterm .composition-view{background:#000;color:#fff;display:none;position:absolute;white-space:nowrap;z-index:1}.xterm .composition-view.active{display:block}.xterm .xterm-viewport{background-color:#000;overflow-y:scroll;cursor:default;position:absolute;right:0;left:0;top:0;bottom:0}.xterm .xterm-screen{position:relative}.xterm .xterm-screen canvas{position:absolute;left:0;top:0}.xterm .xterm-scroll-area{visibility:hidden}.xterm-char-measure-element{display:inline-block;visibility:hidden;position:absolute;top:0;left:-9999em;line-height:normal}.xterm.enable-mouse-events{cursor:default}.xterm.xterm-cursor-pointer,.xterm .xterm-cursor-pointer{cursor:pointer}.xterm.column-select.focus{cursor:crosshair}.xterm .xterm-accessibility:not(.debug),.xterm .xterm-message{position:absolute;left:0;top:0;bottom:0;right:0;z-index:10;color:transparent;pointer-events:none}.xterm .xterm-accessibility-tree:not(.debug) *::selection{color:transparent}.xterm .xterm-accessibility-tree{-webkit-user-select:text;user-select:text;white-space:pre}.xterm .live-region{position:absolute;left:-9999px;width:1px;height:1px;overflow:hidden}.xterm-dim{opacity:1!important}.xterm-underline-1{text-decoration:underline}.xterm-underline-2{text-decoration:double underline}.xterm-underline-3{text-decoration:wavy underline}.xterm-underline-4{text-decoration:dotted underline}.xterm-underline-5{text-decoration:dashed underline}.xterm-overline{text-decoration:overline}.xterm-overline.xterm-underline-1{text-decoration:overline underline}.xterm-overline.xterm-underline-2{text-decoration:overline double underline}.xterm-overline.xterm-underline-3{text-decoration:overline wavy underline}.xterm-overline.xterm-underline-4{text-decoration:overline dotted underline}.xterm-overline.xterm-underline-5{text-decoration:overline dashed underline}.xterm-strikethrough{text-decoration:line-through}.xterm-screen .xterm-decoration-container .xterm-decoration{z-index:6;position:absolute}.xterm-screen .xterm-decoration-container .xterm-decoration.xterm-decoration-top-layer{z-index:7}.xterm-decoration-overview-ruler{z-index:8;position:absolute;top:0;right:0;pointer-events:none}.xterm-decoration-top{z-index:2;position:relative}*{box-sizing:border-box;-webkit-tap-highlight-color:transparent}:root{--row-height: 30px;--content-padding: 12px;--scrollbar-width: 8px;--transition-fast: .15s ease;--radius-sm: 4px;--radius-md: 6px;--radius-lg: 8px;--radius-xl: 12px;--bg-primary: #1e1e1e;--bg-elevated: #252525;--bg-surface: #2d2d2d;--bg-hover: #3a3a3a;--bg-gradient-top: #232323;--bg-gradient-bottom: #1a1a1a;--text-primary: #cccccc;--text-high: rgba(255, 255, 255, .9);--text-white: #fff;--text-secondary: rgba(255, 255, 255, .7);--text-muted: rgba(255, 255, 255, .5);--text-disabled: rgba(255, 255, 255, .4);--border-subtle: rgba(255, 255, 255, .05);--border-light: rgba(255, 255, 255, .1);--border-medium: rgba(255, 255, 255, .15);--border-active: rgba(255, 255, 255, .2);--color-success: rgba(100, 220, 100, .8);--color-success-text: rgba(130, 230, 150, 1);--color-success-bg: rgba(100, 200, 120, .15);--color-success-border: rgba(100, 200, 120, .3);--bg-success-gradient-top: #2a3a2a;--bg-success-gradient-bottom: #1f2f1f;--color-danger: rgba(255, 100, 100, .8);--color-danger-muted: rgba(255, 120, 120, .7);--color-danger-text: rgba(255, 150, 150, 1);--color-danger-bg: rgba(255, 80, 80, .15);--color-danger-border: rgba(255, 120, 120, .3);--bg-danger-gradient-top: #3a2a2a;--bg-danger-gradient-bottom: #2f1f1f;--color-accent: rgba(80, 160, 255, .8);--color-accent-text: rgba(150, 200, 255, 1);--color-accent-bg: rgba(80, 160, 255, .3);--color-accent-strong: rgba(80, 160, 255, .5);--color-locked: rgba(255, 160, 60, .8);--color-locked-bg: rgba(255, 160, 60, .5);--glow-locked: 0 0 8px rgba(255, 160, 60, .5);--color-tmux: rgba(0, 180, 0, .8);--color-tmux-text: rgba(100, 220, 100, 1);--color-tmux-bg: rgba(0, 180, 0, .15);--hover-overlay: rgba(255, 255, 255, .05);--active-overlay: rgba(255, 255, 255, .08);--scrollbar-thumb: rgba(255, 255, 255, .15);--scrollbar-hover: rgba(255, 255, 255, .25);--cursor-color: #aeafad;--selection-bg: rgba(38, 79, 120, .5);--shadow-elevated: 0 4px 16px rgba(0, 0, 0, .5);--glow-success: 0 0 6px rgba(100, 220, 100, .4);--glow-danger: 0 0 6px rgba(255, 100, 100, .4);--glow-accent: 0 0 8px rgba(80, 160, 255, .4);--overlay-bg: rgba(0, 0, 0, .9)}.tool-btn,.tab-btn{-webkit-touch-callout:none}html,body{margin:0;padding:0;height:100%;overflow:hidden;background:var(--bg-primary);color:var(--text-primary);font-family:-apple-system,BlinkMacSystemFont,Segoe UI,sans-serif;font-size:13px;position:fixed;width:100%;touch-action:none;overscroll-behavior:none}#app{display:flex;flex-direction:column;height:100%;height:100dvh;height:100svh;padding-top:env(safe-area-inset-top,0px);padding-bottom:env(safe-area-inset-bottom,0px);overflow:hidden;overscroll-behavior:none}#tab-bar{display:flex;align-items:center;height:var(--row-height);min-height:var(--row-height);background:linear-gradient(to bottom,var(--bg-gradient-top),var(--bg-gradient-bottom));border-bottom:1px solid var(--border-subtle);overflow-x:auto;overflow-y:hidden;scrollbar-width:none;-ms-overflow-style:none}#tab-bar::-webkit-scrollbar{display:none}.tab-btn{display:flex;align-items:center;gap:2px;height:var(--row-height);padding:0 8px;background:transparent;border:none;border-right:1px solid var(--border-subtle);color:var(--text-muted);font-size:12px;cursor:pointer;white-space:nowrap;flex-shrink:0;transition:all var(--transition-fast)}.tab-btn:active{background:var(--hover-overlay)}.tab-btn.active{background:var(--active-overlay);color:var(--text-high)}.tab-btn.tab-add{color:var(--text-disabled);font-size:18px;padding:0 10px;border-right:none}.tab-btn.tab-add:active{color:var(--text-high)}.tab-label{max-width:100px;overflow:hidden;text-overflow:ellipsis}.tab-close{display:flex;align-items:center;justify-content:center;width:16px;height:16px;margin-left:2px;border-radius:var(--radius-sm);font-size:14px;color:var(--text-disabled);transition:all var(--transition-fast);position:relative;overflow:hidden}.tab-close:before{content:"";position:absolute;top:0;left:0;width:100%;height:100%;background:var(--color-danger-bg);transform:scaleX(0);transform-origin:left;transition:transform .4s ease-out;z-index:-1}.tab-close.holding:before{transform:scaleX(1)}.tab-close.holding{color:var(--color-danger-text)}.tab-close.ready{background:var(--color-danger-bg);color:var(--color-danger-text);animation:pulseReady .3s ease}@keyframes pulseReady{0%,to{transform:scale(1)}50%{transform:scale(1.1)}}#shell-selector{margin-left:auto;display:flex;align-items:center;padding:0 var(--content-padding);height:var(--row-height);border-left:1px solid var(--border-subtle)}#shell-select{background:transparent;border:none;color:var(--text-secondary);font-size:11px;padding:4px 8px;cursor:pointer;-webkit-appearance:none;-moz-appearance:none;appearance:none}#connection-dot{width:6px;height:6px;border-radius:50%;background:var(--color-danger);margin-left:var(--content-padding);margin-right:8px;box-shadow:var(--glow-danger);flex-shrink:0}#connection-dot.connected{background:var(--color-success);box-shadow:var(--glow-success)}#btn-info,#btn-textview,#btn-shutdown{background:transparent;border:none;color:var(--text-disabled);font-size:14px;padding:4px;margin-left:4px;cursor:pointer;transition:color var(--transition-fast)}#btn-textview{padding:4px 0;margin-left:2px;margin-right:4px;font-size:11px;font-weight:500}#btn-info:active,#btn-textview:active{color:var(--color-accent)}#btn-shutdown{color:var(--color-danger-muted)}#btn-shutdown:active{color:var(--color-danger-text)}#terminal-container{flex:1;overflow:hidden;background:var(--bg-primary);padding:0 0 0 var(--content-padding);-webkit-user-select:none;user-select:none;-webkit-touch-callout:none;touch-action:none;overscroll-behavior:contain;contain:strict;isolation:isolate}#terminal{height:100%!important;contain:layout paint}.terminal-instance{height:100%;width:100%;contain:layout paint}.xterm-screen canvas,.xterm canvas{transform:translateZ(0);backface-visibility:hidden}#terminal .xterm-viewport{background:var(--bg-primary)!important;overflow-y:overlay!important;touch-action:none;overscroll-behavior:contain;contain:paint}#terminal .xterm-viewport::-webkit-scrollbar{width:var(--scrollbar-width)}#terminal .xterm-viewport::-webkit-scrollbar-track{background:transparent}#terminal .xterm-viewport::-webkit-scrollbar-thumb{background:var(--scrollbar-thumb);border-radius:var(--radius-sm)}#terminal .xterm-viewport::-webkit-scrollbar-thumb:hover{background:var(--scrollbar-hover)}#terminal .xterm-screen{-webkit-user-select:none;user-select:none;-webkit-touch-callout:none}#terminal .xterm-helper-textarea,.xterm-helper-textarea{-webkit-text-security:none!important;font-size:16px!important;-webkit-user-select:text;user-select:text}.xterm-helper-textarea::-webkit-contacts-auto-fill-button,.xterm-helper-textarea::-webkit-credentials-auto-fill-button{visibility:hidden;display:none!important;pointer-events:none;position:absolute;right:0;width:0;height:0}#toolbar{display:flex;flex-direction:column;background:linear-gradient(to bottom,var(--bg-gradient-top),var(--bg-gradient-bottom));border-top:1px solid var(--border-subtle);padding-bottom:env(safe-area-inset-bottom,0px)}.toolbar-row{display:flex;align-items:center;justify-content:center;height:var(--row-height);min-height:var(--row-height);gap:0;overflow-x:auto;overflow-y:hidden;scrollbar-width:none;-ms-overflow-style:none}.toolbar-row:first-child{border-bottom:1px solid var(--border-subtle)}.toolbar-row::-webkit-scrollbar{display:none}.tool-btn{display:flex;align-items:center;justify-content:center;height:var(--row-height);padding:0 10px;background:transparent;border:none;border-right:1px solid var(--border-subtle);border-radius:0;color:var(--text-muted);font-size:12px;cursor:pointer;transition:all var(--transition-fast);-webkit-touch-callout:none;flex-shrink:0}.tool-btn:active{background:var(--hover-overlay);color:var(--text-high)}.tool-btn.arrow{padding:0 10px}.tool-btn.danger{color:var(--color-danger-muted)}.tool-btn.danger:active{background:var(--color-danger-bg);color:var(--color-danger-text)}.tool-btn.tmux{color:var(--color-tmux)}.tool-btn.tmux:active{background:var(--color-tmux-bg);color:var(--color-tmux-text)}.tool-btn.modifier{padding:0 10px}.tool-btn.icon{font-size:18px}.tool-btn.enter{color:var(--color-success)}.tool-btn.enter:active{background:var(--color-success-bg);color:var(--color-success-text)}.tool-btn.sticky{background:var(--color-accent-bg);color:var(--color-accent-text)}.tool-btn.locked{background:var(--color-locked-bg);color:var(--text-white);box-shadow:var(--glow-locked)}#disconnect-overlay{position:fixed;top:0;left:0;right:0;bottom:0;background:var(--overlay-bg);z-index:1000;display:flex;align-items:center;justify-content:center}#disconnect-content{text-align:center}#disconnect-icon{font-size:48px;color:var(--color-danger);margin-bottom:16px}#disconnect-text{color:var(--text-secondary);font-size:18px;margin-bottom:24px}#disconnect-retry{padding:var(--content-padding) 32px;background:var(--border-light);border:1px solid var(--border-medium);border-radius:var(--radius-lg);color:var(--text-high);font-size:14px;cursor:pointer;transition:all var(--transition-fast)}#disconnect-retry:active{background:var(--border-active);color:var(--text-white)}#copy-button{position:fixed;top:50%;left:50%;transform:translate(-50%,-50%);padding:8px 20px;background:linear-gradient(to bottom,var(--bg-surface),var(--bg-elevated));border:1px solid var(--border-light);border-radius:var(--radius-md);color:var(--text-high);font-family:-apple-system,BlinkMacSystemFont,Segoe UI,sans-serif;font-size:13px;font-weight:500;cursor:pointer;z-index:10000;box-shadow:var(--shadow-elevated);display:none;-webkit-tap-highlight-color:transparent;-webkit-touch-callout:none;touch-action:manipulation;transition:all var(--transition-fast)}#copy-button:active{background:linear-gradient(to bottom,var(--bg-hover),var(--bg-surface));transform:translate(-50%,-50%) scale(.97)}#copy-button.visible{display:block;animation:copyButtonAppear .1s ease-out}#copy-button.success{background:linear-gradient(to bottom,var(--bg-success-gradient-top),var(--bg-success-gradient-bottom));border-color:var(--color-success-border);color:var(--color-success-text)}#copy-button.error{background:linear-gradient(to bottom,var(--bg-danger-gradient-top),var(--bg-danger-gradient-bottom));border-color:var(--color-danger-border);color:var(--color-danger-text)}@keyframes copyButtonAppear{0%{opacity:0;transform:translate(-50%,-50%) scale(.9)}to{opacity:1;transform:translate(-50%,-50%) scale(1)}}#help-overlay{position:fixed;top:0;left:0;right:0;bottom:0;background:var(--overlay-bg);z-index:1000;display:flex;align-items:center;justify-content:center;padding:20px}#help-content{background:var(--bg-elevated);border:1px solid var(--border-light);border-radius:var(--radius-xl);max-width:320px;width:100%;box-shadow:var(--shadow-elevated);animation:helpAppear var(--transition-fast)}@keyframes helpAppear{0%{opacity:0;transform:scale(.95)}to{opacity:1;transform:scale(1)}}#help-header{display:flex;align-items:center;justify-content:space-between;padding:var(--content-padding) 16px;border-bottom:1px solid var(--border-subtle);color:var(--text-high);font-size:14px;font-weight:500}#help-close{background:transparent;border:none;color:var(--text-muted);font-size:20px;cursor:pointer;padding:4px 8px;line-height:1}#help-close:active{color:var(--text-high)}#help-body{padding:var(--content-padding) 16px}.help-section{margin-bottom:var(--content-padding)}.help-section:last-child{margin-bottom:0}.help-title{color:var(--text-muted);font-size:10px;text-transform:uppercase;letter-spacing:.5px;margin-bottom:6px}.help-item{display:flex;align-items:center;gap:10px;padding:4px 0;color:var(--text-secondary);font-size:12px}.help-key{display:inline-block;min-width:80px;padding:2px 6px;background:var(--bg-surface);border:1px solid var(--border-subtle);border-radius:var(--radius-sm);color:var(--text-high);font-size:11px;text-align:center}#textview-overlay{position:fixed;top:0;left:0;right:0;bottom:0;background:var(--bg-primary);z-index:1000;display:flex;flex-direction:column;padding-top:env(safe-area-inset-top,0px);padding-bottom:env(safe-area-inset-bottom,0px)}#textview-content{display:flex;flex-direction:column;width:100%;height:100%;background:var(--bg-primary)}#textview-header{display:flex;align-items:center;height:var(--row-height);min-height:var(--row-height);background:linear-gradient(to bottom,var(--bg-gradient-top),var(--bg-gradient-bottom));border-bottom:1px solid var(--border-subtle);flex-shrink:0}#textview-title{padding:0 var(--content-padding);color:var(--text-muted);font-size:12px;border-right:1px solid var(--border-subtle)}.textview-zoom-btn{display:flex;align-items:center;justify-content:center;height:var(--row-height);padding:0 var(--content-padding);background:transparent;border:none;border-right:1px solid var(--border-subtle);color:var(--text-muted);font-size:14px;cursor:pointer;transition:all var(--transition-fast)}.textview-zoom-btn:active{background:var(--hover-overlay);color:var(--text-high)}#textview-close{margin-left:auto;display:flex;align-items:center;justify-content:center;height:var(--row-height);padding:0 var(--content-padding);background:transparent;border:none;border-left:1px solid var(--border-subtle);color:var(--text-muted);font-size:16px;cursor:pointer;transition:all var(--transition-fast)}#textview-close:active{background:var(--hover-overlay);color:var(--text-high)}#textview-body{flex:1;min-height:0;margin:0;padding:8px var(--content-padding);background:var(--bg-primary);border:none;color:var(--text-primary);font-family:Menlo,Monaco,Consolas,monospace;font-size:9px;line-height:1.3;overflow-y:auto;white-space:pre-wrap;word-wrap:break-word;user-select:text;-webkit-user-select:text}.hidden{display:none!important}@media(prefers-reduced-motion:reduce){*,*:before,*:after{animation-duration:.01ms!important;transition-duration:.01ms!important}}

porterminal/static/index.html

@@ -14,23 +14,21 @@
     <meta name="format-detection" content="telephone=no">
     <title>Terminal</title>
 
-    <!-- PWA -->
-    <link rel="manifest" href="/static/manifest.json">
+    <!-- Icons (PWA disabled - not useful for tunnel-based access) -->
     <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">
+  <script type="module" crossorigin src="/static/assets/app-By4EXMHC.js"></script>
+  <link rel="stylesheet" crossorigin href="/static/assets/app-DQePboVd.css">
 </head>
 <body>
     <div id="app">
         <!-- Tab Bar with Shell Selector -->
         <div id="tab-bar">
             <span id="connection-dot"></span>
+            <button id="btn-textview" title="Plain Text View">TXT</button>
             <!-- 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>
@@ -41,33 +39,22 @@
         </div>
 
         <!-- Bottom Toolbar - Two rows -->
+        <!-- Buttons with data-key are generated from config/keys.ts -->
         <div id="toolbar">
-            <div class="toolbar-row">
+            <div class="toolbar-row" id="toolbar-row1">
                 <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>
+                <!-- Generated buttons inserted here -->
                 <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">
+            <div class="toolbar-row" id="toolbar-row2">
                 <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>
+                <!-- Generated buttons inserted here -->
                 <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 class="toolbar-row hidden" id="toolbar-row3">
+                <!-- Custom buttons from config inserted here -->
             </div>
         </div>
 
@@ -118,6 +105,10 @@
                     <div class="help-title">Tabs</div>
                     <div class="help-item"><span class="help-key">Hold ×</span> Close tab</div>
                 </div>
+                <div class="help-section">
+                    <div class="help-title">TXT Button</div>
+                    <div class="help-item">Plain text view for easy scrolling, selection and review</div>
+                </div>
             </div>
         </div>
     </div>

porterminal/updater.py

@@ -11,179 +11,139 @@ from urllib.request import Request, urlopen
 
 from porterminal import __version__
 
-PACKAGE_NAME = "porterminal"
+# Constants
+PACKAGE_NAME = "ptn"
 PYPI_URL = f"https://pypi.org/pypi/{PACKAGE_NAME}/json"
-CACHE_DIR = Path.home() / ".cache" / PACKAGE_NAME
+CACHE_DIR = Path.home() / ".ptn"
 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.
+def _detect_install_method() -> str:
+    """Detect how ptn was installed: uv, pipx, or pip."""
+    executable = sys.executable
+    file_path = str(Path(__file__).resolve())
 
-    Handles PEP 440 versions like "0.1.0", "1.0.0a1", "2.0.0.post1".
+    uv_patterns = ["/uv/tools/", "\\uv\\tools\\"]
+    if any(p in executable or p in file_path for p in uv_patterns):
+        return "uv"
 
-    Args:
-        version: Version string.
+    pipx_patterns = ["/pipx/venvs/", "\\pipx\\venvs\\"]
+    if any(p in executable or p in file_path for p in pipx_patterns):
+        return "pipx"
+
+    return "pip"
+
+
+def _is_newer(latest: str, current: str) -> bool:
+    """Return True if latest > current."""
+    try:
+        from packaging.version import Version
+
+        return Version(latest) > Version(current)
+    except Exception:
+        # Fallback: tuple comparison (handles 0.9 vs 0.10 correctly)
+        def to_tuple(v: str) -> tuple[int, ...]:
+            v = v.lstrip("v").split("+")[0].split(".dev")[0]
+            return tuple(int(p) for p in v.split(".")[:3] if p.isdigit())
 
-    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))
+            return to_tuple(latest) > to_tuple(current)
         except ValueError:
-            break
-    return tuple(parts) if parts else (0,)
-
+            return False
 
-def get_latest_version() -> str | None:
-    """Fetch the latest version from PyPI.
 
-    Returns:
-        Latest version string or None if fetch failed.
-    """
+def _get_check_interval() -> int:
+    """Get check interval from config."""
     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
+        from porterminal.config import get_config
 
+        return get_config().update.check_interval
+    except Exception:
+        return 86400  # Default 24h
 
-def get_cached_version() -> str | None:
-    """Get cached latest version if still valid.
 
-    Returns:
-        Cached version string or None if cache expired/missing.
-    """
+def _should_check() -> bool:
+    """Check if enough time passed since last check."""
     if not CACHE_FILE.exists():
-        return None
+        return True
     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
-
+        return time.time() - data.get("timestamp", 0) > _get_check_interval()
+    except (OSError, json.JSONDecodeError, KeyError):
+        return True
 
-def cache_version(version: str) -> None:
-    """Cache the latest version.
 
-    Args:
-        version: Version string to cache.
-    """
+def _save_cache(version: str) -> None:
+    """Save check result to cache."""
     try:
-        CACHE_DIR.mkdir(parents=True, exist_ok=True)
-        CACHE_FILE.write_text(
-            json.dumps(
-                {
-                    "version": version,
-                    "timestamp": time.time(),
-                }
-            )
-        )
+        CACHE_FILE.parent.mkdir(parents=True, exist_ok=True)
+        CACHE_FILE.write_text(json.dumps({"version": version, "timestamp": time.time()}))
     except OSError:
-        pass  # Ignore cache write failures
+        pass
 
 
-def check_for_updates(use_cache: bool = True) -> tuple[bool, str | None]:
-    """Check if a newer version is available.
+def get_latest_version(use_cache: bool = True) -> str | None:
+    """Fetch latest version from PyPI.
 
     Args:
-        use_cache: Whether to use cached version check.
+        use_cache: Use cached result if valid.
 
     Returns:
-        Tuple of (update_available, latest_version).
+        Latest version string or None if fetch failed.
     """
     # 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
+    if use_cache and CACHE_FILE.exists():
+        try:
+            data = json.loads(CACHE_FILE.read_text())
+            if time.time() - data.get("timestamp", 0) < _get_check_interval():
+                return data.get("version")
+        except (OSError, json.JSONDecodeError, KeyError):
+            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
+        request = Request(PYPI_URL, headers={"User-Agent": f"{PACKAGE_NAME}/{__version__}"})
+        with urlopen(request, timeout=5) as response:
+            data = json.loads(response.read().decode())
+            version = data["info"]["version"]
+            _save_cache(version)
+            return version
+    except (URLError, json.JSONDecodeError, KeyError, TimeoutError, OSError):
+        return None
 
 
-def detect_install_method() -> str:
-    """Detect how porterminal was installed.
+def check_for_updates(use_cache: bool = True) -> tuple[bool, str | None]:
+    """Check if a newer version is available.
+
+    Args:
+        use_cache: Use cached version check.
 
     Returns:
-        One of: 'uv', 'pipx', 'pip'
+        Tuple of (update_available, latest_version).
     """
-    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"
+    latest = get_latest_version(use_cache=use_cache)
+    if latest is None:
+        return False, None
+    return _is_newer(latest, __version__), latest
 
 
 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()
+    """Get appropriate upgrade command for the installation method."""
+    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}",
+        "pip": f"pip install -U {PACKAGE_NAME}",
     }
     return commands.get(method, commands["pip"])
 
 
 def update_package() -> bool:
-    """Update porterminal to the latest version.
+    """Update ptn 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:
@@ -192,66 +152,53 @@ def update_package() -> bool:
             print("Could not check for updates (network error)")
         return True
 
-    print(f"Updating {PACKAGE_NAME} {__version__} → {latest}")
+    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]
+    method = _detect_install_method()
 
-        result = subprocess.run(cmd, timeout=120)
+    # Build command
+    if method == "uv" and shutil.which("uv"):
+        cmd = ["uv", "tool", "upgrade", PACKAGE_NAME]
+    elif method == "pipx" and shutil.which("pipx"):
+        cmd = ["pipx", "upgrade", PACKAGE_NAME]
+    else:
+        cmd = [sys.executable, "-m", "pip", "install", "-U", PACKAGE_NAME]
 
+    try:
+        result = subprocess.run(cmd, timeout=120)
         if result.returncode == 0:
-            print(f"Successfully updated to {latest}")
-            print("Restart porterminal to use the new version")
+            print(f"Updated to {latest}. Restart to use new version.")
             return True
-        else:
-            print(f"Update failed (exit code {result.returncode})")
-            print(f"Try manually: {get_upgrade_command()}")
-            return False
-
+        print(f"Update failed (exit code {result.returncode})")
+        print(f"Try: {get_upgrade_command()}")
+        return False
     except subprocess.TimeoutExpired:
         print("Update timed out")
-        print(f"Try manually: {get_upgrade_command()}")
+        print(f"Try: {get_upgrade_command()}")
         return False
     except FileNotFoundError as e:
         print(f"Command not found: {e}")
-        print(f"Try manually: {get_upgrade_command()}")
+        print(f"Try: {get_upgrade_command()}")
         return False
 
 
-def print_update_notice(latest: str) -> None:
-    """Print a styled update notice.
+def check_and_notify() -> None:
+    """Check for updates and print notification if available.
 
-    Args:
-        latest: Latest available version.
+    Call at startup. Non-blocking, respects config settings, never exec's.
     """
-    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),
-        )
-    )
+    # Check if notifications are enabled
+    try:
+        from porterminal.config import get_config
+
+        if not get_config().update.notify_on_startup:
+            return
+    except Exception:
+        pass  # Default to enabled if config fails
+
+    if not _should_check():
+        return
+
+    has_update, latest = check_for_updates(use_cache=False)
+    if has_update and latest:
+        print(f"Update available: {__version__} -> {latest}. Run: {get_upgrade_command()}")

ptn-0.2.5.dist-info/METADATA

@@ -0,0 +1,148 @@
+Metadata-Version: 2.4
+Name: ptn
+Version: 0.2.5
+Summary: Web-based terminal accessible from phone via Cloudflare Tunnel
+Project-URL: Homepage, https://github.com/lyehe/porterminal
+Project-URL: Repository, https://github.com/lyehe/porterminal
+Project-URL: Documentation, https://github.com/lyehe/porterminal/tree/main/docs
+Project-URL: Issues, https://github.com/lyehe/porterminal/issues
+Author: Porterminal Contributors
+Maintainer: Porterminal Contributors
+License: AGPL-3.0-or-later
+License-File: LICENSE
+Keywords: cloudflare,mobile,pty,terminal,tunnel,web,websocket,xterm
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Web Environment
+Classifier: Framework :: FastAPI
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: System Administrators
+Classifier: License :: OSI Approved :: GNU Affero General Public License v3 or later (AGPLv3+)
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Internet :: WWW/HTTP
+Classifier: Topic :: System :: Shells
+Classifier: Topic :: Terminals :: Terminal Emulators/X Terminals
+Requires-Python: >=3.12
+Requires-Dist: fastapi>=0.104.0
+Requires-Dist: pydantic>=2.0
+Requires-Dist: pywinpty>=2.0.0; sys_platform == 'win32'
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: qrcode>=7.4
+Requires-Dist: rich>=13.0
+Requires-Dist: uvicorn[standard]>=0.24.0
+Provides-Extra: dev
+Requires-Dist: watchfiles>=0.21.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+<p align="center">
+  <a href="https://github.com/lyehe/porterminal">
+    <img src="assets/banner.jpg" alt="Porterminal - Vibe Code From Anywhere" width="600">
+  </a>
+</p>
+
+<p align="center">
+  <a href="https://pypi.org/project/ptn/"><img src="https://img.shields.io/pypi/v/ptn?style=flat-square&logo=pypi&logoColor=white&label=PyPI" alt="PyPI"></a>
+  <a href="https://pypi.org/project/ptn/"><img src="https://img.shields.io/pypi/pyversions/ptn?style=flat-square&logo=python&logoColor=white" alt="Python"></a>
+  <a href="https://pypi.org/project/ptn/"><img src="https://img.shields.io/pypi/dm/ptn?style=flat-square&label=Downloads" alt="Downloads"></a>
+  <a href="https://github.com/lyehe/porterminal/blob/main/LICENSE"><img src="https://img.shields.io/github/license/lyehe/porterminal?style=flat-square" alt="License"></a>
+  <a href="https://github.com/lyehe/porterminal/actions/workflows/ci.yml"><img src="https://img.shields.io/github/actions/workflow/status/lyehe/porterminal/ci.yml?branch=master&style=flat-square&logo=github&label=CI" alt="CI"></a>
+</p>
+
+
+
+<p align="center">
+  <b>1.</b> <code>uvx ptn</code><br>
+  <b>2.</b> Scan the QR<br>
+  <b>3.</b> Access your terminal from your phone<br>
+</p>
+
+<p align="center">
+  <video src="assets/demo.mp4" width="600" controls></video>
+</p>
+
+---
+
+## Why
+
+I wanted to vibe code from bed. ngrok requires registration and the free tier sucks. Cloudflare Quick Tunnel works great but is hard to use directly on the phone. Termius works after complicated setup: port forwarding, firewall rules, key management... I just wanted something simpler: **run a command, scan a QR, start typing.**
+
+## Features
+
+- **One command, instant access** - No SSH, no port forwarding, no config files. Cloudflare tunnel + QR code.
+- **Actually usable on mobile** - Essential buttons and gestures for everyday terminal use.
+- **Multi-tab shared sessions** - Run builds in one tab, tail logs in another. Sessions persist across reconnects.
+- **Cross-platform** - Windows (PowerShell, CMD, WSL), Linux/macOS (Bash, Zsh, Fish). Auto-detects your shells.
+- **Update notifications** - Checks PyPI daily, notifies on startup if update available. Run `ptn -U` to update.
+
+## Install
+
+| Method | Install | Update |
+|--------|---------|--------|
+| **uvx** (no install) | `uvx ptn` | `uvx --refresh ptn` |
+| **uv tool** | `uv tool install ptn` | `uv tool upgrade ptn` |
+| **pipx** | `pipx install ptn` | `pipx upgrade ptn` |
+| **pip** | `pip install ptn` | `pip install -U ptn` |
+
+Requires Python 3.12+ and [cloudflared](https://developers.cloudflare.com/cloudflare-one/connections/connect-networks/downloads/) (auto-installed if missing).
+
+## Usage
+
+```bash
+ptn                    # Start in current directory
+ptn ~/projects/myapp   # Start in specific folder
+ptn --no-tunnel        # Local network only
+ptn -b                 # Run in background
+ptn --init             # Create .ptn/ptn.yaml config
+ptn -U                 # Update to latest version
+ptn --check-update     # Check if update available
+```
+
+## Configuration
+
+Run `ptn --init` to create a starter config, or create `ptn.yaml` manually:
+
+```yaml
+# Custom buttons (appear in toolbar)
+buttons:
+  - label: "claude"
+    send:
+      - "claude"
+      - 100        # delay in ms
+      - "\r"
+  - label: "tmux"
+    send: "tmux\r"
+
+# Update checker settings
+update:
+  notify_on_startup: true   # Show update notification
+  check_interval: 86400     # Seconds between checks (default: 24h)
+```
+
+Config is searched in order: `$PORTERMINAL_CONFIG_PATH`, `./ptn.yaml`, `./.ptn/ptn.yaml`, `~/.ptn/ptn.yaml`.
+
+## Security
+
+> **Warning:** The URL is the only authentication. Anyone with the link has full terminal access.
+
+- Don't share the URL
+- Stop the server when not in use (`Ctrl+C`)
+- Use `--no-tunnel` for local network only
+- Environment variables are sanitized (API keys, tokens stripped)
+
+## Contributing
+
+Issues and PRs welcome.
+
+```bash
+git clone https://github.com/lyehe/porterminal
+cd porterminal
+uv sync
+uv run ptn
+```
+
+## License
+
+[AGPL-3.0](LICENSE)