portacode 1.4.15.dev1__py3-none-any.whl → 1.4.15.dev2__py3-none-any.whl

portacode/_version.py

@@ -28,7 +28,7 @@ version_tuple: VERSION_TUPLE
 commit_id: COMMIT_ID
 __commit_id__: COMMIT_ID
 
-__version__ = version = '1.4.15.dev1'
-__version_tuple__ = version_tuple = (1, 4, 15, 'dev1')
+__version__ = version = '1.4.15.dev2'
+__version_tuple__ = version_tuple = (1, 4, 15, 'dev2')
 
 __commit_id__ = commit_id = None

portacode/connection/handlers/WEBSOCKET_PROTOCOL.md

@@ -420,7 +420,7 @@ Creates or updates a Cloudflare tunnel in front of a managed container. The cont
 
 *   `ctid` (string, required): Identifier of the container.
 *   `container_port` (integer, required): Port inside the container to expose through Cloudflare.
-*   `cloudflare_url` (string, required): Hostname (e.g., `app.example.com`) that the tunnel should serve.
+*   `cloudflare_url` (string, optional): Hostname (e.g., `app.example.com`) that the tunnel should serve. Leave blank to let Cloudflare create a quick tunnel (`*.cfargotunnel.com`) automatically.
 *   `protocol` (string, optional): One of `http`, `https`, or `tcp` (defaults to `http`).
 
 **Responses:**
@@ -436,7 +436,7 @@ Refreshes the tunnel configuration for an existing tunnel (different port, URL,
 
 *   `ctid` (string, required): Identifier of the container.
 *   `container_port` (integer, optional): New container port.
-*   `cloudflare_url` (string, optional): New hostname.
+*   `cloudflare_url` (string, optional): New hostname (leave blank to keep the current hostname or let Cloudflare assign a quick tunnel).
 *   `protocol` (string, optional): New protocol (`http`, `https`, or `tcp`).
 
 **Responses:**
@@ -1273,7 +1273,7 @@ Submitted after a successful `create_cloudflare_tunnel` action.
 *   `ctid` (string): Container ID associated with the tunnel.
 *   `success` (boolean): True when the tunnel is running.
 *   `message` (string): Summary text.
-*   `tunnel` (object): Tunnel metadata matching the manager view.
+*   `tunnel` (object): Tunnel metadata matching the manager view. When using Cloudflare Quick Tunnel (no hostname supplied), `tunnel.url` holds the autogenerated `*.cfargotunnel.com` hostname.
 
 ### `cloudflare_tunnel_updated`
 

portacode/connection/handlers/proxmox_infra.py

@@ -8,6 +8,8 @@ import logging
 import os
 import secrets
 import shlex
+import re
+import select
 import shutil
 import stat
 import subprocess
@@ -637,19 +639,19 @@ def _launch_container_tunnel(proxmox: Any, node: str, vmid: int, tunnel: Dict[st
     port = int(tunnel.get("container_port") or 0)
     if not port:
         raise ValueError("container_port is required to create a tunnel.")
-    hostname = tunnel.get("url")
-    if not hostname:
-        raise ValueError("cloudflare_url is required to expose the tunnel.")
+    requested_hostname = tunnel.get("url") or None
     protocol = (tunnel.get("protocol") or "http").lower()
     ip_address = _resolve_container_ip(proxmox, node, vmid)
     target_url = f"{protocol}://{ip_address}:{port}"
     name = tunnel.get("name") or _build_tunnel_name(vmid, port)
     _stop_cloudflare_process(name)
-    proc = _start_cloudflare_process(name, hostname, target_url)
+    proc, assigned_url = _start_cloudflare_process(name, target_url, hostname=requested_hostname)
+    if not assigned_url:
+        raise RuntimeError("Failed to determine Cloudflare hostname for the tunnel.")
     updated = {
         "name": name,
         "container_port": port,
-        "url": hostname,
+        "url": assigned_url,
         "protocol": protocol,
         "status": "running",
         "pid": proc.pid,
@@ -671,13 +673,14 @@ def _stop_container_tunnel(vmid: int) -> None:
         return
     name = tunnel.get("name") or _build_tunnel_name(vmid, int(tunnel.get("container_port") or 0))
     stopped = _stop_cloudflare_process(name)
-    if stopped or tunnel.get("status") != "stopped":
-        tunnel_update = {
-            **tunnel,
-            "status": "stopped",
-            "pid": None,
-            "last_updated": datetime.utcnow().isoformat() + "Z",
-        }
+    if not stopped and tunnel.get("status") == "stopped":
+        return
+    tunnel_update = {
+        **tunnel,
+        "status": "stopped",
+        "pid": None,
+        "last_updated": datetime.utcnow().isoformat() + "Z",
+    }
     _update_container_tunnel(vmid, tunnel_update)
 
 
@@ -827,25 +830,67 @@ def _get_cloudflared_binary() -> str:
     return binary
 
 
-def _start_cloudflare_process(name: str, hostname: str, target_url: str) -> subprocess.Popen:
+def _drain_stream(stream: Optional[Any]) -> None:
+    if stream is None:
+        return
+    try:
+        for _ in iter(stream.readline, ""):
+            continue
+    except Exception:
+        pass
+    finally:
+        try:
+            stream.close()
+        except Exception:
+            pass
+
+
+def _await_quick_tunnel_url(proc: subprocess.Popen, timeout: float = 15.0) -> Optional[str]:
+    if not proc.stdout:
+        return None
+    cf_re = re.compile(r"https://[A-Za-z0-9\-.]+\.cfargotunnel\.com")
+    deadline = time.time() + timeout
+    while time.time() < deadline:
+        ready, _, _ = select.select([proc.stdout], [], [], 1)
+        if not ready:
+            continue
+        line = proc.stdout.readline()
+        if not line:
+            continue
+        match = cf_re.search(line)
+        if match:
+            return match.group(0)
+    return None
+
+
+def _start_cloudflare_process(name: str, target_url: str, hostname: Optional[str] = None) -> Tuple[subprocess.Popen, Optional[str]]:
     binary = _get_cloudflared_binary()
     cmd = [
         binary,
         "tunnel",
-        "--hostname",
-        hostname,
         "--url",
         target_url,
         "--no-autoupdate",
     ]
+    if hostname:
+        cmd.extend(["--hostname", hostname])
+        stdout_target = subprocess.DEVNULL
+    else:
+        stdout_target = subprocess.PIPE
     proc = subprocess.Popen(
         cmd,
-        stdout=subprocess.DEVNULL,
-        stderr=subprocess.DEVNULL,
+        stdout=stdout_target,
+        stderr=subprocess.PIPE,
+        text=True,
     )
     with _CLOUDFLARE_TUNNELS_LOCK:
         _CLOUDFLARE_TUNNEL_PROCESSES[name] = proc
-    return proc
+    assigned_url = hostname
+    if not hostname:
+        assigned_url = _await_quick_tunnel_url(proc)
+        threading.Thread(target=_drain_stream, args=(proc.stdout,), daemon=True).start()
+    threading.Thread(target=_drain_stream, args=(proc.stderr,), daemon=True).start()
+    return proc, assigned_url
 
 
 def _stop_cloudflare_process(name: str) -> bool:
@@ -1884,8 +1929,7 @@ class CreateCloudflareTunnelHandler(SyncHandler):
         if container_port <= 0:
             raise ValueError("container_port is required and must be greater than zero.")
         hostname = (message.get("cloudflare_url") or message.get("hostname") or "").strip()
-        if not hostname:
-            raise ValueError("cloudflare_url is required.")
+        hostname = hostname or None
         protocol = (message.get("protocol") or "http").strip().lower()
         if protocol not in {"http", "https", "tcp"}:
             raise ValueError("protocol must be one of http, https, or tcp.")
@@ -1899,9 +1943,10 @@ class CreateCloudflareTunnelHandler(SyncHandler):
             raise RuntimeError("Container must be running to create a tunnel.")
         tunnel = {
             "container_port": container_port,
-            "url": hostname,
             "protocol": protocol,
         }
+        if hostname:
+            tunnel["url"] = hostname
         created = _launch_container_tunnel(proxmox, node, vmid, tunnel)
         return {
             "event": "cloudflare_tunnel_created",
@@ -1934,16 +1979,16 @@ class UpdateCloudflareTunnelHandler(SyncHandler):
         if container_port <= 0:
             raise ValueError("container_port must be greater than zero.")
         hostname = (message.get("cloudflare_url") or tunnel.get("url") or "").strip()
-        if not hostname:
-            raise ValueError("cloudflare_url is required.")
+        hostname = hostname or None
         protocol = (message.get("protocol") or tunnel.get("protocol") or "http").strip().lower()
         if protocol not in {"http", "https", "tcp"}:
             raise ValueError("protocol must be one of http, https, or tcp.")
         updated_tunnel = {
             "container_port": container_port,
-            "url": hostname,
             "protocol": protocol,
         }
+        if hostname:
+            updated_tunnel["url"] = hostname
         result = _launch_container_tunnel(proxmox, node, vmid, updated_tunnel)
         return {
             "event": "cloudflare_tunnel_updated",

{portacode-1.4.15.dev1.dist-info → portacode-1.4.15.dev2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: portacode
-Version: 1.4.15.dev1
+Version: 1.4.15.dev2
 Summary: Portacode CLI client and SDK
 Home-page: https://github.com/portacode/portacode
 Author: Meena Erian

{portacode-1.4.15.dev1.dist-info → portacode-1.4.15.dev2.dist-info}/RECORD

@@ -1,7 +1,7 @@
 portacode/README.md,sha256=4dKtpvR8LNgZPVz37GmkQCMWIr_u25Ao63iW56s7Ke4,775
 portacode/__init__.py,sha256=oB3sV1wXr-um-RXio73UG8E5Xx6cF2ZVJveqjNmC-vQ,1086
 portacode/__main__.py,sha256=jmHTGC1hzmo9iKJLv-SSYe9BSIbPPZ2IOpecI03PlTs,296
-portacode/_version.py,sha256=Gl8_1Kg3vuWq9htOanvxRd3kbf_a48CP9mpOXGbiomk,719
+portacode/_version.py,sha256=oWFHpNG7I0w-78ytqCCXMciE0ywZlQquvI0R-kyOX34,719
 portacode/cli.py,sha256=mGLKoZ-T2FBF7IA9wUq0zyG0X9__-A1ao7gajjcVRH8,21828
 portacode/data.py,sha256=5-s291bv8J354myaHm1Y7CQZTZyRzMU3TGe5U4hb-FA,1591
 portacode/keypair.py,sha256=0OO4vHDcF1XMxCDqce61xFTlFwlTcmqe5HyGsXFEt7s,5838
@@ -14,7 +14,7 @@ portacode/connection/client.py,sha256=jtLb9_YufqPkzi9t8VQH3iz_JEMisbtY6a8L9U5wei
 portacode/connection/multiplex.py,sha256=L-TxqJ_ZEbfNEfu1cwxgJ5vUdyRzZjsMy2Kx1diiZys,5237
 portacode/connection/terminal.py,sha256=oyLPOVLPlUuN_eRvHPGazB51yi8W8JEF3oOEYxucGTE,45069
 portacode/connection/handlers/README.md,sha256=HsLZG1QK1JNm67HsgL6WoDg9nxzKXxwkc5fJPFJdX5g,12169
-portacode/connection/handlers/WEBSOCKET_PROTOCOL.md,sha256=nbu1iQkqCCuUOyCdItBAETO0ab2UNWV060VpS8WyAhY,102810
+portacode/connection/handlers/WEBSOCKET_PROTOCOL.md,sha256=IZMuYF5wc23_ovEzXAvlLZLW1WXmqUUlrh_feTSsQfE,103110
 portacode/connection/handlers/__init__.py,sha256=WSeBmi65GWFQPYt9M3E10rn0uZ_EPCJzNJOzSf2HZyw,2921
 portacode/connection/handlers/base.py,sha256=oENFb-Fcfzwk99Qx8gJQriEMiwSxwygwjOiuCH36hM4,10231
 portacode/connection/handlers/chunked_content.py,sha256=h6hXRmxSeOgnIxoU8CkmvEf2Odv-ajPrpHIe_W3GKcA,9251
@@ -22,7 +22,7 @@ portacode/connection/handlers/diff_handlers.py,sha256=iYTIRCcpEQ03vIPKZCsMTE5aZb
 portacode/connection/handlers/file_handlers.py,sha256=nAJH8nXnX07xxD28ngLpgIUzcTuRwZBNpEGEKdRqohw,39507
 portacode/connection/handlers/project_aware_file_handlers.py,sha256=AqgMnDqX2893T2NsrvUSCwjN5VKj4Pb2TN0S_SuboOE,9803
 portacode/connection/handlers/project_state_handlers.py,sha256=v6ZefGW9i7n1aZLq2jOGumJIjYb6aHlPI4m1jkYewm8,1686
-portacode/connection/handlers/proxmox_infra.py,sha256=73Lvf_VjiXLAfVlegBDH9VXr7JzXyN3SKESHhyd-v6s,73699
+portacode/connection/handlers/proxmox_infra.py,sha256=4XxGeHAppuvVdqTQI-UoYTunS78uI8_NSR5Rqtqexso,75073
 portacode/connection/handlers/registry.py,sha256=qXGE60sYEWg6ZtVQzFcZ5YI2XWR6lMgw4hAL9x5qR1I,6181
 portacode/connection/handlers/session.py,sha256=uNGfiO_1B9-_yjJKkpvmbiJhIl6b-UXlT86UTfd6WYE,42219
 portacode/connection/handlers/system_handlers.py,sha256=fr12QpOr_Z8KYGUU-AYrTQwRPAcrLK85hvj3SEq1Kw8,14757
@@ -65,7 +65,7 @@ portacode/utils/__init__.py,sha256=NgBlWTuNJESfIYJzP_3adI1yJQJR0XJLRpSdVNaBAN0,3
 portacode/utils/diff_apply.py,sha256=4Oi7ft3VUCKmiUE4VM-OeqO7Gk6H7PF3WnN4WHXtjxI,15157
 portacode/utils/diff_renderer.py,sha256=S76StnQ2DLfsz4Gg0m07UwPfRp8270PuzbNaQq-rmYk,13850
 portacode/utils/ntp_clock.py,sha256=VqCnWCTehCufE43W23oB-WUdAZGeCcLxkmIOPwInYHc,2499
-portacode-1.4.15.dev1.dist-info/licenses/LICENSE,sha256=2FGbCnUDgRYuQTkB1O1dUUpu5CVAjK1j4_p6ack9Z54,1066
+portacode-1.4.15.dev2.dist-info/licenses/LICENSE,sha256=2FGbCnUDgRYuQTkB1O1dUUpu5CVAjK1j4_p6ack9Z54,1066
 test_modules/README.md,sha256=Do_agkm9WhSzueXjRAkV_xEj6Emy5zB3N3VKY5Roce8,9274
 test_modules/__init__.py,sha256=1LcbHodIHsB0g-g4NGjSn6AMuCoGbymvXPYLOb6Z7F0,53
 test_modules/test_device_online.py,sha256=QtYq0Dq9vME8Gp2O4fGSheqVf8LUtpsSKosXXk56gGM,1654
@@ -91,8 +91,8 @@ testing_framework/core/playwright_manager.py,sha256=Tw46qwxIhOFkS48C2IWIQHHNpEe-
 testing_framework/core/runner.py,sha256=j2QwNJmAxVBmJvcbVS7DgPJUKPNzqfLmt_4NNdaKmZU,19297
 testing_framework/core/shared_cli_manager.py,sha256=BESSNtyQb7BOlaOvZmm04T8Uezjms4KCBs2MzTxvzYQ,8790
 testing_framework/core/test_discovery.py,sha256=2FZ9fJ8Dp5dloA-fkgXoJ_gCMC_nYPBnA3Hs2xlagzM,4928
-portacode-1.4.15.dev1.dist-info/METADATA,sha256=dDo_VYpC29NGZXMz95iwBAedzWnWhDFiU69MnZNSMwU,13051
-portacode-1.4.15.dev1.dist-info/WHEEL,sha256=qELbo2s1Yzl39ZmrAibXA2jjPLUYfnVhUNTlyF1rq0Y,92
-portacode-1.4.15.dev1.dist-info/entry_points.txt,sha256=lLUUL-BM6_wwe44Xv0__5NQ1BnAz6jWjSMFvZdWW3zU,48
-portacode-1.4.15.dev1.dist-info/top_level.txt,sha256=TGhTYUxfW8SyVZc_zGgzjzc24gGT7nSw8Qf73liVRKM,41
-portacode-1.4.15.dev1.dist-info/RECORD,,
+portacode-1.4.15.dev2.dist-info/METADATA,sha256=iZsuq2JwkRIK8b60HLPQ4kMUH5-oXoDaVMCFPGgfm6c,13051
+portacode-1.4.15.dev2.dist-info/WHEEL,sha256=qELbo2s1Yzl39ZmrAibXA2jjPLUYfnVhUNTlyF1rq0Y,92
+portacode-1.4.15.dev2.dist-info/entry_points.txt,sha256=lLUUL-BM6_wwe44Xv0__5NQ1BnAz6jWjSMFvZdWW3zU,48
+portacode-1.4.15.dev2.dist-info/top_level.txt,sha256=TGhTYUxfW8SyVZc_zGgzjzc24gGT7nSw8Qf73liVRKM,41
+portacode-1.4.15.dev2.dist-info/RECORD,,