devlinker 1.3.3__tar.gz → 1.3.5__tar.gz

devlinker-1.3.5/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 DevLinker Authors
+
+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.

{devlinker-1.3.3 → devlinker-1.3.5}/PKG-INFO

@@ -1,10 +1,11 @@
 Metadata-Version: 2.4
 Name: devlinker
-Version: 1.3.3
+Version: 1.3.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
@@ -13,6 +14,7 @@ Requires-Dist: pyngrok
 Requires-Dist: requests
 Requires-Dist: uvicorn
 Requires-Dist: websockets
+Dynamic: license-file
 
 # Dev Linker
 

devlinker-1.3.5/devlinker/detection_state.py

@@ -0,0 +1,66 @@
+
+class DetectionState:
+    def __init__(self):
+        self.issues = []
+        self.counts = {}
+        self.levels = {}
+        self.categories = {}
+
+    def add(self, issue, level="MEDIUM", category="general"):
+        key = issue.strip().lower()
+        if key in self.counts:
+            self.counts[key] += 1
+            return False  # already shown
+        else:
+            self.counts[key] = 1
+            self.issues.append({
+                "issue": issue,
+                "level": level,
+                "category": category
+            })
+            return True  # first time
+
+    def get_count(self, issue):
+        key = issue.strip().lower()
+        return self.counts.get(key, 0)
+
+    def should_print(self, issue):
+        key = issue.strip().lower()
+        return self.counts.get(key, 0) == 1
+
+    def get_issues(self):
+        return [
+            (i["issue"], i["level"], self.get_count(i["issue"]), i["category"])
+            for i in self.issues
+        ]
+
+    def summary(self):
+        summary = {}
+        for i in self.issues:
+            level = i["level"]
+            summary.setdefault(level, set()).add(i["issue"])
+        return summary
+
+    def _get_category(self, issue):
+        for i in self.issues:
+            if i["issue"] == issue:
+                return i["category"]
+        return "general"
+
+    def report(self):
+        print("\n🩺 DevLinker Doctor Report\n────────────────────────")
+        # Group by category
+        for i in self.issues:
+            issue = i["issue"]
+            level = i["level"]
+            category = i["category"]
+            count = self.get_count(issue)
+            if level == "HIGH":
+                print(f"❌ {issue} (x{count})")
+            elif level == "MEDIUM":
+                print(f"⚠️  {issue} (x{count})")
+            else:
+                print(f"💡 {issue} (x{count})")
+
+# Singleton instance
+state = DetectionState()

devlinker-1.3.5/devlinker/global_state.py

@@ -0,0 +1,5 @@
+# Stores global state for devlinker proxy and tunnel
+STATE = {
+    "proxy_port": 8000,
+    "tunnel": None
+}

{devlinker-1.3.3 → devlinker-1.3.5}/devlinker/proxy.py

@@ -23,23 +23,33 @@ _recent_requests = []
 _recent_lock = threading.Lock()
 
 class RequestInspector:
-    def analyze(self, path, status, target):
+    def analyze(self, path, status, target, method=None, response_text=None):
         warnings = []
-        # 1. Missing /api prefix
-        if not path.startswith("/api") and target == "backend":
-            issue = "Possible missing '/api' prefix"
-            state.add(issue, level="MEDIUM", category="routing")
-            warnings.append(issue)
-        # 2. 404 detection
+        # Ignore static files and paths
+        static_exts = [".js", ".css", ".ico", ".png", ".jpg", ".jpeg", ".svg", ".woff", ".woff2", ".ttf", ".map"]
+        IGNORE_PATHS = ["/@vite", "/assets", "/favicon.ico", "/src", "/node_modules"]
+        if any(path.endswith(ext) for ext in static_exts):
+            return warnings
+        if any(path.startswith(p) for p in IGNORE_PATHS):
+            return warnings
+        # Only warn for missing /api prefix if status is 404, method is POST/PUT/DELETE, and not static/ignored
+        if status == 404 and method and method.upper() in ["POST", "PUT", "DELETE"]:
+            if not path.startswith("/api"):
+                # Optionally, check response_text for "Not Found"
+                if response_text is None or "not found" in response_text.lower():
+                    issue = f"Possible missing '/api' prefix on {path} [{method}]"
+                    if state.add(issue, level="MEDIUM", category="routing"):
+                        warnings.append(issue)
+        # 2. 404 detection (general)
         if status == 404:
-            issue = "Route not found → check backend route"
-            state.add(issue, level="HIGH", category="routing")
-            warnings.append(issue)
+            issue = f"Route not found → check backend route: {path}"
+            if state.add(issue, level="HIGH", category="routing"):
+                warnings.append(issue)
         # 3. Upstream failure
         if status == 502:
-            issue = "Backend unreachable"
-            state.add(issue, level="HIGH", category="network")
-            warnings.append(issue)
+            issue = f"Backend unreachable: {path}"
+            if state.add(issue, level="HIGH", category="network"):
+                warnings.append(issue)
         # Log request for inspector
         with _recent_lock:
             _recent_requests.append({"path": path, "status": status, "target": target})
@@ -142,12 +152,15 @@ async def _forward_http(request: Request) -> Response:
     if target_port is None:
         if request.url.path.startswith("/api"):
             status = 503
-            warnings = inspector.analyze(request.url.path, status, "backend")
+            warnings = inspector.analyze(request.url.path, status, "backend", method=request.method)
             for w in warnings:
-                print_warning(w)
+                if "/api" in w:
+                    print_warning(f"API routing issue detected\n👉 {request.url.path} returned 404\n👉 Try: /api{request.url.path}")
+                else:
+                    print_warning(w)
             return PlainTextResponse("Backend is not configured.", status_code=status)
         status = 503
-        warnings = inspector.analyze(request.url.path, status, "frontend")
+        warnings = inspector.analyze(request.url.path, status, "frontend", method=request.method)
         for w in warnings:
             print_warning(w)
         return PlainTextResponse("Frontend is not configured.", status_code=status)
@@ -169,7 +182,7 @@ async def _forward_http(request: Request) -> Response:
         )
     except httpx.RequestError as exc:
         status = 502
-        warnings = inspector.analyze(request.url.path, status, "backend")
+        warnings = inspector.analyze(request.url.path, status, "backend", method=request.method)
         for w in warnings:
             print_warning(w)
         ai_suggestions = ai.analyze_failure(str(exc))
@@ -178,17 +191,43 @@ async def _forward_http(request: Request) -> Response:
         return PlainTextResponse(f"Upstream unavailable: {exc}", status_code=status)
 
     # Analyze response for warnings and fixes
-    warnings = inspector.analyze(request.url.path, upstream.status_code, "backend")
+    warnings = inspector.analyze(
+        request.url.path,
+        upstream.status_code,
+        "backend",
+        method=request.method,
+        response_text=upstream.text
+    )
     for w in warnings:
-        print_warning(w)
+        if "/api" in w:
+            print_warning(f"API routing issue detected\n👉 {request.url.path} returned 404\n👉 Try: /api{request.url.path}")
+        else:
+            print_warning(w)
     ai_suggestions = ai.analyze_failure(str(upstream.text))
     for s in ai_suggestions:
         print_fix(s)
 
+    # Only inject loader for HTML responses, not localhost
+    headers = _filter_response_headers(dict(upstream.headers))
+    content_type = headers.get("content-type", "")
+    is_html = "text/html" in content_type
+    is_public = not (request.client and request.client.host in ("127.0.0.1", "localhost"))
+    content = upstream.content
+    if is_html and is_public:
+        try:
+            html = content.decode(upstream.encoding or "utf-8", errors="replace")
+            # Only inject if </body> exists
+            if "</body>" in html:
+                with open(__import__('os').path.join(__import__('os').path.dirname(__file__), "devlinker_loader_snippet.html"), encoding="utf-8") as f:
+                    loader = f.read()
+                html = html.replace("</body>", loader + "</body>")
+                content = html.encode(upstream.encoding or "utf-8")
+        except Exception:
+            pass
     return Response(
-        content=upstream.content,
+        content=content,
         status_code=upstream.status_code,
-        headers=_filter_response_headers(dict(upstream.headers)),
+        headers=headers,
     )
 
 

devlinker-1.3.5/devlinker/share.py

@@ -0,0 +1,32 @@
+
+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)

{devlinker-1.3.3 → devlinker-1.3.5}/devlinker/tunnel.py

@@ -1,5 +1,24 @@
 from __future__ import annotations
 
+def stop_tunnel():
+    """Stop all active tunnels (Cloudflare/ngrok)."""
+    # Stop ngrok tunnels
+    try:
+        for tunnel in ngrok.get_tunnels():
+            public_url = getattr(tunnel, "public_url", None)
+            if public_url is not None:
+                ngrok.disconnect(public_url)
+    except Exception:
+        pass
+    # Stop cloudflared processes
+    global _CLOUDFLARED_PROCESSES
+    for proc in _CLOUDFLARED_PROCESSES:
+        try:
+            proc.terminate()
+        except Exception:
+            pass
+    _CLOUDFLARED_PROCESSES.clear()
+
 import re
 import shutil
 import subprocess
@@ -42,7 +61,21 @@ def _try_cloudflare(proxy_port: int, startup_timeout: float = 12.0) -> str | Non
         stdout, _ = process.communicate(timeout=startup_timeout)
         output = stdout or ""
     except TimeoutExpired as exc:
-        output = (exc.stdout or "") + (exc.stderr or "")
+        # exc.stdout and exc.stderr may be str, bytes, bytearray, or memoryview; convert to str
+        def to_str(val):
+            if isinstance(val, str):
+                return val
+            if isinstance(val, (bytes, bytearray)):
+                return val.decode(errors="replace")
+            if isinstance(val, memoryview):
+                return val.tobytes().decode(errors="replace")
+            return str(val) if val is not None else ""
+        exc_stdout = to_str(exc.stdout)
+        exc_stderr = to_str(exc.stderr)
+        output = exc_stdout + exc_stderr
+
+    if not isinstance(output, str):
+        output = str(output)
 
     url = _extract_trycloudflare_url(output)
     if url:
@@ -55,22 +88,30 @@ def _try_cloudflare(proxy_port: int, startup_timeout: float = 12.0) -> str | Non
 
 def _disconnect_existing_tunnels() -> None:
     for tunnel in ngrok.get_tunnels():
-        ngrok.disconnect(tunnel.public_url)
+        public_url = getattr(tunnel, "public_url", None)
+        if public_url is not None:
+            ngrok.disconnect(public_url)
 
 
-def _start_ngrok_tunnel(proxy_port: int) -> str:
+def _start_ngrok_tunnel(proxy_port: int) -> str | None:
     try:
-        tunnel = ngrok.connect(proxy_port)
-        return tunnel.public_url
+        tunnel = ngrok.connect(str(proxy_port))
+        public_url = getattr(tunnel, "public_url", None)
+        if public_url is not None:
+            return public_url
+        return None
     except PyngrokError as exc:
         message = str(exc).lower()
 
         # If a prior endpoint is still active, disconnect and retry once.
-        if "already online" in message or "endpoint" in message and "online" in message:
+        if "already online" in message or ("endpoint" in message and "online" in message):
             try:
                 _disconnect_existing_tunnels()
-                tunnel = ngrok.connect(proxy_port)
-                return tunnel.public_url
+                tunnel = ngrok.connect(str(proxy_port))
+                public_url = getattr(tunnel, "public_url", None)
+                if public_url is not None:
+                    return public_url
+                return None
             except PyngrokError as retry_exc:
                 raise RuntimeError(
                     f"Failed to start ngrok tunnel after disconnect retry: {retry_exc}"
@@ -97,7 +138,9 @@ def start_tunnel(proxy_port: int = 8000) -> tuple[str, str]:
 
     try:
         ngrok_url = _start_ngrok_tunnel(proxy_port)
-        return "ngrok", ngrok_url
+        if ngrok_url is not None:
+            return "ngrok", ngrok_url
+        raise RuntimeError("Ngrok tunnel did not return a public URL.")
     except RuntimeError as ngrok_error:
         raise RuntimeError(
             "No tunnel available.\n"

{devlinker-1.3.3 → devlinker-1.3.5}/devlinker.egg-info/PKG-INFO

@@ -1,10 +1,11 @@
 Metadata-Version: 2.4
 Name: devlinker
-Version: 1.3.3
+Version: 1.3.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
@@ -13,6 +14,7 @@ Requires-Dist: pyngrok
 Requires-Dist: requests
 Requires-Dist: uvicorn
 Requires-Dist: websockets
+Dynamic: license-file
 
 # Dev Linker
 

{devlinker-1.3.3 → devlinker-1.3.5}/devlinker.egg-info/SOURCES.txt

@@ -1,3 +1,4 @@
+LICENSE
 README.md
 pyproject.toml
 setup.py
@@ -9,6 +10,7 @@ devlinker/detector_ai.py
 devlinker/doctor.py
 devlinker/fix.py
 devlinker/fixer.py
+devlinker/global_state.py
 devlinker/inspect.py
 devlinker/logger.py
 devlinker/main.py

{devlinker-1.3.3 → devlinker-1.3.5}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "devlinker"
-version = "1.3.3"
+version = "1.3.5"
 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.3.3/devlinker/detection_state.py

@@ -1,58 +0,0 @@
-
-class DetectionState:
-    def __init__(self):
-        self.issues = []
-        self.counts = {}
-        self.levels = {}
-        self.categories = {}
-
-    def add(self, issue, level="MEDIUM", category="general"):
-        self.issues.append(issue)
-        self.counts[issue] = self.counts.get(issue, 0) + 1
-        self.levels[issue] = level
-        self.categories.setdefault(category, []).append(issue)
-
-    def should_print(self, issue):
-        return self.counts.get(issue, 0) == 1
-
-    def get_issues(self):
-        return [(issue, self.levels.get(issue, "MEDIUM"), self.counts[issue], self._get_category(issue)) for issue in self.issues]
-
-    def summary(self):
-        summary = {}
-        for issue in self.issues:
-            level = self.levels.get(issue, "MEDIUM")
-            summary.setdefault(level, set()).add(issue)
-        return summary
-
-    def _get_category(self, issue):
-        for cat, issues in self.categories.items():
-            if issue in issues:
-                return cat
-        return "general"
-
-    def report(self):
-        print("\n🩺 DevLinker Doctor Report\n────────────────────────")
-        # Group by category
-        for category, issues in self.categories.items():
-            if not issues:
-                continue
-            if category == "network":
-                print("\n🌐 Network Issues")
-            elif category == "routing":
-                print("\n🔀 Routing Issues")
-            elif category == "cors":
-                print("\n🔐 CORS Issues")
-            else:
-                print(f"\n{category.title()} Issues")
-            for issue in set(issues):
-                level = self.levels.get(issue, "MEDIUM")
-                if level == "HIGH":
-                    print(f"❌ {issue}")
-                elif level == "MEDIUM":
-                    print(f"⚠️  {issue}")
-                else:
-                    print(f"💡 {issue}")
-
-# Singleton instance
-state = DetectionState()

devlinker-1.3.3/devlinker/share.py

@@ -1,54 +0,0 @@
-import click
-from devlinker.tunnel import start_tunnel
-
-# Global tunnel state
-_tunnel_info = {
-    "provider": None,
-    "public_url": None,
-    "active": False,
-    "proxy_port": None,
-}
-
-@click.command()
-def share():
-    """Enable public tunnel at runtime (no restart)."""
-    from devlinker.main import _select_proxy_port
-    import sys
-    proxy_port = 8000
-    banner = "\n" + ("═" * 36) + "\n🌍 DevLinker Share Mode\n" + ("═" * 36)
-    if _tunnel_info["active"]:
-        click.secho(f"{banner}\n\n🔗 Tunnel already active:", fg="yellow", bold=True)
-        click.secho(f"   {_tunnel_info['public_url']}\n", fg="cyan", bold=True)
-        return
-    try:
-        click.secho(f"{banner}\n\n🌍 Enabling public tunnel...", fg="green", bold=True)
-        provider, public_url = start_tunnel(proxy_port)
-        _tunnel_info["provider"] = provider
-        _tunnel_info["public_url"] = public_url
-        _tunnel_info["active"] = True
-        _tunnel_info["proxy_port"] = proxy_port
-        click.secho(f"\n[OK] Tunnel provider: {provider}", fg="blue")
-        click.secho(f"[OK] Public URL:", fg="blue")
-        click.secho(f"   {public_url}\n", fg="cyan", bold=True)
-        click.secho("Tip: Press Ctrl+Click to open link", fg="magenta")
-        click.secho("[INFO] Share this link with collaborators.\n", 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")
-        sys.exit(1)
-
-@click.command()
-def unshare():
-    """Disable public tunnel at runtime (no restart)."""
-    banner = "\n" + ("═" * 36) + "\n🛑 DevLinker Unshare Mode\n" + ("═" * 36)
-    if not _tunnel_info["active"]:
-        click.secho(f"{banner}\n\nNo tunnel is currently active.\n", fg="yellow", bold=True)
-        return
-    # In a real implementation, stop the tunnel process here
-    click.secho(f"{banner}\n\n🛑 Disabling tunnel:", fg="red", bold=True)
-    click.secho(f"   {_tunnel_info['public_url']}\n", fg="cyan", bold=True)
-    _tunnel_info["provider"] = None
-    _tunnel_info["public_url"] = None
-    _tunnel_info["active"] = False
-    _tunnel_info["proxy_port"] = None
-    click.secho("[OK] Tunnel disabled.\n", fg="green", bold=True)