ticket #138 attempt 1

Reviewed-on: #124

devplacepy/main.py

@@ -12,6 +12,7 @@ from fastapi import FastAPI, Request
 from fastapi.responses import HTMLResponse, RedirectResponse
 from fastapi.staticfiles import StaticFiles
 from fastapi.exceptions import RequestValidationError
+from starlette.middleware.gzip import GZipMiddleware
 from devplacepy.config import (
     STATIC_DIR,
     STATIC_VERSION,
@@ -609,6 +610,10 @@ async def response_timing(request: Request, call_next):
     response.headers["X-Response-Time"] = f"{(time.perf_counter() - start) * 1000:.1f}ms"
     return response
 
+
+app.add_middleware(GZipMiddleware, minimum_size=512, compresslevel=5)
+
+
 _home_cache = TTLCache(ttl=int(os.environ.get("DEVPLACE_HOME_CACHE_TTL", "60")), max_size=4)
 
 

devplacepy/services/jobs/deepsearch/crawl.py

@@ -22,6 +22,8 @@ from .pdf import MAX_PDF_BYTES, extract_pdf_text, is_pdf
 
 logger = logging.getLogger(__name__)
 
+_pw_lock = asyncio.Lock()
+
 RSEARCH_URL = "https://rsearch.app.molodetz.nl"
 RSEARCH_TIMEOUT_SECONDS = 45.0
 FETCH_TIMEOUT_SECONDS = 20.0
@@ -172,13 +174,7 @@ async def _render_with_playwright(
 ) -> tuple[str, str, int, list[tuple[str, str]]]:
     from playwright.async_api import async_playwright
 
-    own_browser = browser is None
+    async def _render(browser) -> tuple[str, str, int, list[tuple[str, str]]]:
-    if own_browser:
-        pw = await async_playwright().__aenter__()
-        browser = await pw.chromium.launch(
-            headless=True, args=["--no-sandbox", "--disable-dev-shm-usage"]
-        )
-    try:
         context = await browser.new_context(user_agent=USER_AGENT)
         page = await context.new_page()
         response = await page.goto(url, wait_until="load", timeout=30000)
@@ -189,10 +185,18 @@ async def _render_with_playwright(
         await context.close()
         extracted = extract_html(content, base_url=url)
         return extracted.title, extracted.text, status, extracted.links
-    finally:
+
-        if own_browser:
+    if browser is None:
-            await browser.close()
+        async with async_playwright() as pw:
-            await pw.__aexit__(None, None, None)
+            browser = await pw.chromium.launch(
+                headless=True, args=["--no-sandbox", "--disable-dev-shm-usage"]
+            )
+            try:
+                return await _render(browser)
+            finally:
+                await browser.close()
+    else:
+        return await _render(browser)
 
 
 async def fetch_page(url: str, depth: int, browser=None) -> CrawledPage | None:
@@ -242,18 +246,20 @@ async def fetch_page(url: str, depth: int, browser=None) -> CrawledPage | None:
         except (LookupError, ValueError) as exc:
             logger.info("deepsearch decode failed for %s: %s", url, exc)
     if len(text) < MIN_PAGE_CHARS:
-        try:
+        async with _pw_lock:
-            r_title, r_text, r_status, r_links = await _render_with_playwright(url, browser)
+            try:
-            if len(r_text) > len(text):
+                r_title, r_text, r_status, r_links = await _render_with_playwright(url, browser)
-                title, text, status, source, links = (
+            except Exception as exc:
-                    r_title or title,
+                logger.info("deepsearch render failed for %s: %s", url, exc)
-                    r_text,
+                r_title, r_text, r_status, r_links = "", "", 0, []
-                    r_status or status,
+        if len(r_text) > len(text):
-                    "playwright",
+            title, text, status, source, links = (
-                    r_links,
+                r_title or title,
-                )
+                r_text,
-        except Exception as exc:
+                r_status or status,
-            logger.info("deepsearch render failed for %s: %s", url, exc)
+                "playwright",
+                r_links,
+            )
     if len(text) < MIN_PAGE_CHARS:
         return None
     return CrawledPage(
@@ -296,102 +302,99 @@ async def crawl(
     total = min(len(level_candidates), max_pages)
     cancelled = False
 
-    pw = None
     browser = None
-    try:
+    async with async_playwright() as pw:
-        pw = await async_playwright().__aenter__()
+        try:
-        browser = await pw.chromium.launch(
+            browser = await pw.chromium.launch(
-            headless=True, args=["--no-sandbox", "--disable-dev-shm-usage"]
+                headless=True, args=["--no-sandbox", "--disable-dev-shm-usage"]
-        )
+            )
-    except Exception as exc:
+        except Exception as exc:
-        logger.warning("deepsearch playwright launch failed, pages will use httpx only: %s", exc)
+            logger.warning("deepsearch playwright launch failed, pages will use httpx only: %s", exc)
 
-    try:
+        try:
-        for level in range(max(1, depth)):
+            for level in range(max(1, depth)):
-            if cancelled or fetched >= max_pages or not level_candidates:
+                if cancelled or fetched >= max_pages or not level_candidates:
-                break
-            next_candidates: list[dict] = []
-            for start in range(0, len(level_candidates), CRAWL_CONCURRENCY):
-                if fetched >= max_pages:
                     break
-                if await should_stop():
+                next_candidates: list[dict] = []
-                    emit({"type": "stage", "stage": "cancelled", "message": "Crawl cancelled"})
+                for start in range(0, len(level_candidates), CRAWL_CONCURRENCY):
-                    cancelled = True
-                    break
-                batch = level_candidates[start : start + CRAWL_CONCURRENCY][: max_pages - fetched]
-                for candidate in batch:
-                    emit(
-                        {
-                            "type": "progress",
-                            "done": fetched,
-                            "total": total,
-                            "url": candidate["url"],
-                            "depth": level,
-                            "message": f"Reading {candidate['url']}",
-                        }
-                    )
-                    if is_cached(candidate["url"]):
-                        emit({"type": "page_cached", "url": candidate["url"], "reason": "seen in a prior run"})
-                fetch_start = time.perf_counter()
-                results = await asyncio.gather(
-                    *(_resolve_candidate(candidate, level, browser) for candidate in batch),
-                    return_exceptions=True,
-                )
-                elapsed_ms = int((time.perf_counter() - fetch_start) * 1000)
-                for candidate, page in zip(batch, results):
-                    url = candidate["url"]
-                    if isinstance(page, BaseException):
-                        logger.info("deepsearch fetch crashed for %s: %s", url, page)
-                        page = None
-                    if page is None:
-                        emit(
-                            {
-                                "type": "page_skipped",
-                                "url": url,
-                                "reason": "no readable content",
-                                "elapsed_ms": elapsed_ms,
-                            }
-                        )
-                        continue
                     if fetched >= max_pages:
                         break
-                    digest = content_hash(page.text)
+                    if await should_stop():
-                    if digest in outcome.seen_hashes:
+                        emit({"type": "stage", "stage": "cancelled", "message": "Crawl cancelled"})
+                        cancelled = True
+                        break
+                    batch = level_candidates[start : start + CRAWL_CONCURRENCY][: max_pages - fetched]
+                    for candidate in batch:
                         emit(
                             {
-                                "type": "page_duplicate",
+                                "type": "progress",
-                                "url": url,
+                                "done": fetched,
-                                "reason": "duplicate content",
+                                "total": total,
-                                "elapsed_ms": elapsed_ms,
+                                "url": candidate["url"],
+                                "depth": level,
+                                "message": f"Reading {candidate['url']}",
                             }
                         )
-                        continue
+                        if is_cached(candidate["url"]):
-                    outcome.seen_hashes.add(digest)
+                            emit({"type": "page_cached", "url": candidate["url"], "reason": "seen in a prior run"})
-                    outcome.pages.append(page)
+                    fetch_start = time.perf_counter()
-                    fetched += 1
+                    results = await asyncio.gather(
-                    emit(
+                        *(_resolve_candidate(candidate, level, browser) for candidate in batch),
-                        {
+                        return_exceptions=True,
-                            "type": "page_loaded",
-                            "url": page.url,
-                            "title": page.title,
-                            "source": page.source,
-                            "depth": level,
-                            "render": page.source == "playwright",
-                            "elapsed_ms": elapsed_ms,
-                            "done": fetched,
-                            "total": total,
-                        }
                     )
-                    if level + 1 < depth:
+                    elapsed_ms = int((time.perf_counter() - fetch_start) * 1000)
-                        for link in relevant_links(page.links, query, LINKS_PER_PAGE):
+                    for candidate, page in zip(batch, results):
-                            if link not in seen_urls:
+                        url = candidate["url"]
-                                seen_urls.add(link)
+                        if isinstance(page, BaseException):
-                                next_candidates.append({"url": link})
+                            logger.info("deepsearch fetch crashed for %s: %s", url, page)
-            level_candidates = next_candidates
+                            page = None
-            total = min(total + len(next_candidates), max_pages)
+                        if page is None:
-    finally:
+                            emit(
-        if browser is not None:
+                                {
-            await browser.close()
+                                    "type": "page_skipped",
-        if pw is not None:
+                                    "url": url,
-            await pw.__aexit__(None, None, None)
+                                    "reason": "no readable content",
+                                    "elapsed_ms": elapsed_ms,
+                                }
+                            )
+                            continue
+                        if fetched >= max_pages:
+                            break
+                        digest = content_hash(page.text)
+                        if digest in outcome.seen_hashes:
+                            emit(
+                                {
+                                    "type": "page_duplicate",
+                                    "url": url,
+                                    "reason": "duplicate content",
+                                    "elapsed_ms": elapsed_ms,
+                                }
+                            )
+                            continue
+                        outcome.seen_hashes.add(digest)
+                        outcome.pages.append(page)
+                        fetched += 1
+                        emit(
+                            {
+                                "type": "page_loaded",
+                                "url": page.url,
+                                "title": page.title,
+                                "source": page.source,
+                                "depth": level,
+                                "render": page.source == "playwright",
+                                "elapsed_ms": elapsed_ms,
+                                "done": fetched,
+                                "total": total,
+                            }
+                        )
+                        if level + 1 < depth:
+                            for link in relevant_links(page.links, query, LINKS_PER_PAGE):
+                                if link not in seen_urls:
+                                    seen_urls.add(link)
+                                    next_candidates.append({"url": link})
+                level_candidates = next_candidates
+                total = min(total + len(next_candidates), max_pages)
+        finally:
+            if browser is not None:
+                await browser.close()
     return outcome

devplacepy/static/css/base.css

@@ -620,6 +620,10 @@ img {
 .topnav-logo span { color: var(--accent); }
 .topnav-links { display: flex; gap: 0.25rem; }
 .topnav-link {
+    display: inline-flex;
+    align-items: center;
+    gap: 0.375rem;
+    white-space: nowrap;
     padding: 0.5rem 0.75rem;
     border-radius: var(--radius);
     font-size: 0.875rem;

devplacepy/templates/docs/architecture-backend.html

@@ -11,7 +11,7 @@ How a request flows through middleware to a router, how the database layer is bu
 
 ## Middleware
 
-Six HTTP middlewares run as a stack around every request, listed outermost first. `response_timing` is the outermost and `refresh_db_snapshot` the innermost. Compression is handled by nginx in production; the Python application does not compress responses itself.
+Seven HTTP middlewares run as a stack around every request, listed outermost first. `response_timing` is the outermost, `refresh_db_snapshot` the innermost, and a `GZipMiddleware` (responses over 512 bytes) wraps the whole stack on top:
 
 | Middleware (outermost first) | Responsibility |
 |------------|----------------|

pyproject.toml

@@ -4,8 +4,7 @@ version = "1.0.0"
 description = "DevPlace - The Developer Social Network"
 requires-python = ">=3.12"
 dependencies = [
-    "fastapi>=0.110.0",
+    "fastapi",
-    "starlette>=0.37.0",
     "uvicorn[standard]",
     "jinja2",
     "python-multipart",