fastapi-radar 0.1.8__tar.gz → 0.2.0__tar.gz

{fastapi_radar-0.1.8/fastapi_radar.egg-info → fastapi_radar-0.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fastapi-radar
-Version: 0.1.8
+Version: 0.2.0
 Summary: A debugging dashboard for FastAPI applications with real-time monitoring
 Home-page: https://github.com/doganarif/fastapi-radar
 Author: Arif Dogan
@@ -29,6 +29,7 @@ Requires-Dist: pydantic
 Requires-Dist: starlette
 Requires-Dist: duckdb==1.1.3
 Requires-Dist: duckdb-engine==0.17.0
+Requires-Dist: aiosqlite>=0.21.0
 Provides-Extra: dev
 Requires-Dist: pytest; extra == "dev"
 Requires-Dist: pytest-asyncio; extra == "dev"
@@ -163,6 +164,23 @@ radar = Radar(app, db_path="./data")
 
 If the specified path cannot be created, FastAPI Radar will fallback to using the current directory with a warning.
 
+### Development Mode with Auto-Reload
+
+When running your FastAPI application with `fastapi dev` (which uses auto-reload), FastAPI Radar automatically switches to an in-memory database to avoid file locking issues. This means:
+
+- **No file locking errors** - The dashboard will work seamlessly in development
+- **Data doesn't persist between reloads** - Each reload starts with a fresh database
+- **Production behavior unchanged** - When using `fastapi run` or deploying, the normal file-based database is used
+
+```python
+# With fastapi dev (auto-reload enabled):
+# Automatically uses in-memory database - no configuration needed!
+radar = Radar(app)
+radar.create_tables()  # Safe to call - handles multiple processes gracefully
+```
+
+This behavior only applies when using the development server with auto-reload (`fastapi dev`). In production or when using `fastapi run`, the standard file-based DuckDB storage is used.
+
 ## What Gets Captured?
 
 - ✅ HTTP requests and responses

{fastapi_radar-0.1.8 → fastapi_radar-0.2.0}/README.md

@@ -118,6 +118,23 @@ radar = Radar(app, db_path="./data")
 
 If the specified path cannot be created, FastAPI Radar will fallback to using the current directory with a warning.
 
+### Development Mode with Auto-Reload
+
+When running your FastAPI application with `fastapi dev` (which uses auto-reload), FastAPI Radar automatically switches to an in-memory database to avoid file locking issues. This means:
+
+- **No file locking errors** - The dashboard will work seamlessly in development
+- **Data doesn't persist between reloads** - Each reload starts with a fresh database
+- **Production behavior unchanged** - When using `fastapi run` or deploying, the normal file-based database is used
+
+```python
+# With fastapi dev (auto-reload enabled):
+# Automatically uses in-memory database - no configuration needed!
+radar = Radar(app)
+radar.create_tables()  # Safe to call - handles multiple processes gracefully
+```
+
+This behavior only applies when using the development server with auto-reload (`fastapi dev`). In production or when using `fastapi run`, the standard file-based DuckDB storage is used.
+
 ## What Gets Captured?
 
 - ✅ HTTP requests and responses

{fastapi_radar-0.1.8 → fastapi_radar-0.2.0}/fastapi_radar/__init__.py

@@ -2,5 +2,5 @@
 
 from .radar import Radar
 
-__version__ = "0.1.8"
+__version__ = "0.2.0"
 __all__ = ["Radar"]

{fastapi_radar-0.1.8 → fastapi_radar-0.2.0}/fastapi_radar/api.py

@@ -1,6 +1,6 @@
 """API endpoints for FastAPI Radar dashboard."""
 
-from datetime import datetime, timedelta
+from datetime import datetime, timedelta, timezone
 from typing import Any, Dict, List, Optional, Union
 
 from fastapi import APIRouter, Depends, HTTPException, Query
@@ -302,7 +302,7 @@ def create_api_router(get_session_context) -> APIRouter:
         slow_threshold: int = Query(100),
         session: Session = Depends(get_db),
     ):
-        since = datetime.utcnow() - timedelta(hours=hours)
+        since = datetime.now(timezone.utc) - timedelta(hours=hours)
 
         requests = (
             session.query(CapturedRequest)
@@ -359,7 +359,7 @@ def create_api_router(get_session_context) -> APIRouter:
         older_than_hours: Optional[int] = None, session: Session = Depends(get_db)
     ):
         if older_than_hours:
-            cutoff = datetime.utcnow() - timedelta(hours=older_than_hours)
+            cutoff = datetime.now(timezone.utc) - timedelta(hours=older_than_hours)
             session.query(CapturedRequest).filter(
                 CapturedRequest.created_at < cutoff
             ).delete()
@@ -382,7 +382,7 @@ def create_api_router(get_session_context) -> APIRouter:
         session: Session = Depends(get_db),
     ):
         """List traces."""
-        since = datetime.utcnow() - timedelta(hours=hours)
+        since = datetime.now(timezone.utc) - timedelta(hours=hours)
         query = session.query(Trace).filter(Trace.created_at >= since)
 
         if status:

{fastapi_radar-0.1.8 → fastapi_radar-0.2.0}/fastapi_radar/capture.py

@@ -1,13 +1,18 @@
 """SQLAlchemy query capture for FastAPI Radar."""
 
 import time
-from typing import Any, Callable, Dict, List, Union
-
+from typing import Any, Callable, Dict, List, Optional, Union
 from sqlalchemy import event
 from sqlalchemy.engine import Engine
 
+try:  # SQLAlchemy async support is optional
+    from sqlalchemy.ext.asyncio import AsyncEngine
+except Exception:  # pragma: no cover - module might not exist in older SQLAlchemy
+    AsyncEngine = None  # type: ignore[assignment]
 from .middleware import request_context
 from .models import CapturedQuery
+
+
 from .utils import format_sql
 from .tracing import get_current_trace_context
 
@@ -23,14 +28,20 @@ class QueryCapture:
         self.capture_bindings = capture_bindings
         self.slow_query_threshold = slow_query_threshold
         self._query_start_times = {}
+        self._registered_engines: Dict[int, Engine] = {}
 
     def register(self, engine: Engine) -> None:
-        event.listen(engine, "before_cursor_execute", self._before_cursor_execute)
-        event.listen(engine, "after_cursor_execute", self._after_cursor_execute)
+        sync_engine = self._resolve_engine(engine)
+        event.listen(sync_engine, "before_cursor_execute", self._before_cursor_execute)
+        event.listen(sync_engine, "after_cursor_execute", self._after_cursor_execute)
+        self._registered_engines[id(engine)] = sync_engine
 
     def unregister(self, engine: Engine) -> None:
-        event.remove(engine, "before_cursor_execute", self._before_cursor_execute)
-        event.remove(engine, "after_cursor_execute", self._after_cursor_execute)
+        sync_engine = self._registered_engines.pop(id(engine), None)
+        if not sync_engine:
+            sync_engine = self._resolve_engine(engine)
+        event.remove(sync_engine, "before_cursor_execute", self._before_cursor_execute)
+        event.remove(sync_engine, "after_cursor_execute", self._after_cursor_execute)
 
     def _before_cursor_execute(
         self,
@@ -44,14 +55,14 @@ class QueryCapture:
         request_id = request_context.get()
         if not request_id:
             return
-
         context_id = id(context)
         self._query_start_times[context_id] = time.time()
-
+        setattr(context, "_radar_request_id", request_id)
         trace_ctx = get_current_trace_context()
         if trace_ctx:
             formatted_sql = format_sql(statement)
             operation_type = self._get_operation_type(statement)
+            db_tags = self._get_db_tags(conn)
             span_id = trace_ctx.create_span(
                 operation_name=f"DB {operation_type}",
                 span_kind="client",
@@ -59,6 +70,7 @@ class QueryCapture:
                     "db.statement": formatted_sql[:500],  # limit SQL length
                     "db.operation_type": operation_type,
                     "component": "database",
+                    **db_tags,
                 },
             )
             setattr(context, "_radar_span_id", span_id)
@@ -74,8 +86,9 @@ class QueryCapture:
     ) -> None:
         request_id = request_context.get()
         if not request_id:
-            return
-
+            request_id = getattr(context, "_radar_request_id", None)
+            if not request_id:
+                return
         start_time = self._query_start_times.pop(id(context), None)
         if start_time is None:
             return
@@ -160,3 +173,18 @@ class QueryCapture:
             return {k: str(v) for k, v in list(parameters.items())[:100]}
 
         return [str(parameters)]
+
+    def _resolve_engine(self, engine: Engine) -> Engine:
+        if AsyncEngine is not None and isinstance(engine, AsyncEngine):
+            return engine.sync_engine
+        return engine
+
+    def _get_db_tags(self, conn: Any) -> Dict[str, Optional[str]]:
+        tags: Dict[str, Optional[str]] = {}
+        engine = getattr(conn, "engine", None)
+        if engine and getattr(engine, "dialect", None):
+            tags["db.system"] = engine.dialect.name
+            url = getattr(engine, "url", None)
+            if url is not None:
+                tags["db.name"] = getattr(url, "database", None)
+        return tags