devlinker 1.4.2__tar.gz → 1.4.3__tar.gz

{devlinker-1.4.2 → devlinker-1.4.3}/MANIFEST.in

@@ -1,3 +1,2 @@
 include devlinker/devlinker_loader_instant.html
-include devlinker/devlinker_loader_minimal.html
 include devlinker/devlinker_loader_snippet.html

{devlinker-1.4.2/devlinker.egg-info → devlinker-1.4.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: devlinker
-Version: 1.4.2
+Version: 1.4.3
 Summary: A lightweight proxy that combines your frontend and backend into one link for easy development and sharing.
 Author-email: Mani <mani1028@users.noreply.github.com>
 Requires-Python: >=3.7
@@ -130,6 +130,7 @@ If DevLinker helps you ship faster, consider supporting the project:
 - `devlinker support` — Show UPI support QR code in terminal
 - `devlinker --url` — Start with public tunnel (Cloudflare/ngrok)
 - `devlinker share` — Enable public tunnel at runtime (no restart)
+- `devlinker share --proxy-port 18000` — Enable public tunnel for a custom proxy port
 - `devlinker unshare` — Disable public tunnel at runtime
 - `devlinker doctor` — Diagnose issues, see categorized problems and fixes
 - `devlinker fix` — Auto-fix common issues (env, API paths, config)
@@ -278,14 +279,16 @@ devlinker --docker
 
 ## Tunnel and Sharing Modes
 
-By default, DevLinker starts **fast local proxy only** (no tunnel). To enable a public tunnel, use the `--url` flag:
+By default, DevLinker starts **fast local proxy only** (no tunnel). It prints a LAN URL when it can detect a local network interface, and you can share that link with devices on the same Wi-Fi/LAN.
+
+For access from another network, start with a public tunnel using the `--url` flag:
 
 
 ```bash
 devlinker --url
 ```
 
-This will start the proxy and open a public tunnel (Cloudflare or ngrok). The output will show:
+This starts the proxy and opens a public tunnel (Cloudflare or ngrok). The output will show:
 
 ```text
 🌍 Enabling public tunnel...
@@ -296,6 +299,20 @@ This will start the proxy and open a public tunnel (Cloudflare or ngrok). The ou
 ℹ Share this link with collaborators.
 ```
 
+If you already started DevLinker and want to turn on sharing without restarting, use:
+
+```bash
+devlinker share
+```
+
+If you use a custom proxy port, pass it explicitly:
+
+```bash
+devlinker share --proxy-port 18000
+```
+
+If your friend is on the same Wi-Fi/LAN, use the printed LAN URL like `http://192.168.x.x:<proxy-port>`. If they are outside your network, use the public tunnel URL instead.
+
 To force tunnel off (even if --url is passed):
 
 ```bash

{devlinker-1.4.2 → devlinker-1.4.3}/README.md

@@ -110,6 +110,7 @@ If DevLinker helps you ship faster, consider supporting the project:
 - `devlinker support` — Show UPI support QR code in terminal
 - `devlinker --url` — Start with public tunnel (Cloudflare/ngrok)
 - `devlinker share` — Enable public tunnel at runtime (no restart)
+- `devlinker share --proxy-port 18000` — Enable public tunnel for a custom proxy port
 - `devlinker unshare` — Disable public tunnel at runtime
 - `devlinker doctor` — Diagnose issues, see categorized problems and fixes
 - `devlinker fix` — Auto-fix common issues (env, API paths, config)
@@ -258,14 +259,16 @@ devlinker --docker
 
 ## Tunnel and Sharing Modes
 
-By default, DevLinker starts **fast local proxy only** (no tunnel). To enable a public tunnel, use the `--url` flag:
+By default, DevLinker starts **fast local proxy only** (no tunnel). It prints a LAN URL when it can detect a local network interface, and you can share that link with devices on the same Wi-Fi/LAN.
+
+For access from another network, start with a public tunnel using the `--url` flag:
 
 
 ```bash
 devlinker --url
 ```
 
-This will start the proxy and open a public tunnel (Cloudflare or ngrok). The output will show:
+This starts the proxy and opens a public tunnel (Cloudflare or ngrok). The output will show:
 
 ```text
 🌍 Enabling public tunnel...
@@ -276,6 +279,20 @@ This will start the proxy and open a public tunnel (Cloudflare or ngrok). The ou
 ℹ Share this link with collaborators.
 ```
 
+If you already started DevLinker and want to turn on sharing without restarting, use:
+
+```bash
+devlinker share
+```
+
+If you use a custom proxy port, pass it explicitly:
+
+```bash
+devlinker share --proxy-port 18000
+```
+
+If your friend is on the same Wi-Fi/LAN, use the printed LAN URL like `http://192.168.x.x:<proxy-port>`. If they are outside your network, use the public tunnel URL instead.
+
 To force tunnel off (even if --url is passed):
 
 ```bash

{devlinker-1.4.2 → devlinker-1.4.3}/devlinker/main.py

@@ -33,7 +33,7 @@ except ImportError:  # pragma: no cover - fallback when rich is unavailable
 
 from . import __version__
 from .detector import check_port, detect_ports, is_vite_port
-from .proxy import start_proxy
+from .proxy import start_proxy, wait_for_proxy_startup
 from .runner import detect_backend_port, start_servers
 from .tunnel import start_tunnel
 from .doctor import doctor
@@ -43,6 +43,7 @@ from .share import share, unshare
 from .config import load_config
 from .inspect import inspect
 from .monitor import monitor
+from .global_state import STATE
 
 SUPPORT_UPI_ID = "devlinker@upi"
 SUPPORT_UPI_LINK = "upi://pay?pa=devlinker@upi&pn=DevLinker&cu=INR&tn=Support%20DevLinker%20Project%20🚀"
@@ -602,6 +603,7 @@ def _run_proxy(
         )
 
     proxy_port = _select_proxy_port(proxy_port)
+    STATE["proxy_port"] = proxy_port
     _write_frontend_api_env(proxy_port)
 
     if not live_status:
@@ -619,8 +621,10 @@ def _run_proxy(
         enable_debug_logs=debug,
     )
 
-    # Allow proxy thread to bind before opening tunnel.
-    time.sleep(1)
+    if not wait_for_proxy_startup(timeout=5.0):
+        raise click.ClickException(
+            f"Proxy failed to start on port {proxy_port}. Check whether the port is already in use."
+        )
 
     if live_status:
         live_status.update("Proxy", f"✔ Active ({proxy_port})", style="green")

{devlinker-1.4.2 → devlinker-1.4.3}/devlinker/proxy.py

@@ -26,6 +26,7 @@ _printed_fixes = set()
 _printed_live_header = False
 LIVE_REQUEST_LOGGING_ENABLED = False
 MAX_RECENT_REQUESTS = 200
+PROXY_READY_EVENT = threading.Event()
 
 
 def _format_request_context(path: str, method: str | None, status: int, target: str) -> str:
@@ -175,6 +176,7 @@ def _apply_cors_headers(headers: Dict[str, str], request: Request) -> Dict[str,
 async def _on_startup() -> None:
     global HTTP_CLIENT
     HTTP_CLIENT = httpx.AsyncClient(timeout=15.0, follow_redirects=False)
+    PROXY_READY_EVENT.set()
 
 
 @app.on_event("shutdown")
@@ -183,6 +185,7 @@ async def _on_shutdown() -> None:
     if HTTP_CLIENT is not None:
         await HTTP_CLIENT.aclose()
         HTTP_CLIENT = None
+    PROXY_READY_EVENT.clear()
 
 
 def _connection_header_tokens(headers: Dict[str, str]) -> set[str]:
@@ -720,9 +723,14 @@ def start_proxy(
     BACKEND = backend_port
     LIVE_REQUEST_LOGGING_ENABLED = enable_debug_logs
     _printed_live_header = False
+    PROXY_READY_EVENT.clear()
 
     thread = threading.Thread(
         target=lambda: uvicorn.run(app, host="0.0.0.0", port=proxy_port, log_level="warning"),
         daemon=True,
     )
     thread.start()
+
+
+def wait_for_proxy_startup(timeout: float = 5.0) -> bool:
+    return PROXY_READY_EVENT.wait(timeout)

devlinker-1.4.3/devlinker/share.py

@@ -0,0 +1,64 @@
+import click
+import requests
+
+from devlinker.global_state import STATE
+from devlinker.tunnel import start_tunnel
+
+
+_COMMON_PROXY_PORTS = (8000, 8001, 8002, 8003, 8004, 8005, 8006, 8007, 8008, 8009, 8010, 18000)
+
+
+def _is_devlinker_proxy(port: int) -> bool:
+    try:
+        response = requests.get(f"http://127.0.0.1:{port}/__devlinker/dashboard", timeout=0.5)
+    except requests.RequestException:
+        return False
+    return response.status_code == 200 and "API Logs Dashboard" in response.text
+
+
+def _resolve_proxy_port(requested_port: int | None) -> int:
+    if requested_port is not None:
+        if _is_devlinker_proxy(requested_port):
+            return requested_port
+        raise click.ClickException(
+            f"No DevLinker proxy is running on port {requested_port}. Start devlinker first, or pass the correct --proxy-port."
+        )
+
+    for candidate in _COMMON_PROXY_PORTS:
+        if _is_devlinker_proxy(candidate):
+            return candidate
+
+    raise click.ClickException(
+        "No running DevLinker proxy was found. Start devlinker first, or pass --proxy-port <port>."
+    )
+
+@click.command()
+@click.option("--proxy-port", type=int, default=None, help="Proxy port to tunnel. Auto-detect when omitted.")
+def share(proxy_port: int | None):
+    """Enable public tunnel at runtime (no restart)."""
+    if STATE["tunnel"]:
+        click.secho("⚠️ Already shared", fg="yellow")
+        return
+    try:
+        resolved_proxy_port = _resolve_proxy_port(proxy_port)
+        STATE["proxy_port"] = resolved_proxy_port
+        provider, url = start_tunnel(resolved_proxy_port)
+        STATE["tunnel"] = url
+        click.secho("\n🌍 Public Sharing Enabled\n" + ("─" * 24), fg="green", bold=True)
+        click.secho("✔ Tunnel connected", fg="green")
+        click.secho(f"\nPublic URL:\n{url}\n", fg="cyan", bold=True)
+        click.secho("📤 Share this link with your team", fg="magenta")
+    except Exception as exc:
+        click.secho(f"[WARN] Tunnel failed: {exc}", fg="red")
+        click.secho("[INFO] Next step: install cloudflared or configure ngrok auth.", fg="yellow")
+
+@click.command()
+def unshare():
+    """Disable public tunnel at runtime (no restart)."""
+    if not STATE["tunnel"]:
+        click.secho("⚠️ No active tunnel", fg="yellow")
+        return
+    from devlinker.tunnel import stop_tunnel
+    stop_tunnel()
+    STATE["tunnel"] = None
+    click.secho("🛑 Sharing stopped", fg="red", bold=True)

{devlinker-1.4.2 → devlinker-1.4.3/devlinker.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: devlinker
-Version: 1.4.2
+Version: 1.4.3
 Summary: A lightweight proxy that combines your frontend and backend into one link for easy development and sharing.
 Author-email: Mani <mani1028@users.noreply.github.com>
 Requires-Python: >=3.7
@@ -130,6 +130,7 @@ If DevLinker helps you ship faster, consider supporting the project:
 - `devlinker support` — Show UPI support QR code in terminal
 - `devlinker --url` — Start with public tunnel (Cloudflare/ngrok)
 - `devlinker share` — Enable public tunnel at runtime (no restart)
+- `devlinker share --proxy-port 18000` — Enable public tunnel for a custom proxy port
 - `devlinker unshare` — Disable public tunnel at runtime
 - `devlinker doctor` — Diagnose issues, see categorized problems and fixes
 - `devlinker fix` — Auto-fix common issues (env, API paths, config)
@@ -278,14 +279,16 @@ devlinker --docker
 
 ## Tunnel and Sharing Modes
 
-By default, DevLinker starts **fast local proxy only** (no tunnel). To enable a public tunnel, use the `--url` flag:
+By default, DevLinker starts **fast local proxy only** (no tunnel). It prints a LAN URL when it can detect a local network interface, and you can share that link with devices on the same Wi-Fi/LAN.
+
+For access from another network, start with a public tunnel using the `--url` flag:
 
 
 ```bash
 devlinker --url
 ```
 
-This will start the proxy and open a public tunnel (Cloudflare or ngrok). The output will show:
+This starts the proxy and opens a public tunnel (Cloudflare or ngrok). The output will show:
 
 ```text
 🌍 Enabling public tunnel...
@@ -296,6 +299,20 @@ This will start the proxy and open a public tunnel (Cloudflare or ngrok). The ou
 ℹ Share this link with collaborators.
 ```
 
+If you already started DevLinker and want to turn on sharing without restarting, use:
+
+```bash
+devlinker share
+```
+
+If you use a custom proxy port, pass it explicitly:
+
+```bash
+devlinker share --proxy-port 18000
+```
+
+If your friend is on the same Wi-Fi/LAN, use the printed LAN URL like `http://192.168.x.x:<proxy-port>`. If they are outside your network, use the public tunnel URL instead.
+
 To force tunnel off (even if --url is passed):
 
 ```bash

{devlinker-1.4.2 → devlinker-1.4.3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "devlinker"
-version = "1.4.2"
+version = "1.4.3"
 description = "A lightweight proxy that combines your frontend and backend into one link for easy development and sharing."
 authors = [
     { name = "Mani", email = "mani1028@users.noreply.github.com" }

devlinker-1.4.2/devlinker/share.py

@@ -1,32 +0,0 @@
-
-import click
-from devlinker.global_state import STATE
-from devlinker.tunnel import start_tunnel
-
-@click.command()
-def share():
-    """Enable public tunnel at runtime (no restart)."""
-    if STATE["tunnel"]:
-        click.secho("⚠️ Already shared", fg="yellow")
-        return
-    try:
-        provider, url = start_tunnel(STATE["proxy_port"])
-        STATE["tunnel"] = url
-        click.secho("\n🌍 Public Sharing Enabled\n" + ("─" * 24), fg="green", bold=True)
-        click.secho("✔ Tunnel connected", fg="green")
-        click.secho(f"\nPublic URL:\n{url}\n", fg="cyan", bold=True)
-        click.secho("📤 Share this link with your team", fg="magenta")
-    except Exception as exc:
-        click.secho(f"[WARN] Tunnel failed: {exc}", fg="red")
-        click.secho("[INFO] Next step: install cloudflared or configure ngrok auth.", fg="yellow")
-
-@click.command()
-def unshare():
-    """Disable public tunnel at runtime (no restart)."""
-    if not STATE["tunnel"]:
-        click.secho("⚠️ No active tunnel", fg="yellow")
-        return
-    from devlinker.tunnel import stop_tunnel
-    stop_tunnel()
-    STATE["tunnel"] = None
-    click.secho("🛑 Sharing stopped", fg="red", bold=True)