devlinker 1.2.0__tar.gz → 1.2.1__tar.gz

{devlinker-1.2.0 → devlinker-1.2.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: devlinker
-Version: 1.2.0
+Version: 1.2.1
 Summary: AI-powered linking and automation tool
 Author-email: Mani <mani1028@users.noreply.github.com>
 Requires-Python: >=3.7
@@ -20,6 +20,9 @@ Dev Linker runs frontend and backend dev servers, proxies both through a single
 - Auto-detects backend runtime (Docker Compose, Dockerfile, Node, or Python)
 - Auto-starts Python/Node backends; Docker is manual by default for reliability
 - Detects common frontend/backend ports
+- Supports Docker backend port auto-detection
+- Works with dynamic container host ports
+- No config needed for standard Flask/Docker flows
 - Serves both through one proxy at http://localhost:8000
 - Creates a public tunnel for sharing (Cloudflare first, ngrok fallback)
 - Terminal-first workflow
@@ -28,8 +31,8 @@ Dev Linker runs frontend and backend dev servers, proxies both through a single
 ## Project Structure
 
 ```text
-onelink/
-├── onelink/
+devlinker/
+├── devlinker/
 │   ├── __init__.py
 │   ├── main.py
 │   ├── runner.py
@@ -52,7 +55,7 @@ pip install .
 After publishing to PyPI:
 
 ```bash
-pip install dev-linker
+pip install devlinker
 ```
 
 ## Run
@@ -64,8 +67,9 @@ devlinker
 Typical startup output:
 
 ```text
-Dev Linker v1.2.0
+Dev Linker v0.2.0
 
+[INFO] Mode: Auto (Flask + Docker detection)
 [INFO] Booting local services...
 [INFO] Detecting frontend/backend ports...
 [OK] Frontend -> 5173
@@ -76,14 +80,16 @@ Dev Linker v1.2.0
 [OK] Tunnel provider: Cloudflare
 [OK] Public URL:
     https://xxxx.trycloudflare.com
+Tip: Press Ctrl+Click to open link
 
 [INFO] Share this link with collaborators.
 
-Dev Linker Ready
+DevLinker Ready (in 2.4s)
 Frontend: http://localhost:5173
 Backend:  http://localhost:5000
 Proxy:    http://localhost:8000
-Public:   https://xxxx.trycloudflare.com
+PUBLIC URL: https://xxxx.trycloudflare.com
+Tip: Press Ctrl+Click to open link
 ```
 
 Version check:
@@ -98,12 +104,24 @@ Optional overrides:
 devlinker --frontend 5173 --backend 5000
 ```
 
+Backend override alias:
+
+```bash
+devlinker --backend-port 3001
+```
+
 Enable Docker auto-start explicitly:
 
 ```bash
 devlinker --docker
 ```
 
+Run local-only mode without tunnel:
+
+```bash
+devlinker --no-tunnel
+```
+
 If port 8000 is already in use:
 
 ```bash
@@ -112,6 +130,11 @@ devlinker --frontend 5173 --backend 5000 --proxy-port 18000
 
 Default behavior also tries fallback ports automatically when 8000 is busy:
 
+```text
+[WARN] Port 8000 in use
+[INFO] Using proxy port: 8001
+```
+
 - 8001
 - 8002
 - 18000
@@ -128,6 +151,27 @@ Do not hardcode backend host URLs in frontend code.
 
 ## Backend Auto-Detection
 
+Backend port detection runs in this order:
+
+1. Check localhost port 5000
+2. If not found, check Docker port mappings for `->5000/tcp`
+3. Use the mapped host port automatically
+4. If nothing is found, print next-step guidance and exit
+
+Detection messages include source labels, for example:
+
+```text
+[OK] Backend detected (Local) -> port 5000
+```
+
+Example Docker dynamic-port message:
+
+```text
+[WARN] Backend not found on port 5000
+[INFO] Checking Docker containers...
+[OK] Backend detected (Docker) -> port 32768
+```
+
 Dev Linker checks backend runtime in this order:
 
 1. Docker Compose (`backend/docker-compose.yml`, `docker-compose.yaml`, `compose.yml`, or `compose.yaml`)

{devlinker-1.2.0 → devlinker-1.2.1}/README.md

@@ -8,6 +8,9 @@ Dev Linker runs frontend and backend dev servers, proxies both through a single
 - Auto-detects backend runtime (Docker Compose, Dockerfile, Node, or Python)
 - Auto-starts Python/Node backends; Docker is manual by default for reliability
 - Detects common frontend/backend ports
+- Supports Docker backend port auto-detection
+- Works with dynamic container host ports
+- No config needed for standard Flask/Docker flows
 - Serves both through one proxy at http://localhost:8000
 - Creates a public tunnel for sharing (Cloudflare first, ngrok fallback)
 - Terminal-first workflow
@@ -16,8 +19,8 @@ Dev Linker runs frontend and backend dev servers, proxies both through a single
 ## Project Structure
 
 ```text
-onelink/
-├── onelink/
+devlinker/
+├── devlinker/
 │   ├── __init__.py
 │   ├── main.py
 │   ├── runner.py
@@ -40,7 +43,7 @@ pip install .
 After publishing to PyPI:
 
 ```bash
-pip install dev-linker
+pip install devlinker
 ```
 
 ## Run
@@ -52,8 +55,9 @@ devlinker
 Typical startup output:
 
 ```text
-Dev Linker v1.2.0
+Dev Linker v0.2.0
 
+[INFO] Mode: Auto (Flask + Docker detection)
 [INFO] Booting local services...
 [INFO] Detecting frontend/backend ports...
 [OK] Frontend -> 5173
@@ -64,14 +68,16 @@ Dev Linker v1.2.0
 [OK] Tunnel provider: Cloudflare
 [OK] Public URL:
     https://xxxx.trycloudflare.com
+Tip: Press Ctrl+Click to open link
 
 [INFO] Share this link with collaborators.
 
-Dev Linker Ready
+DevLinker Ready (in 2.4s)
 Frontend: http://localhost:5173
 Backend:  http://localhost:5000
 Proxy:    http://localhost:8000
-Public:   https://xxxx.trycloudflare.com
+PUBLIC URL: https://xxxx.trycloudflare.com
+Tip: Press Ctrl+Click to open link
 ```
 
 Version check:
@@ -86,12 +92,24 @@ Optional overrides:
 devlinker --frontend 5173 --backend 5000
 ```
 
+Backend override alias:
+
+```bash
+devlinker --backend-port 3001
+```
+
 Enable Docker auto-start explicitly:
 
 ```bash
 devlinker --docker
 ```
 
+Run local-only mode without tunnel:
+
+```bash
+devlinker --no-tunnel
+```
+
 If port 8000 is already in use:
 
 ```bash
@@ -100,6 +118,11 @@ devlinker --frontend 5173 --backend 5000 --proxy-port 18000
 
 Default behavior also tries fallback ports automatically when 8000 is busy:
 
+```text
+[WARN] Port 8000 in use
+[INFO] Using proxy port: 8001
+```
+
 - 8001
 - 8002
 - 18000
@@ -116,6 +139,27 @@ Do not hardcode backend host URLs in frontend code.
 
 ## Backend Auto-Detection
 
+Backend port detection runs in this order:
+
+1. Check localhost port 5000
+2. If not found, check Docker port mappings for `->5000/tcp`
+3. Use the mapped host port automatically
+4. If nothing is found, print next-step guidance and exit
+
+Detection messages include source labels, for example:
+
+```text
+[OK] Backend detected (Local) -> port 5000
+```
+
+Example Docker dynamic-port message:
+
+```text
+[WARN] Backend not found on port 5000
+[INFO] Checking Docker containers...
+[OK] Backend detected (Docker) -> port 32768
+```
+
 Dev Linker checks backend runtime in this order:
 
 1. Docker Compose (`backend/docker-compose.yml`, `docker-compose.yaml`, `compose.yml`, or `compose.yaml`)

devlinker-1.2.1/devlinker/__init__.py

@@ -0,0 +1,16 @@
+"""Dev Linker package."""
+
+try:
+    from importlib.metadata import version
+
+    __version__ = version("devlinker")
+except Exception:
+    __version__ = "0.0.0"
+
+__all__ = [
+    "main",
+    "runner",
+    "detector",
+    "proxy",
+    "tunnel",
+]

{devlinker-1.2.0 → devlinker-1.2.1}/devlinker/main.py

@@ -9,7 +9,7 @@ import click
 from . import __version__
 from .detector import check_port, detect_ports, is_vite_port
 from .proxy import start_proxy
-from .runner import start_servers
+from .runner import detect_backend_port, start_servers
 from .tunnel import start_tunnel
 
 
@@ -30,7 +30,8 @@ def _select_proxy_port(requested_port: int) -> int:
 
     for candidate in (8001, 8002, 18000):
         if not _is_port_in_use(candidate):
-            print(f"Port 8000 is busy. Falling back to proxy port {candidate}.")
+            print("[WARN] Port 8000 in use")
+            print(f"[INFO] Using proxy port: {candidate}")
             return candidate
 
     raise click.ClickException(
@@ -54,13 +55,15 @@ def _print_summary(
     backend_port: int,
     proxy_port: int,
     public_url: str | None,
+    startup_seconds: float,
 ) -> None:
-    print("\nDev Linker Ready")
+    print(f"\nDevLinker Ready (in {startup_seconds:.1f}s)")
     print(f"Frontend: http://localhost:{frontend_port}")
     print(f"Backend:  http://localhost:{backend_port}")
     print(f"Proxy:    http://localhost:{proxy_port}")
     if public_url:
-        print(f"Public:   {public_url}")
+        print(f"PUBLIC URL: {public_url}")
+        print("Tip: Press Ctrl+Click to open link")
     else:
         print("Public:   unavailable (local proxy still active)")
 
@@ -68,7 +71,14 @@ def _print_summary(
 @click.command()
 @click.version_option(version=__version__, prog_name="devlinker")
 @click.option("--frontend", type=int, default=None, help="Override detected frontend port.")
-@click.option("--backend", type=int, default=None, help="Override detected backend port.")
+@click.option(
+    "--backend",
+    "--backend-port",
+    "backend_port_override",
+    type=int,
+    default=None,
+    help="Override detected backend port.",
+)
 @click.option("--proxy-port", type=int, default=8000, show_default=True, help="Proxy listen port.")
 @click.option(
     "--docker",
@@ -76,19 +86,33 @@ def _print_summary(
     is_flag=True,
     help="Auto-start Docker backends (manual Docker is the default).",
 )
+@click.option("--no-tunnel", is_flag=True, help="Skip public tunnel and run local proxy only.")
+@click.option("--debug", is_flag=True, hidden=True, help="Enable debug logging.")
 def cli(
     frontend: int | None,
-    backend: int | None,
+    backend_port_override: int | None,
     proxy_port: int,
     auto_start_docker: bool,
+    no_tunnel: bool,
+    debug: bool,
 ) -> None:
+    started = time.perf_counter()
     print(f"\nDev Linker v{__version__}")
+    print("[INFO] Mode: Auto (Flask + Docker detection)")
     print("[INFO] Booting local services...")
 
     start_servers(auto_start_docker=auto_start_docker)
 
+    backend_port = detect_backend_port(
+        default_port=5000,
+        override_port=backend_port_override,
+        debug=debug,
+    )
+    if backend_port is None:
+        raise SystemExit(1)
+
     print("[INFO] Detecting frontend/backend ports...")
-    frontend_port, backend_port = detect_ports(frontend=frontend, backend=backend)
+    frontend_port, backend_port = detect_ports(frontend=frontend, backend=backend_port)
 
     if frontend_port is None:
         raise click.ClickException(
@@ -123,22 +147,32 @@ def cli(
 
     print(f"\n[OK] Proxy ready at http://localhost:{proxy_port}\n")
     warning_free_url: str | None = None
-    try:
-        print("[INFO] Opening public tunnel...")
-        provider, public_url = start_tunnel(proxy_port)
-        warning_free_url = _with_ngrok_skip_warning(public_url)
-        provider_label = "Cloudflare" if provider == "cloudflare" else "ngrok"
-        print(f"[OK] Tunnel provider: {provider_label}")
-        print("[OK] Public URL:")
-        print(f"     {warning_free_url}\n")
-        print("[INFO] Share this link with collaborators.")
-    except RuntimeError as exc:
-        print(f"[WARN] Tunnel failed: {exc}")
-        print("[INFO] Next step: install cloudflared or configure ngrok auth.")
-        print("[INFO] Tip: run 'ngrok config add-authtoken <token>' for ngrok fallback.")
-        print(f"[OK] Continuing with local proxy at http://localhost:{proxy_port}")
-
-    _print_summary(frontend_port, backend_port, proxy_port, warning_free_url)
+    if no_tunnel:
+        print("[INFO] Tunnel disabled by --no-tunnel; local proxy only.")
+    else:
+        try:
+            print("[INFO] Opening public tunnel...")
+            provider, public_url = start_tunnel(proxy_port)
+            warning_free_url = _with_ngrok_skip_warning(public_url)
+            provider_label = "Cloudflare" if provider == "cloudflare" else "ngrok"
+            print(f"[OK] Tunnel provider: {provider_label}")
+            print("[OK] Public URL:")
+            print(f"     {warning_free_url}\n")
+            print("Tip: Press Ctrl+Click to open link")
+            print("[INFO] Share this link with collaborators.")
+        except RuntimeError as exc:
+            print(f"[WARN] Tunnel failed: {exc}")
+            print("[INFO] Next step: install cloudflared or configure ngrok auth.")
+            print("[INFO] Tip: run 'ngrok config add-authtoken <token>' for ngrok fallback.")
+            print(f"[OK] Continuing with local proxy at http://localhost:{proxy_port}")
+
+    _print_summary(
+        frontend_port,
+        backend_port,
+        proxy_port,
+        warning_free_url,
+        startup_seconds=time.perf_counter() - started,
+    )
 
     try:
         while True:

{devlinker-1.2.0 → devlinker-1.2.1}/devlinker/runner.py

@@ -2,9 +2,12 @@ from __future__ import annotations
 
 import json
 import os
+import re
 import shutil
+import socket
 import subprocess
 import sys
+import time
 from pathlib import Path
 from typing import List
 
@@ -22,6 +25,130 @@ def _log(level: str, message: str) -> None:
     print(f"{prefix} {message}")
 
 
+def _debug_log(enabled: bool, message: str) -> None:
+    if enabled:
+        print(f"[DEBUG] {message}")
+
+
+def is_port_open(port: int) -> bool:
+    with socket.socket(socket.AF_INET, socket.SOCK_STREAM) as sock:
+        sock.settimeout(1)
+        return sock.connect_ex(("localhost", port)) == 0
+
+
+def _extract_host_port(ports_text: str, container_port: int) -> int | None:
+    # Covers typical Docker mappings: 0.0.0.0:32768->5000/tcp, [::]:32768->5000/tcp
+    pattern = rf"(?:0\.0\.0\.0|127\.0\.0\.1|\[::\]|::):(\d+)->{container_port}/tcp"
+    match = re.search(pattern, ports_text)
+    if match:
+        return int(match.group(1))
+    return None
+
+
+def get_docker_backend_port(
+    default_container_port: int = 5000,
+    debug: bool = False,
+) -> tuple[int, str, int] | None:
+    try:
+        output = subprocess.check_output(  # noqa: S603
+            ["docker", "ps", "--format", "{{.Names}}\t{{.Ports}}"],
+            stderr=subprocess.DEVNULL,
+        ).decode("utf-8", errors="ignore")
+    except Exception:
+        return None
+
+    _debug_log(debug, "docker ps port map output:")
+    if debug:
+        for raw_line in output.splitlines():
+            _debug_log(True, raw_line)
+
+    candidates: list[tuple[str, int]] = []
+    for line in output.splitlines():
+        stripped = line.strip()
+        if not stripped:
+            continue
+
+        if "\t" in stripped:
+            name, ports = stripped.split("\t", 1)
+        else:
+            parts = stripped.split(maxsplit=1)
+            if len(parts) != 2:
+                continue
+            name, ports = parts[0], parts[1]
+
+        host_port = _extract_host_port(ports, default_container_port)
+        if host_port is not None:
+            candidates.append((name, host_port))
+
+    if not candidates:
+        return None
+
+    # Prefer container names that look like backend services.
+    for name, port in candidates:
+        if "backend" in name.lower():
+            _debug_log(debug, f"Selected Docker backend container '{name}' on host port {port}")
+            return port, name, len(candidates)
+
+    # docker ps is already newest-first; fallback to first match.
+    name, port = candidates[0]
+    _debug_log(debug, f"Selected first Docker match '{name}' on host port {port}")
+    return port, name, len(candidates)
+
+
+def _wait_for_port(port: int, retries: int = 5, delay_seconds: float = 1.0, debug: bool = False) -> bool:
+    for attempt in range(1, retries + 1):
+        if is_port_open(port):
+            return True
+        _debug_log(debug, f"Port {port} not open yet (attempt {attempt}/{retries})")
+        time.sleep(delay_seconds)
+    return False
+
+
+def detect_backend_port(
+    default_port: int = 5000,
+    override_port: int | None = None,
+    debug: bool = False,
+) -> int | None:
+    started = time.perf_counter()
+
+    if override_port is not None:
+        _log("info", f"Using backend port override: {override_port}")
+        _log("info", f"Backend detected in {time.perf_counter() - started:.1f}s")
+        return override_port
+
+    _log("info", "Checking backend...")
+    _debug_log(debug, f"Scanned local port: {default_port}")
+    if is_port_open(default_port):
+        _log("ok", f"Backend detected (Local) -> port {default_port}")
+        _log("info", f"Backend detected in {time.perf_counter() - started:.1f}s")
+        return default_port
+
+    _log("warn", f"Backend not found on port {default_port}")
+    _log("info", "Checking Docker containers...")
+    _debug_log(debug, f"Scanned Docker container target port: {default_port}")
+
+    docker_match = get_docker_backend_port(default_container_port=default_port, debug=debug)
+    if docker_match is not None:
+        docker_port, container_name, match_count = docker_match
+        if match_count > 1:
+            _log("warn", "Multiple backend containers found")
+            _log("info", f"Using: {container_name}")
+        if _wait_for_port(docker_port, retries=5, delay_seconds=1.0, debug=debug):
+            _log("ok", f"Backend detected (Docker) -> port {docker_port}")
+            _log("info", f"Backend detected in {time.perf_counter() - started:.1f}s")
+            return docker_port
+        _log("warn", f"Docker mapped port {docker_port} found but backend is not ready yet")
+
+    _log("error", "Backend not detected")
+    print("Checked:")
+    print(f"- localhost:{default_port}")
+    print("- Docker containers")
+    print("Next step:")
+    print("  - Start Flask: python app.py")
+    print("  - OR expose Docker port: -p 5000:5000")
+    return None
+
+
 def _detect_backend_mode(backend_path: Path) -> str | None:
     compose_files = (
         "docker-compose.yml",

{devlinker-1.2.0 → devlinker-1.2.1}/devlinker.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: devlinker
-Version: 1.2.0
+Version: 1.2.1
 Summary: AI-powered linking and automation tool
 Author-email: Mani <mani1028@users.noreply.github.com>
 Requires-Python: >=3.7
@@ -20,6 +20,9 @@ Dev Linker runs frontend and backend dev servers, proxies both through a single
 - Auto-detects backend runtime (Docker Compose, Dockerfile, Node, or Python)
 - Auto-starts Python/Node backends; Docker is manual by default for reliability
 - Detects common frontend/backend ports
+- Supports Docker backend port auto-detection
+- Works with dynamic container host ports
+- No config needed for standard Flask/Docker flows
 - Serves both through one proxy at http://localhost:8000
 - Creates a public tunnel for sharing (Cloudflare first, ngrok fallback)
 - Terminal-first workflow
@@ -28,8 +31,8 @@ Dev Linker runs frontend and backend dev servers, proxies both through a single
 ## Project Structure
 
 ```text
-onelink/
-├── onelink/
+devlinker/
+├── devlinker/
 │   ├── __init__.py
 │   ├── main.py
 │   ├── runner.py
@@ -52,7 +55,7 @@ pip install .
 After publishing to PyPI:
 
 ```bash
-pip install dev-linker
+pip install devlinker
 ```
 
 ## Run
@@ -64,8 +67,9 @@ devlinker
 Typical startup output:
 
 ```text
-Dev Linker v1.2.0
+Dev Linker v0.2.0
 
+[INFO] Mode: Auto (Flask + Docker detection)
 [INFO] Booting local services...
 [INFO] Detecting frontend/backend ports...
 [OK] Frontend -> 5173
@@ -76,14 +80,16 @@ Dev Linker v1.2.0
 [OK] Tunnel provider: Cloudflare
 [OK] Public URL:
     https://xxxx.trycloudflare.com
+Tip: Press Ctrl+Click to open link
 
 [INFO] Share this link with collaborators.
 
-Dev Linker Ready
+DevLinker Ready (in 2.4s)
 Frontend: http://localhost:5173
 Backend:  http://localhost:5000
 Proxy:    http://localhost:8000
-Public:   https://xxxx.trycloudflare.com
+PUBLIC URL: https://xxxx.trycloudflare.com
+Tip: Press Ctrl+Click to open link
 ```
 
 Version check:
@@ -98,12 +104,24 @@ Optional overrides:
 devlinker --frontend 5173 --backend 5000
 ```
 
+Backend override alias:
+
+```bash
+devlinker --backend-port 3001
+```
+
 Enable Docker auto-start explicitly:
 
 ```bash
 devlinker --docker
 ```
 
+Run local-only mode without tunnel:
+
+```bash
+devlinker --no-tunnel
+```
+
 If port 8000 is already in use:
 
 ```bash
@@ -112,6 +130,11 @@ devlinker --frontend 5173 --backend 5000 --proxy-port 18000
 
 Default behavior also tries fallback ports automatically when 8000 is busy:
 
+```text
+[WARN] Port 8000 in use
+[INFO] Using proxy port: 8001
+```
+
 - 8001
 - 8002
 - 18000
@@ -128,6 +151,27 @@ Do not hardcode backend host URLs in frontend code.
 
 ## Backend Auto-Detection
 
+Backend port detection runs in this order:
+
+1. Check localhost port 5000
+2. If not found, check Docker port mappings for `->5000/tcp`
+3. Use the mapped host port automatically
+4. If nothing is found, print next-step guidance and exit
+
+Detection messages include source labels, for example:
+
+```text
+[OK] Backend detected (Local) -> port 5000
+```
+
+Example Docker dynamic-port message:
+
+```text
+[WARN] Backend not found on port 5000
+[INFO] Checking Docker containers...
+[OK] Backend detected (Docker) -> port 32768
+```
+
 Dev Linker checks backend runtime in this order:
 
 1. Docker Compose (`backend/docker-compose.yml`, `docker-compose.yaml`, `compose.yml`, or `compose.yaml`)

{devlinker-1.2.0 → devlinker-1.2.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "devlinker"
-version = "1.2.0"
+version = "1.2.1"
 description = "AI-powered linking and automation tool"
 authors = [
     { name = "Mani", email = "mani1028@users.noreply.github.com" }

devlinker-1.2.0/devlinker/__init__.py

@@ -1,11 +0,0 @@
-"""Dev Linker package."""
-
-__version__ = "1.2.0"
-
-__all__ = [
-    "main",
-    "runner",
-    "detector",
-    "proxy",
-    "tunnel",
-]