devlinker 1.4.5__tar.gz → 1.5.0__tar.gz

{devlinker-1.4.5 → devlinker-1.5.0}/PKG-INFO

@@ -1,21 +1,30 @@
 Metadata-Version: 2.4
 Name: devlinker
-Version: 1.4.5
+Version: 1.5.0
 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
+Requires-Python: >=3.8
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: click
-Requires-Dist: docker
 Requires-Dist: fastapi
 Requires-Dist: httpx
-Requires-Dist: pyngrok
-Requires-Dist: qrcode[pil]
+Requires-Dist: PyYAML
 Requires-Dist: requests
-Requires-Dist: rich
 Requires-Dist: uvicorn
 Requires-Dist: websockets
+Provides-Extra: docker
+Requires-Dist: docker; extra == "docker"
+Provides-Extra: tunnel
+Requires-Dist: pyngrok; extra == "tunnel"
+Provides-Extra: ui
+Requires-Dist: rich; extra == "ui"
+Provides-Extra: support
+Requires-Dist: qrcode[pil]; extra == "support"
+Provides-Extra: dev
+Requires-Dist: pytest; extra == "dev"
+Provides-Extra: all
+Requires-Dist: devlinker[docker,support,tunnel,ui]; extra == "all"
 Dynamic: license-file
 
 # Dev Linker
@@ -132,7 +141,7 @@ If DevLinker helps you ship faster, consider supporting the project:
 - `devlinker fix` — Auto-fix common issues (env, API paths, config)
 - `devlinker --frontend 5173 --backend 5000` — Override detected ports
 - `devlinker --docker` — Auto-start Docker backend
-- `devlinker --no-tunnel` — Force local-only mode
+- `devlinker --no-tunnel` — Explicitly force local/WLAN-only mode (no public tunnel)
 - `devlinker --no-lan` — Hide WLAN sharing URL
 - `devlinker --interactive-backend` — Prompt to choose backend if multiple found
 - `devlinker --proxy-port 18000` — Use custom proxy port
@@ -277,6 +286,20 @@ devlinker --docker
 
 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.
 
+LAN-only quick start:
+
+```bash
+devlinker
+```
+
+You can also pass `--no-tunnel` to explicitly enforce no public tunnel startup:
+
+```bash
+devlinker --no-tunnel
+```
+
+`--no-tunnel` does **not** disable frontend/backend linking. DevLinker still starts the local proxy and routes frontend + backend through the same local entry URL.
+
 For access from another network, start with a public tunnel using the `--url` flag:
 
 
@@ -297,21 +320,31 @@ This starts the proxy and opens a public tunnel (Cloudflare or ngrok). The outpu
 
 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):
+To force tunnel off (even if `--url` is passed):
 
 ```bash
 devlinker --no-tunnel
 ```
 
-When running without `--url`, you’ll see:
+When running without `--url`, you’ll see local/WLAN output with public disabled:
 
 ```text
-⚡ Skipping public tunnel (use --url to enable)
-
-💡 Need to share outside network?
-👉 Run: devlinker --url
+Proxy:    http://localhost:8000
+WLAN:     http://192.168.1.5:8000
+Public:   disabled (use --url)
 ```
 
+WLAN usage notes:
+
+- `localhost` works only on the machine running DevLinker.
+- Use the printed WLAN URL on phones/laptops connected to the same Wi-Fi/LAN.
+
+WLAN troubleshooting checklist:
+
+1. Ensure both devices are on the same Wi-Fi/subnet.
+2. Allow Python/DevLinker through firewall prompts (Private networks).
+3. Keep Universal Mode enabled (default) so localhost API calls are rewritten safely for LAN/public links.
+
 Disable WLAN URL output:
 
 ```bash
@@ -401,7 +434,6 @@ Example:
 frontend: 5173
 backend: 5000
 proxy_port: 8001
-tunnel: false
 backend_entry: main.py
 api_prefix: /api
 strip_prefix: true
@@ -412,6 +444,7 @@ Config key notes:
 - `backend_entry`: Optional Python backend startup file override (for example `main.py`)
 - `api_prefix`: Prefix DevLinker treats as API traffic (default: `/api`)
 - `strip_prefix`: When `true`, strips configured `api_prefix` before forwarding to backend
+- Public tunnel is opt-in at runtime using `--url`; local/WLAN mode works without ngrok/cloudflared.
 
 ## Backend Auto-Detection
 

devlinker-1.4.5/devlinker.egg-info/PKG-INFO → devlinker-1.5.0/README.md

@@ -1,23 +1,3 @@
-Metadata-Version: 2.4
-Name: devlinker
-Version: 1.4.5
-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
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: click
-Requires-Dist: docker
-Requires-Dist: fastapi
-Requires-Dist: httpx
-Requires-Dist: pyngrok
-Requires-Dist: qrcode[pil]
-Requires-Dist: requests
-Requires-Dist: rich
-Requires-Dist: uvicorn
-Requires-Dist: websockets
-Dynamic: license-file
-
 # Dev Linker
 
 Dev Linker starts your local development stack and routes frontend and backend traffic through one proxy URL, with optional LAN and public sharing.
@@ -132,7 +112,7 @@ If DevLinker helps you ship faster, consider supporting the project:
 - `devlinker fix` — Auto-fix common issues (env, API paths, config)
 - `devlinker --frontend 5173 --backend 5000` — Override detected ports
 - `devlinker --docker` — Auto-start Docker backend
-- `devlinker --no-tunnel` — Force local-only mode
+- `devlinker --no-tunnel` — Explicitly force local/WLAN-only mode (no public tunnel)
 - `devlinker --no-lan` — Hide WLAN sharing URL
 - `devlinker --interactive-backend` — Prompt to choose backend if multiple found
 - `devlinker --proxy-port 18000` — Use custom proxy port
@@ -277,6 +257,20 @@ devlinker --docker
 
 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.
 
+LAN-only quick start:
+
+```bash
+devlinker
+```
+
+You can also pass `--no-tunnel` to explicitly enforce no public tunnel startup:
+
+```bash
+devlinker --no-tunnel
+```
+
+`--no-tunnel` does **not** disable frontend/backend linking. DevLinker still starts the local proxy and routes frontend + backend through the same local entry URL.
+
 For access from another network, start with a public tunnel using the `--url` flag:
 
 
@@ -297,21 +291,31 @@ This starts the proxy and opens a public tunnel (Cloudflare or ngrok). The outpu
 
 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):
+To force tunnel off (even if `--url` is passed):
 
 ```bash
 devlinker --no-tunnel
 ```
 
-When running without `--url`, you’ll see:
+When running without `--url`, you’ll see local/WLAN output with public disabled:
 
 ```text
-⚡ Skipping public tunnel (use --url to enable)
-
-💡 Need to share outside network?
-👉 Run: devlinker --url
+Proxy:    http://localhost:8000
+WLAN:     http://192.168.1.5:8000
+Public:   disabled (use --url)
 ```
 
+WLAN usage notes:
+
+- `localhost` works only on the machine running DevLinker.
+- Use the printed WLAN URL on phones/laptops connected to the same Wi-Fi/LAN.
+
+WLAN troubleshooting checklist:
+
+1. Ensure both devices are on the same Wi-Fi/subnet.
+2. Allow Python/DevLinker through firewall prompts (Private networks).
+3. Keep Universal Mode enabled (default) so localhost API calls are rewritten safely for LAN/public links.
+
 Disable WLAN URL output:
 
 ```bash
@@ -401,7 +405,6 @@ Example:
 frontend: 5173
 backend: 5000
 proxy_port: 8001
-tunnel: false
 backend_entry: main.py
 api_prefix: /api
 strip_prefix: true
@@ -412,6 +415,7 @@ Config key notes:
 - `backend_entry`: Optional Python backend startup file override (for example `main.py`)
 - `api_prefix`: Prefix DevLinker treats as API traffic (default: `/api`)
 - `strip_prefix`: When `true`, strips configured `api_prefix` before forwarding to backend
+- Public tunnel is opt-in at runtime using `--url`; local/WLAN mode works without ngrok/cloudflared.
 
 ## Backend Auto-Detection
 

devlinker-1.5.0/devlinker/dashboard_html.py

@@ -0,0 +1,84 @@
+LOGS_DASHBOARD_HTML = """<!doctype html>
+<html>
+<head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width,initial-scale=1" />
+    <title>DevLinker API Logs</title>
+    <style>
+        :root { --bg:#f4f7fb; --card:#ffffff; --ink:#0f172a; --muted:#64748b; --ok:#065f46; --warn:#92400e; --err:#991b1b; --line:#dbe3ee; }
+        body { margin:0; font-family:"Segoe UI","Trebuchet MS",sans-serif; background: radial-gradient(circle at top left,#e7f1ff,transparent 45%), var(--bg); color:var(--ink); }
+        .wrap { max-width: 1100px; margin: 28px auto; padding: 0 16px; }
+        .card { background: var(--card); border:1px solid var(--line); border-radius:14px; box-shadow: 0 10px 25px rgba(15,23,42,.06); overflow:hidden; }
+        h1 { margin:0; font-size: 1.4rem; }
+        .head { padding: 14px 16px; display:flex; justify-content:space-between; align-items:center; border-bottom:1px solid var(--line); }
+        .meta { color:var(--muted); font-size:.9rem; }
+        table { width:100%; border-collapse: collapse; }
+        th,td { padding:10px 12px; border-bottom:1px solid var(--line); text-align:left; font-size:.9rem; }
+        th { color:var(--muted); font-weight:600; }
+        .s2 { color: var(--ok); font-weight: 700; }
+        .s4 { color: var(--warn); font-weight: 700; }
+        .s5 { color: var(--err); font-weight: 700; }
+        .path { font-family:Consolas, monospace; }
+        .empty { padding: 20px; color: var(--muted); }
+    </style>
+</head>
+<body>
+    <div class="wrap">
+        <div class="card">
+            <div class="head">
+                <h1>API Logs Dashboard</h1>
+                <div class="meta" id="meta">Waiting for traffic...</div>
+            </div>
+            <div id="content" class="empty">No requests yet.</div>
+        </div>
+    </div>
+    <script>
+        function statusClass(code){
+            if(code >= 500) return 's5';
+            if(code >= 400) return 's4';
+            return 's2';
+        }
+        function ago(ms){
+            const d = Date.now() - ms;
+            if (d < 1000) return 'now';
+            if (d < 60000) return Math.floor(d/1000) + 's ago';
+            return Math.floor(d/60000) + 'm ago';
+        }
+        function render(items){
+            const content = document.getElementById('content');
+            const meta = document.getElementById('meta');
+            if(!items.length){
+                content.className = 'empty';
+                content.textContent = 'No requests yet.';
+                meta.textContent = 'Waiting for traffic...';
+                return;
+            }
+            const rows = items.slice().reverse().map(item => {
+                const status = Number(item.status || 0);
+                const lat = item.latency_ms == null ? '-' : item.latency_ms + 'ms';
+                return '<tr>' +
+                    '<td>' + (item.method || '-') + '</td>' +
+                    '<td class="path">' + (item.path || '-') + '</td>' +
+                    '<td><span class="' + statusClass(status) + '">' + status + '</span></td>' +
+                    '<td>' + (item.target || '-') + '</td>' +
+                    '<td>' + lat + '</td>' +
+                    '<td>' + (item.ts ? ago(item.ts) : '-') + '</td>' +
+                    '</tr>';
+            }).join('');
+            content.className = '';
+            content.innerHTML = '<table><thead><tr><th>Method</th><th>Path</th><th>Status</th><th>Target</th><th>Latency</th><th>When</th></tr></thead><tbody>' + rows + '</tbody></table>';
+            meta.textContent = items.length + ' requests captured';
+        }
+        async function tick(){
+            try{
+                const resp = await fetch('/__devlinker/logs', {cache:'no-store'});
+                const data = await resp.json();
+                render(Array.isArray(data.items) ? data.items : []);
+            }catch(_){
+            }
+        }
+        tick();
+        setInterval(tick, 1500);
+    </script>
+</body>
+</html>"""

{devlinker-1.4.5 → devlinker-1.5.0}/devlinker/detector_ai.py

@@ -1,4 +1,4 @@
-class DevLinkerAI:
+class IssueHints:
     def analyze_prefix_mismatch(
         self,
         api_path: str,

{devlinker-1.4.5 → devlinker-1.5.0}/devlinker/devlinker_loader_instant.html

@@ -104,7 +104,10 @@
       const minTime = 500;
       const start = Date.now();
       try {
-        const resp = await fetch(window.location.href, { headers: { "X-DevLinker-Instant": "1" } });
+        const resp = await fetch(window.location.href, {
+          headers: { "X-DevLinker-Instant": "1" },
+          cache: "no-store",
+        });
         const html = await resp.text();
         const elapsed = Date.now() - start;
         const delay = Math.max(0, minTime - elapsed);

{devlinker-1.4.5 → devlinker-1.5.0}/devlinker/doctor.py

@@ -1,5 +1,5 @@
 import click
-from devlinker.detector_ai import DevLinkerAI
+from devlinker.detector_ai import IssueHints
 from devlinker.logger import print_fix
 from devlinker.runtime_api import fetch_issues, proxy_base_url
 
@@ -18,7 +18,7 @@ def doctor():
 
     issues = payload.get("items", [])
     categories = payload.get("categories", {})
-    ai = DevLinkerAI()
+    hints = IssueHints()
     print("\n🩺 DevLinker Health Dashboard\n" + ("═" * 36))
     # Grouped status summary
     if not categories:
@@ -45,6 +45,6 @@ def doctor():
         issue_text = issue.get("issue", "")
         if not issue_text:
             continue
-        suggestions = ai.analyze_failure(issue_text)
+        suggestions = hints.analyze_failure(issue_text)
         for s in suggestions:
             print_fix(s)

devlinker-1.5.0/devlinker/env_utils.py

@@ -0,0 +1,36 @@
+from __future__ import annotations
+
+from pathlib import Path
+
+_START_MARKER = "# devlinker-managed:start"
+_END_MARKER = "# devlinker-managed:end"
+
+
+def write_frontend_api_env(proxy_port: int, frontend_dir: str = "frontend") -> bool:
+    """Write VITE_API_URL into frontend/.env.local. Returns True when updated."""
+    frontend_path = Path(frontend_dir)
+    if not frontend_path.is_dir():
+        return False
+
+    env_path = frontend_path / ".env.local"
+    managed_block = (
+        f"{_START_MARKER}\n"
+        f"VITE_API_URL=http://localhost:{proxy_port}\n"
+        f"{_END_MARKER}"
+    )
+
+    try:
+        existing = env_path.read_text(encoding="utf-8") if env_path.exists() else ""
+        if _START_MARKER in existing and _END_MARKER in existing:
+            before, _, tail = existing.partition(_START_MARKER)
+            _, _, after = tail.partition(_END_MARKER)
+            updated = f"{before}{managed_block}{after}"
+        elif existing.strip():
+            updated = f"{existing.rstrip()}\n\n{managed_block}\n"
+        else:
+            updated = f"{managed_block}\n"
+
+        env_path.write_text(updated, encoding="utf-8")
+        return True
+    except OSError:
+        return False

{devlinker-1.4.5 → devlinker-1.5.0}/devlinker/fix.py

@@ -1,6 +1,6 @@
 import click
 from devlinker.fixer import DevLinkerFixer
-from devlinker.runtime_api import fetch_issues, proxy_base_url
+from devlinker.runtime_api import fetch_issues, fetch_status, proxy_base_url
 
 @click.command()
 def fix():
@@ -16,9 +16,15 @@ def fix():
         return
 
     issues = payload.get("items", [])
+    try:
+        status = fetch_status()
+        proxy_port = int(status.get("proxy_port") or 8000)
+    except Exception:
+        proxy_port = 8000
+
     fixer = DevLinkerFixer()
     print("\n🔧 Applying fixes...")
-    results = fixer.apply_fixes(issues)
+    results = fixer.apply_fixes(issues, proxy_port=proxy_port)
     print("\n🔧 Fix Results")
     for r in results:
         print(f"✔ {r}")

devlinker-1.5.0/devlinker/fixer.py

@@ -0,0 +1,27 @@
+from __future__ import annotations
+
+from devlinker.env_utils import write_frontend_api_env
+
+
+class DevLinkerFixer:
+    def apply_fixes(self, issues: list, proxy_port: int = 8000) -> list[str]:
+        fixes: list[str] = []
+        wrote_env = False
+
+        for issue in issues:
+            desc = issue[0] if isinstance(issue, (list, tuple)) else issue.get("issue", "")
+            lowered = desc.lower()
+
+            needs_env = "cors" in lowered or "missing '/api'" in lowered or "missing /api" in lowered
+            if not needs_env or wrote_env:
+                continue
+
+            if write_frontend_api_env(proxy_port):
+                fixes.append(f"Updated frontend/.env.local with VITE_API_URL=http://localhost:{proxy_port}")
+                wrote_env = True
+            elif "cors" in lowered:
+                fixes.append("Route API calls through /api/* using the DevLinker proxy URL")
+            else:
+                fixes.append("Replace hardcoded localhost URLs with relative /api paths in frontend code")
+
+        return fixes