devlinker 1.4.4__tar.gz → 1.4.5__tar.gz

{devlinker-1.4.4/devlinker.egg-info → devlinker-1.4.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: devlinker
-Version: 1.4.4
+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
@@ -99,12 +99,11 @@ flowchart LR
 - 🔍 **Auto Detection:** Detects frontend/backend ports, runtime, Docker containers, and Vite servers automatically.
 - 📡 **Debug Request Logger:** Live API traffic lines (method, path, status, latency) only in debug mode.
 - 🧩 **Backend-Only Mode:** If no frontend is detected, DevLinker still runs and forwards all traffic to backend.
-- 🔁 **Auto API URL Sync:** Updates `frontend/.env.local` with `VITE_API_URL=http://localhost:<proxy-port>` using a managed block.
+- 🔁 **Runtime API URL Injection:** Injects runtime browser patching so hardcoded localhost API calls are rewritten to the active proxy/tunnel origin.
 - 🛡️ **Proxy CORS + Preflight:** Handles common CORS/preflight behavior at the proxy layer, including credential-safe Origin handling.
 - 🧠 **Smart Detection & Doctor:** Real-time request analysis, backend intelligence, log analyzer, and `devlinker doctor` for instant diagnostics.
 - 🛡️ **Auto-Fix Engine:** `devlinker fix` applies safe fixes (like VITE_API_URL) and suggests code changes.
-- 🌍 **Public Sharing:** Share your local dev environment instantly with `--url` (startup) or `devlinker share` (runtime, no restart).
-- 🔄 **Dynamic Tunnel Control:** `devlinker unshare` disables public tunnel at runtime.
+- 🌍 **Public Sharing:** Share your local dev environment instantly with the `--url` flag at startup.
 - 📡 **WLAN Sharing:** Prints LAN URL for same-network device access.
 - 🔒 **Secure Token Linking:** Optional token gate for LAN/public access with `DEVLINKER_LINK_TOKEN`.
 - 📊 **Browser API Logs Dashboard:** Open `/__devlinker/dashboard` for lightweight live API visibility.
@@ -129,9 +128,6 @@ If DevLinker helps you ship faster, consider supporting the project:
 - `devlinker` — Start proxy (local only, fast)
 - `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)
 - `devlinker --frontend 5173 --backend 5000` — Override detected ports
@@ -219,7 +215,7 @@ Typical startup output (TTY with Rich available):
 
 ```text
 ╭─────────────────────────────╮
-│ ♾️  DevLinker v1.4.1        │
+│ ♾️  DevLinker v1.4.5        │
 │ Smart Local Dev Environment │
 ╰─────────────────────────────╯
 
@@ -299,18 +295,6 @@ This starts the proxy and opens a public tunnel (Cloudflare or ngrok). The outpu
 ℹ 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):
@@ -393,15 +377,7 @@ fetch("/api/endpoint")
 
 Do not hardcode backend host URLs in frontend code.
 
-DevLinker also writes/updates a managed block in `frontend/.env.local`:
-
-```env
-# devlinker-managed:start
-VITE_API_URL=http://localhost:8001
-# devlinker-managed:end
-```
-
-This keeps frontend API calls consistently routed through the proxy.
+DevLinker injects runtime config and request patching in proxied HTML so frontend API calls are routed through the active proxy/tunnel origin without requiring source edits or frontend rebuilds.
 
 Use the proxy URL as your single entry point during development:
 
@@ -426,8 +402,17 @@ frontend: 5173
 backend: 5000
 proxy_port: 8001
 tunnel: false
+backend_entry: main.py
+api_prefix: /api
+strip_prefix: true
 ```
 
+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
+
 ## Backend Auto-Detection
 
 Backend port detection runs in this order:
@@ -439,6 +424,16 @@ Backend port detection runs in this order:
 5. Use the best mapped host port automatically, even when internal port is not 5000
 6. If nothing is found, print next-step guidance and exit
 
+Python backend entry detection supports automatic discovery of:
+
+- `app.py`
+- `main.py`
+- `server.py`
+- `run.py`
+- `manage.py`
+
+If `backend_entry` is set in config, DevLinker uses it first and falls back to the discovery list.
+
 If Docker SDK is unavailable, Dev Linker falls back to Docker CLI parsing as a compatibility path.
 
 When both Local and Docker backends are available, Dev Linker prompts you to choose one (TTY mode) unless `--no-interactive-backend` is used.
@@ -464,7 +459,7 @@ Dev Linker checks backend runtime in this order:
 1. Docker Compose (`backend/docker-compose.yml`, `docker-compose.yaml`, `compose.yml`, or `compose.yaml`)
 2. Docker (`backend/Dockerfile`)
 3. Node (`backend/package.json`)
-4. Python (`backend/requirements.txt` or `backend/app.py`)
+4. Python (`backend/requirements.txt` or discovered entry file such as `app.py` / `main.py`)
 
 Backend startup commands:
 
@@ -472,7 +467,7 @@ Backend startup commands:
 - Dockerfile (default): manual run `docker build -t devlinker-backend .` then `docker run --rm -p 5000:5000 devlinker-backend`
 - Docker Compose/Dockerfile with `--docker`: Dev Linker runs those Docker commands for you
 - Node: `npm run dev` (or `npm start` when `dev` is missing)
-- Python: `python app.py`
+- Python: `python <discovered-entry>` (auto: `app.py`, `main.py`, `server.py`, `run.py`, `manage.py`, or configured `backend_entry`)
 
 For containerized Flask backends, ensure:
 
@@ -481,7 +476,7 @@ For containerized Flask backends, ensure:
 
 ## Notes
 
-- runner.py expects frontend project in frontend and Python app in backend/app.py.
+- runner.py expects frontend project in `frontend/` and backend project in `backend/`, with automatic Python entry discovery.
 - If those paths do not exist, Dev Linker skips launch and only tries to detect already-running services.
 - If frontend is missing but backend is available, DevLinker continues in backend-only mode.
 - Tunnel selection order is: cloudflared (TryCloudflare), then ngrok.

{devlinker-1.4.4 → devlinker-1.4.5}/README.md

@@ -79,12 +79,11 @@ flowchart LR
 - 🔍 **Auto Detection:** Detects frontend/backend ports, runtime, Docker containers, and Vite servers automatically.
 - 📡 **Debug Request Logger:** Live API traffic lines (method, path, status, latency) only in debug mode.
 - 🧩 **Backend-Only Mode:** If no frontend is detected, DevLinker still runs and forwards all traffic to backend.
-- 🔁 **Auto API URL Sync:** Updates `frontend/.env.local` with `VITE_API_URL=http://localhost:<proxy-port>` using a managed block.
+- 🔁 **Runtime API URL Injection:** Injects runtime browser patching so hardcoded localhost API calls are rewritten to the active proxy/tunnel origin.
 - 🛡️ **Proxy CORS + Preflight:** Handles common CORS/preflight behavior at the proxy layer, including credential-safe Origin handling.
 - 🧠 **Smart Detection & Doctor:** Real-time request analysis, backend intelligence, log analyzer, and `devlinker doctor` for instant diagnostics.
 - 🛡️ **Auto-Fix Engine:** `devlinker fix` applies safe fixes (like VITE_API_URL) and suggests code changes.
-- 🌍 **Public Sharing:** Share your local dev environment instantly with `--url` (startup) or `devlinker share` (runtime, no restart).
-- 🔄 **Dynamic Tunnel Control:** `devlinker unshare` disables public tunnel at runtime.
+- 🌍 **Public Sharing:** Share your local dev environment instantly with the `--url` flag at startup.
 - 📡 **WLAN Sharing:** Prints LAN URL for same-network device access.
 - 🔒 **Secure Token Linking:** Optional token gate for LAN/public access with `DEVLINKER_LINK_TOKEN`.
 - 📊 **Browser API Logs Dashboard:** Open `/__devlinker/dashboard` for lightweight live API visibility.
@@ -109,9 +108,6 @@ If DevLinker helps you ship faster, consider supporting the project:
 - `devlinker` — Start proxy (local only, fast)
 - `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)
 - `devlinker --frontend 5173 --backend 5000` — Override detected ports
@@ -199,7 +195,7 @@ Typical startup output (TTY with Rich available):
 
 ```text
 ╭─────────────────────────────╮
-│ ♾️  DevLinker v1.4.1        │
+│ ♾️  DevLinker v1.4.5        │
 │ Smart Local Dev Environment │
 ╰─────────────────────────────╯
 
@@ -279,18 +275,6 @@ This starts the proxy and opens a public tunnel (Cloudflare or ngrok). The outpu
 ℹ 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):
@@ -373,15 +357,7 @@ fetch("/api/endpoint")
 
 Do not hardcode backend host URLs in frontend code.
 
-DevLinker also writes/updates a managed block in `frontend/.env.local`:
-
-```env
-# devlinker-managed:start
-VITE_API_URL=http://localhost:8001
-# devlinker-managed:end
-```
-
-This keeps frontend API calls consistently routed through the proxy.
+DevLinker injects runtime config and request patching in proxied HTML so frontend API calls are routed through the active proxy/tunnel origin without requiring source edits or frontend rebuilds.
 
 Use the proxy URL as your single entry point during development:
 
@@ -406,8 +382,17 @@ frontend: 5173
 backend: 5000
 proxy_port: 8001
 tunnel: false
+backend_entry: main.py
+api_prefix: /api
+strip_prefix: true
 ```
 
+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
+
 ## Backend Auto-Detection
 
 Backend port detection runs in this order:
@@ -419,6 +404,16 @@ Backend port detection runs in this order:
 5. Use the best mapped host port automatically, even when internal port is not 5000
 6. If nothing is found, print next-step guidance and exit
 
+Python backend entry detection supports automatic discovery of:
+
+- `app.py`
+- `main.py`
+- `server.py`
+- `run.py`
+- `manage.py`
+
+If `backend_entry` is set in config, DevLinker uses it first and falls back to the discovery list.
+
 If Docker SDK is unavailable, Dev Linker falls back to Docker CLI parsing as a compatibility path.
 
 When both Local and Docker backends are available, Dev Linker prompts you to choose one (TTY mode) unless `--no-interactive-backend` is used.
@@ -444,7 +439,7 @@ Dev Linker checks backend runtime in this order:
 1. Docker Compose (`backend/docker-compose.yml`, `docker-compose.yaml`, `compose.yml`, or `compose.yaml`)
 2. Docker (`backend/Dockerfile`)
 3. Node (`backend/package.json`)
-4. Python (`backend/requirements.txt` or `backend/app.py`)
+4. Python (`backend/requirements.txt` or discovered entry file such as `app.py` / `main.py`)
 
 Backend startup commands:
 
@@ -452,7 +447,7 @@ Backend startup commands:
 - Dockerfile (default): manual run `docker build -t devlinker-backend .` then `docker run --rm -p 5000:5000 devlinker-backend`
 - Docker Compose/Dockerfile with `--docker`: Dev Linker runs those Docker commands for you
 - Node: `npm run dev` (or `npm start` when `dev` is missing)
-- Python: `python app.py`
+- Python: `python <discovered-entry>` (auto: `app.py`, `main.py`, `server.py`, `run.py`, `manage.py`, or configured `backend_entry`)
 
 For containerized Flask backends, ensure:
 
@@ -461,7 +456,7 @@ For containerized Flask backends, ensure:
 
 ## Notes
 
-- runner.py expects frontend project in frontend and Python app in backend/app.py.
+- runner.py expects frontend project in `frontend/` and backend project in `backend/`, with automatic Python entry discovery.
 - If those paths do not exist, Dev Linker skips launch and only tries to detect already-running services.
 - If frontend is missing but backend is available, DevLinker continues in backend-only mode.
 - Tunnel selection order is: cloudflared (TryCloudflare), then ngrok.

devlinker-1.4.5/devlinker/config.py

@@ -0,0 +1,55 @@
+import os
+import json
+
+try:
+    import yaml
+except ImportError:  # pragma: no cover - optional dependency fallback
+    yaml = None
+
+
+def _normalize_api_prefix(value: object) -> str:
+    if not isinstance(value, str):
+        return "/api"
+    prefix = value.strip()
+    if not prefix:
+        return "/api"
+    if not prefix.startswith("/"):
+        prefix = f"/{prefix}"
+    if len(prefix) > 1 and prefix.endswith("/"):
+        prefix = prefix.rstrip("/")
+    return prefix or "/api"
+
+
+def _normalize_config(data: dict) -> dict:
+    normalized = dict(data)
+    backend_entry = normalized.get("backend_entry")
+    if not backend_entry:
+        backend_entry = normalized.get("entry_point")
+    if isinstance(backend_entry, str) and backend_entry.strip():
+        normalized["backend_entry"] = backend_entry.strip()
+
+    if "api_prefix" in normalized:
+        normalized["api_prefix"] = _normalize_api_prefix(normalized.get("api_prefix"))
+
+    if "strip_prefix" in normalized:
+        normalized["strip_prefix"] = bool(normalized.get("strip_prefix"))
+
+    return normalized
+
+
+def load_config(config_path: str = "devlinker.yaml") -> dict:
+    candidates = [config_path, "devlinker.yml", "devlinker.json"]
+    if yaml is None:
+        candidates = [path for path in candidates if path.endswith(".json")]
+    selected = next((path for path in candidates if os.path.exists(path)), None)
+    if not selected:
+        return {}
+
+    with open(selected, "r", encoding="utf-8") as handle:
+        if selected.endswith(".json"):
+            data = json.load(handle)
+        else:
+            if yaml is None:
+                return {}
+            data = yaml.safe_load(handle)
+    return _normalize_config(data or {})

{devlinker-1.4.4 → devlinker-1.4.5}/devlinker/detection_state.py

@@ -13,6 +13,8 @@ class DetectionState:
             return False  # already shown
         else:
             self.counts[key] = 1
+            self.levels[issue] = level
+            self.categories.setdefault(category, []).append(issue)
             self.issues.append({
                 "issue": issue,
                 "level": level,
@@ -62,5 +64,42 @@ class DetectionState:
             else:
                 print(f"💡 {issue} (x{count})")
 
+    def get_issue_records(self):
+        records = []
+        for issue in self.issues:
+            issue_text = issue["issue"]
+            records.append(
+                {
+                    "issue": issue_text,
+                    "level": issue["level"],
+                    "category": issue["category"],
+                    "count": self.get_count(issue_text),
+                }
+            )
+        return records
+
+    def get_category_statuses(self):
+        statuses = {}
+        for category, issues in self.categories.items():
+            if not issues:
+                statuses[category] = "OK"
+                continue
+            has_high = any(self.levels.get(issue, "MEDIUM") == "HIGH" for issue in issues)
+            has_medium = any(self.levels.get(issue, "MEDIUM") == "MEDIUM" for issue in issues)
+            if has_high:
+                statuses[category] = "HIGH"
+            elif has_medium:
+                statuses[category] = "MEDIUM"
+            else:
+                statuses[category] = "LOW"
+        return statuses
+
+    def snapshot(self):
+        return {
+            "total_issues": len(self.issues),
+            "items": self.get_issue_records(),
+            "categories": self.get_category_statuses(),
+        }
+
 # Singleton instance
 state = DetectionState()

devlinker-1.4.5/devlinker/detector_ai.py

@@ -0,0 +1,46 @@
+class DevLinkerAI:
+    def analyze_prefix_mismatch(
+        self,
+        api_path: str,
+        prefixed_status: int,
+        unprefixed_status: int,
+        api_prefix: str = "/api",
+    ):
+        if prefixed_status != 404:
+            return []
+        if unprefixed_status >= 500 or unprefixed_status == 404:
+            return []
+        return [
+            f"Detected API prefix mismatch for {api_path}",
+            f"Enable strip_prefix=true so requests to {api_prefix}/* are forwarded without the prefix",
+        ]
+
+    def analyze_failure(self, error_text):
+        lowered = error_text.lower()
+        if "cors" in lowered:
+            return [
+                "Frontend is calling backend directly",
+                "Use /api/* instead of localhost:PORT"
+            ]
+        if "404" in error_text:
+            if " get / " in lowered or lowered.strip().startswith("get /"):
+                return []
+            if "/api" not in lowered:
+                return ["Route not found"]
+            return [
+                "Route not found",
+                "Check if '/api' prefix is required",
+                "If backend routes are root-based, enable strip_prefix=true",
+            ]
+        if "connection refused" in lowered:
+            return [
+                "Backend not reachable",
+                "Ensure backend is running"
+            ]
+        if "502" in lowered or "unreachable" in lowered:
+            return [
+                "Proxy cannot reach backend",
+                "If using Docker, ensure backend binds to 0.0.0.0 (not 127.0.0.1)",
+                "Check mapped backend port and local firewall rules",
+            ]
+        return []

devlinker-1.4.5/devlinker/doctor.py

@@ -0,0 +1,50 @@
+import click
+from devlinker.detector_ai import DevLinkerAI
+from devlinker.logger import print_fix
+from devlinker.runtime_api import fetch_issues, proxy_base_url
+
+@click.command()
+def doctor():
+    """Run DevLinker diagnostics and print a health dashboard."""
+    try:
+        payload = fetch_issues()
+    except Exception as exc:
+        click.secho(
+            f"Could not reach running DevLinker proxy at {proxy_base_url()} ({exc})",
+            fg="red",
+        )
+        click.secho("Start DevLinker first, then run this command from another terminal.", fg="yellow")
+        return
+
+    issues = payload.get("items", [])
+    categories = payload.get("categories", {})
+    ai = DevLinkerAI()
+    print("\n🩺 DevLinker Health Dashboard\n" + ("═" * 36))
+    # Grouped status summary
+    if not categories:
+        categories = {"general": "OK"}
+    for category, level in categories.items():
+        status = "✅" if level == "OK" else "⚠️"
+        print(f"{category.title():<10}: {status}")
+    print("\nDetails:")
+    if not issues:
+        print("✅ No issues detected yet.")
+    else:
+        for issue in issues:
+            issue_text = issue.get("issue", "Unknown issue")
+            level = str(issue.get("level", "MEDIUM")).upper()
+            count = int(issue.get("count", 1))
+            if level == "HIGH":
+                print(f"❌ {issue_text} (x{count})")
+            elif level == "MEDIUM":
+                print(f"⚠️  {issue_text} (x{count})")
+            else:
+                print(f"💡 {issue_text} (x{count})")
+    print("\nFix Suggestions:")
+    for issue in issues:
+        issue_text = issue.get("issue", "")
+        if not issue_text:
+            continue
+        suggestions = ai.analyze_failure(issue_text)
+        for s in suggestions:
+            print_fix(s)

devlinker-1.4.5/devlinker/fix.py

@@ -0,0 +1,26 @@
+import click
+from devlinker.fixer import DevLinkerFixer
+from devlinker.runtime_api import fetch_issues, proxy_base_url
+
+@click.command()
+def fix():
+    """Apply auto-fixes for detected issues."""
+    try:
+        payload = fetch_issues()
+    except Exception as exc:
+        click.secho(
+            f"Could not reach running DevLinker proxy at {proxy_base_url()} ({exc})",
+            fg="red",
+        )
+        click.secho("Start DevLinker first, then run this command from another terminal.", fg="yellow")
+        return
+
+    issues = payload.get("items", [])
+    fixer = DevLinkerFixer()
+    print("\n🔧 Applying fixes...")
+    results = fixer.apply_fixes(issues)
+    print("\n🔧 Fix Results")
+    for r in results:
+        print(f"✔ {r}")
+    if not results:
+        print("No auto-fixes applied. All clear or manual review needed.")

{devlinker-1.4.4 → devlinker-1.4.5}/devlinker/fixer.py

@@ -1,5 +1,3 @@
-import os
-
 class DevLinkerFixer:
     def apply_fixes(self, issues):
         fixes = []
@@ -12,16 +10,10 @@ class DevLinkerFixer:
         return fixes
 
     def fix_env(self):
-        env_path = os.path.join("frontend", ".env")
-        line = "VITE_API_URL=http://localhost:8001"
-        # Only add if not already present
-        if os.path.exists(env_path):
-            with open(env_path, "r") as f:
-                if line in f.read():
-                    return "VITE_API_URL already set in frontend/.env"
-        with open(env_path, "a") as f:
-            f.write(f"\n{line}\n")
-        return "Added VITE_API_URL to frontend/.env"
+        return (
+            "Runtime injection is active: no .env update needed. "
+            "Use the DevLinker proxy URL and verify API calls go through /api."
+        )
 
     def suggest_api_fix(self):
         return "Suggest: Replace hardcoded http://localhost:8000 with /api in frontend code (manual review)"

devlinker-1.4.5/devlinker/inspect.py

@@ -0,0 +1,25 @@
+import click
+from devlinker.runtime_api import fetch_logs, proxy_base_url
+
+@click.command()
+def inspect():
+    """Show recent API calls and statuses."""
+    click.secho("\n🔍 Recent API Calls (last 50):\n" + ("═" * 36), fg="cyan", bold=True)
+    try:
+        payload = fetch_logs(limit=50)
+    except Exception as exc:
+        click.secho(
+            f"Could not reach running DevLinker proxy at {proxy_base_url()} ({exc})",
+            fg="red",
+        )
+        click.secho("Start DevLinker first, then run this command from another terminal.", fg="yellow")
+        return
+
+    recent_requests = payload.get("items", [])
+    if not recent_requests:
+        click.secho("No API calls recorded yet.", fg="yellow")
+        return
+    for req in recent_requests[-50:]:
+        status = req["status"]
+        emoji = "✅" if status < 400 else ("⚠️" if status < 500 else "❌")
+        click.secho(f"{emoji} {req['target']:<8} {req['path']:<30} → {status}", fg="white")