devinspector 2.0.0__tar.gz

devinspector-2.0.0/PKG-INFO

@@ -0,0 +1,15 @@
+Metadata-Version: 2.4
+Name: devinspector
+Version: 2.0.0
+Summary: SDK Python de monitoramento e auditoria em tempo real | DevInspector
+Author-email: DevInspector <suporte@devinspector.com.br>
+License: MIT
+Project-URL: Homepage, https://devinspector.com.br
+Keywords: monitoring,error-tracking,audit,devinspector,fastapi,flask
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Provides-Extra: fastapi
+Requires-Dist: fastapi; extra == "fastapi"
+Requires-Dist: starlette; extra == "fastapi"
+Provides-Extra: flask
+Requires-Dist: flask; extra == "flask"

devinspector-2.0.0/devinspector/__init__.py

@@ -0,0 +1,3 @@
+from .core import AuditCore, audit
+
+__all__ = ["audit", "AuditCore"]

devinspector-2.0.0/devinspector/core.py

@@ -0,0 +1,208 @@
+import sys
+import json
+import time
+import queue
+import threading
+import traceback
+import urllib.request
+from datetime import datetime, timezone
+from typing import Any, Dict, Optional
+
+
+class AuditCore:
+    def __init__(self):
+        self.api_key: str = "PENDING_API_KEY"
+        self.endpoint: str = "https://api.devinspector.com.br/api/ingest/track"
+        self.environment: str = "production"
+        self.initialized: bool = False
+        self._listeners_attached: bool = False
+
+        # Fila e thread em background para envio assíncrono
+        self._queue: queue.Queue = queue.Queue(maxsize=10000)
+        self._shutdown_event = threading.Event()
+        self._worker_thread = threading.Thread(target=self._worker, daemon=True)
+        self._worker_thread.start()
+
+    def init(
+        self,
+        api_key: str,
+        endpoint: Optional[str] = None,
+        environment: Optional[str] = None,
+    ) -> None:
+        if not api_key:
+            print("[AuditSDK] API Key não fornecida no init().")
+            return
+
+        self.api_key = api_key
+        if endpoint:
+            self.endpoint = endpoint
+        if environment:
+            self.environment = environment
+
+        self.initialized = True
+        self._listen_global_errors()
+
+    def capture_request(
+        self,
+        method: str,
+        url: str,
+        status_code: int,
+        duration_ms: float,
+        user_agent: str = "",
+    ) -> None:
+        payload = {
+            "type": "request_metric",
+            "method": method,
+            "url": url,
+            "statusCode": status_code,
+            "durationMs": round(duration_ms, 2),
+            "browser": user_agent,
+            "metadata": {
+                "environment": self.environment,
+                "timestamp": datetime.now(timezone.utc).isoformat(),
+            },
+        }
+        self._enqueue(payload)
+
+    def capture_error(
+        self, error: Exception, metadata: Optional[Dict[str, Any]] = None
+    ) -> None:
+        raw_message = str(error) or "Erro Desconhecido"
+        raw_stack = "".join(traceback.format_tb(error.__traceback__))
+
+        meta = metadata.copy() if metadata else {}
+        meta.update(
+            {
+                "environment": self.environment,
+                "timestamp": datetime.now(timezone.utc).isoformat(),
+            }
+        )
+
+        payload = {
+            "type": "error",
+            "message": self._truncate(raw_message, 500),
+            "stackTrace": self._truncate(raw_stack, 10000),
+            "url": "",
+            "browser": f"Python/{sys.version.split()[0]}",
+            "metadata": self._truncate(meta, 5000),
+        }
+        self._enqueue(payload)
+
+    def capture_exception(
+        self, error: Exception, metadata: Optional[Dict[str, Any]] = None
+    ) -> None:
+        self.capture_error(error, metadata)
+
+    def capture_message(
+        self, message: str, metadata: Optional[Dict[str, Any]] = None
+    ) -> None:
+        meta = metadata.copy() if metadata else {}
+        meta.update(
+            {
+                "level": "info",
+                "environment": self.environment,
+                "timestamp": datetime.now(timezone.utc).isoformat(),
+            }
+        )
+
+        payload = {
+            "type": "message",
+            "message": self._truncate(message, 500),
+            "stackTrace": "",
+            "url": "",
+            "browser": f"Python/{sys.version.split()[0]}",
+            "metadata": self._truncate(meta, 5000),
+        }
+        self._enqueue(payload)
+
+    def _listen_global_errors(self) -> None:
+        if self._listeners_attached:
+            return
+        self._listeners_attached = True
+
+        original_excepthook = sys.excepthook
+
+        def custom_excepthook(exc_type, exc_value, exc_traceback):
+            if issubclass(exc_type, KeyboardInterrupt):
+                original_excepthook(exc_type, exc_value, exc_traceback)
+                return
+
+            self.capture_error(
+                exc_value,
+                metadata={"type": "uncaught_exception", "exc_type": exc_type.__name__},
+            )
+            original_excepthook(exc_type, exc_value, exc_traceback)
+
+        sys.excepthook = custom_excepthook
+
+        # Captura exceções em Threads secundárias (Python 3.8+)
+        if hasattr(threading, "excepthook"):
+
+            def custom_thread_excepthook(args):
+                self.capture_error(
+                    args.exc_value,
+                    metadata={
+                        "type": "uncaught_thread_exception",
+                        "thread": args.thread.name,
+                    },
+                )
+
+            threading.excepthook = custom_thread_excepthook
+
+    def _truncate(self, value: Any, max_length: int = 5000) -> Any:
+        if isinstance(value, str):
+            return (
+                value[:max_length] + "... [truncated]"
+                if len(value) > max_length
+                else value
+            )
+
+        if isinstance(value, dict):
+            return {
+                str(k): self._truncate(v, max_length) for k, v in value.items()
+            }
+
+        return value
+
+    def _enqueue(self, payload: dict) -> None:
+        try:
+            self._queue.put_nowait(payload)
+        except queue.Full:
+            pass
+
+    def _worker(self) -> None:
+        while not self._shutdown_event.is_set():
+            try:
+                payload = self._queue.get(timeout=0.5)
+                self._send(payload)
+                self._queue.task_done()
+            except queue.Empty:
+                continue
+
+    def _send(self, payload: dict) -> None:
+        active_key = (
+            self.api_key
+            if self.api_key and self.api_key != "PENDING_API_KEY"
+            else "dev-fallback-key"
+        )
+        data_bytes = json.dumps(payload).encode("utf-8")
+
+        req = urllib.request.Request(
+            self.endpoint,
+            data=data_bytes,
+            headers={
+                "Content-Type": "application/json",
+                "x-api-key": active_key,
+            },
+            method="POST",
+        )
+
+        try:
+            with urllib.request.urlopen(req, timeout=5):
+                pass
+        except Exception as err:
+            print(f"[DevInspector] Falha ao enviar requisição para o painel: {err}")
+
+
+# Singleton Global
+audit = AuditCore()

devinspector-2.0.0/devinspector/fastapi.py

@@ -0,0 +1,35 @@
+import time
+from starlette.middleware.base import BaseHTTPMiddleware
+from starlette.requests import Request
+from .core import audit
+
+
+class DevInspectorMiddleware(BaseHTTPMiddleware):
+    async def dispatch(self, request: Request, call_next):
+        start_time = time.perf_counter()
+        status_code = 500
+
+        try:
+            response = await call_next(request)
+            status_code = response.status_code
+            return response
+        except Exception as exc:
+            audit.capture_error(
+                exc,
+                metadata={
+                    "path": request.url.path,
+                    "method": request.method,
+                },
+            )
+            raise exc
+        finally:
+            duration_ms = (time.perf_counter() - start_time) * 1000
+            user_agent = request.headers.get("user-agent", "")
+
+            audit.capture_request(
+                method=request.method,
+                url=str(request.url),
+                status_code=status_code,
+                duration_ms=duration_ms,
+                user_agent=user_agent,
+            )

devinspector-2.0.0/devinspector/flask.py

@@ -0,0 +1,51 @@
+import time
+from flask import Flask, g, request
+from .core import audit
+
+
+class DevInspectorFlask:
+    def __init__(self, app: Flask = None):
+        if app is not None:
+            self.init_app(app)
+
+    def init_app(self, app: Flask):
+        app.before_request(self._before_request)
+        app.after_request(self._after_request)
+        app.teardown_request(self._teardown_request)
+
+    def _before_request(self):
+        g._devinspector_start_time = time.perf_counter()
+
+    def _after_request(self, response):
+        self._record_metric(response.status_code)
+        return response
+
+    def _teardown_request(self, exception=None):
+        if exception:
+            audit.capture_error(
+                exception,
+                metadata={
+                    "path": request.path,
+                    "method": request.method,
+                },
+            )
+            # Garante que métrica de erro (500) seja registrada caso falhe antes do after_request
+            if not getattr(g, "_devinspector_metric_recorded", False):
+                self._record_metric(500)
+
+    def _record_metric(self, status_code: int):
+        start_time = getattr(g, "_devinspector_start_time", None)
+        if start_time is None:
+            return
+
+        duration_ms = (time.perf_counter() - start_time) * 1000
+        user_agent = request.headers.get("User-Agent", "")
+
+        audit.capture_request(
+            method=request.method,
+            url=request.url,
+            status_code=status_code,
+            duration_ms=duration_ms,
+            user_agent=user_agent,
+        )
+        g._devinspector_metric_recorded = True

devinspector-2.0.0/devinspector.egg-info/PKG-INFO

@@ -0,0 +1,15 @@
+Metadata-Version: 2.4
+Name: devinspector
+Version: 2.0.0
+Summary: SDK Python de monitoramento e auditoria em tempo real | DevInspector
+Author-email: DevInspector <suporte@devinspector.com.br>
+License: MIT
+Project-URL: Homepage, https://devinspector.com.br
+Keywords: monitoring,error-tracking,audit,devinspector,fastapi,flask
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Provides-Extra: fastapi
+Requires-Dist: fastapi; extra == "fastapi"
+Requires-Dist: starlette; extra == "fastapi"
+Provides-Extra: flask
+Requires-Dist: flask; extra == "flask"

devinspector-2.0.0/devinspector.egg-info/SOURCES.txt

@@ -0,0 +1,11 @@
+README.md
+pyproject.toml
+devinspector/__init__.py
+devinspector/core.py
+devinspector/fastapi.py
+devinspector/flask.py
+devinspector.egg-info/PKG-INFO
+devinspector.egg-info/SOURCES.txt
+devinspector.egg-info/dependency_links.txt
+devinspector.egg-info/requires.txt
+devinspector.egg-info/top_level.txt

devinspector-2.0.0/devinspector.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

devinspector-2.0.0/devinspector.egg-info/requires.txt

@@ -0,0 +1,7 @@
+
+[fastapi]
+fastapi
+starlette
+
+[flask]
+flask

devinspector-2.0.0/devinspector.egg-info/top_level.txt

@@ -0,0 +1 @@
+devinspector

devinspector-2.0.0/pyproject.toml

@@ -0,0 +1,23 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "devinspector"
+version = "2.0.0"
+description = "SDK Python de monitoramento e auditoria em tempo real | DevInspector"
+readme = "README.md"
+requires-python = ">=3.8"
+license = {text = "MIT"}
+authors = [
+    {name = "DevInspector", email = "suporte@devinspector.com.br"}
+]
+keywords = ["monitoring", "error-tracking", "audit", "devinspector", "fastapi", "flask"]
+dependencies = []
+
+[project.optional-dependencies]
+fastapi = ["fastapi", "starlette"]
+flask = ["flask"]
+
+[project.urls]
+Homepage = "https://devinspector.com.br"

devinspector-2.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+