debug-assist 1.0.0__tar.gz

debug_assist-1.0.0/PKG-INFO

@@ -0,0 +1,47 @@
+Metadata-Version: 2.4
+Name: debug-assist
+Version: 1.0.0
+Summary: Auto-capture runtime errors and send diagnostics to DebugAssist API
+License: MIT
+Project-URL: Homepage, https://github.com/debug-assist/sdk-python
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+
+# DebugAssist Python SDK
+
+Auto-capture runtime errors and send diagnostics to [DebugAssist](https://debug-assist.app).
+
+## Install
+
+```bash
+pip install debug-assist
+```
+
+## Usage
+
+```python
+# Auto mode — set env var and import
+import os
+os.environ['DEBUG_ASSIST_API_KEY'] = 'your-api-key'
+import debug_assist  # unhandled exceptions are captured automatically
+
+# Explicit mode
+from debug_assist import DebugAssist
+DebugAssist.init(api_key='your-api-key', project_name='my-app')
+
+# Manual report
+client = DebugAssist(api_key='your-api-key')
+client.report(tipo='silent_backend_error', mensagem='something went wrong')
+```
+
+## Environment Variables
+
+| Variable | Description | Default |
+|----------|-------------|---------|
+| `DEBUG_ASSIST_API_KEY` | Your API key | — |
+| `DEBUG_ASSIST_PROJECT` | Project name shown in diagnostics | `unknown` |
+| `DEBUG_ASSIST_BASE_URL` | API base URL | `https://debug-assist.onrender.com` |
+| `DEBUG_ASSIST_ENABLED` | Set to `0` to disable | `1` |

debug_assist-1.0.0/README.md

@@ -0,0 +1,35 @@
+# DebugAssist Python SDK
+
+Auto-capture runtime errors and send diagnostics to [DebugAssist](https://debug-assist.app).
+
+## Install
+
+```bash
+pip install debug-assist
+```
+
+## Usage
+
+```python
+# Auto mode — set env var and import
+import os
+os.environ['DEBUG_ASSIST_API_KEY'] = 'your-api-key'
+import debug_assist  # unhandled exceptions are captured automatically
+
+# Explicit mode
+from debug_assist import DebugAssist
+DebugAssist.init(api_key='your-api-key', project_name='my-app')
+
+# Manual report
+client = DebugAssist(api_key='your-api-key')
+client.report(tipo='silent_backend_error', mensagem='something went wrong')
+```
+
+## Environment Variables
+
+| Variable | Description | Default |
+|----------|-------------|---------|
+| `DEBUG_ASSIST_API_KEY` | Your API key | — |
+| `DEBUG_ASSIST_PROJECT` | Project name shown in diagnostics | `unknown` |
+| `DEBUG_ASSIST_BASE_URL` | API base URL | `https://debug-assist.onrender.com` |
+| `DEBUG_ASSIST_ENABLED` | Set to `0` to disable | `1` |

debug_assist-1.0.0/debug_assist.egg-info/PKG-INFO

@@ -0,0 +1,47 @@
+Metadata-Version: 2.4
+Name: debug-assist
+Version: 1.0.0
+Summary: Auto-capture runtime errors and send diagnostics to DebugAssist API
+License: MIT
+Project-URL: Homepage, https://github.com/debug-assist/sdk-python
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+
+# DebugAssist Python SDK
+
+Auto-capture runtime errors and send diagnostics to [DebugAssist](https://debug-assist.app).
+
+## Install
+
+```bash
+pip install debug-assist
+```
+
+## Usage
+
+```python
+# Auto mode — set env var and import
+import os
+os.environ['DEBUG_ASSIST_API_KEY'] = 'your-api-key'
+import debug_assist  # unhandled exceptions are captured automatically
+
+# Explicit mode
+from debug_assist import DebugAssist
+DebugAssist.init(api_key='your-api-key', project_name='my-app')
+
+# Manual report
+client = DebugAssist(api_key='your-api-key')
+client.report(tipo='silent_backend_error', mensagem='something went wrong')
+```
+
+## Environment Variables
+
+| Variable | Description | Default |
+|----------|-------------|---------|
+| `DEBUG_ASSIST_API_KEY` | Your API key | — |
+| `DEBUG_ASSIST_PROJECT` | Project name shown in diagnostics | `unknown` |
+| `DEBUG_ASSIST_BASE_URL` | API base URL | `https://debug-assist.onrender.com` |
+| `DEBUG_ASSIST_ENABLED` | Set to `0` to disable | `1` |

debug_assist-1.0.0/debug_assist.egg-info/SOURCES.txt

@@ -0,0 +1,7 @@
+README.md
+debug_assist.py
+pyproject.toml
+debug_assist.egg-info/PKG-INFO
+debug_assist.egg-info/SOURCES.txt
+debug_assist.egg-info/dependency_links.txt
+debug_assist.egg-info/top_level.txt

debug_assist-1.0.0/debug_assist.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

debug_assist-1.0.0/debug_assist.egg-info/top_level.txt

@@ -0,0 +1 @@
+debug_assist

debug_assist-1.0.0/debug_assist.py

@@ -0,0 +1,116 @@
+"""
+DebugAssist Python SDK
+
+Captura automaticamente exceções não tratadas e envia para a API DebugAssist.
+
+Modo mais simples — via variável de ambiente:
+    export DEBUG_ASSIST_API_KEY='SUA_API_KEY'
+    import debug_assist  # só isso já basta, monitoramento ativado
+
+Modo explícito (quando a chave vem do código):
+    from debug_assist import DebugAssist
+    DebugAssist.init(api_key='SUA_API_KEY', project_name='meu-projeto')
+
+Envio manual:
+    client = DebugAssist(api_key='SUA_API_KEY')
+    client.report(tipo='silent_backend_error', mensagem=str(e))
+"""
+
+import json
+import os
+import sys
+import traceback
+import urllib.request
+
+DEFAULT_BASE_URL = 'https://debug-assist.onrender.com'
+
+
+class DebugAssist:
+    _initialized = False
+
+    def __init__(self, api_key, base_url=None):
+        if not api_key:
+            raise ValueError('DebugAssist: api_key é obrigatória')
+        self.api_key = api_key
+        self.base_url = (base_url or DEFAULT_BASE_URL).rstrip('/')
+
+    def report(self, tipo, mensagem='', contexto=None, dados=None):
+        """Envia um diagnóstico para a API DebugAssist.
+
+        Args:
+            tipo: Categoria do erro (ex: 'silent_backend_error', 'sql_analysis').
+            mensagem: Mensagem de erro (ex: str(e)).
+            contexto: Dict com dados adicionais (rota, método, etc.).
+            dados: Dict para sql_analysis (query, tempo_execucao).
+
+        Returns:
+            Dict com o diagnóstico retornado pela API.
+        """
+        if not tipo:
+            raise ValueError("DebugAssist: campo 'tipo' é obrigatório")
+
+        body = {'tipo': tipo, 'mensagem': mensagem}
+        if contexto:
+            body['contexto'] = contexto
+        if dados:
+            body['dados'] = dados
+
+        encoded = json.dumps(body).encode('utf-8')
+        req = urllib.request.Request(
+            f'{self.base_url}/v1/diagnosticos',
+            data=encoded,
+            method='POST',
+        )
+        req.add_header('Content-Type', 'application/json')
+        req.add_header('Authorization', f'Bearer {self.api_key}')
+
+        with urllib.request.urlopen(req, timeout=30) as resp:
+            return json.loads(resp.read().decode('utf-8'))
+
+    @classmethod
+    def init(cls, api_key, project_name='unknown', base_url=None):
+        """Registra o hook de exceções não tratadas.
+
+        Após chamar init(), qualquer exceção que derrube o processo é
+        automaticamente enviada para a API antes de encerrar.
+
+        Args:
+            api_key: Sua API Key (obtida em /v1/auth/me).
+            project_name: Nome do projeto (aparece no contexto do diagnóstico).
+            base_url: URL base da API (padrão: https://debug-assist.onrender.com).
+        """
+        if cls._initialized:
+            return
+
+        client = cls(api_key=api_key, base_url=base_url)
+        cls._initialized = True
+
+        original_excepthook = sys.excepthook
+
+        def _excepthook(exc_type, exc_value, exc_traceback):
+            stack = ''.join(traceback.format_tb(exc_traceback))
+            try:
+                client.report(
+                    tipo='silent_backend_error',
+                    mensagem=str(exc_value),
+                    contexto={
+                        'project_name': project_name,
+                        'exception_type': exc_type.__name__,
+                        'stack': stack,
+                    },
+                )
+            except Exception:
+                pass
+            original_excepthook(exc_type, exc_value, exc_traceback)
+
+        sys.excepthook = _excepthook
+
+
+# Auto-inicializa se DEBUG_ASSIST_API_KEY estiver no ambiente
+_env_key = os.getenv('DEBUG_ASSIST_API_KEY')
+if _env_key and os.getenv('DEBUG_ASSIST_ENABLED', '1') != '0':
+    DebugAssist.init(
+        api_key=_env_key,
+        project_name=os.getenv('DEBUG_ASSIST_PROJECT', 'unknown'),
+        base_url=os.getenv('DEBUG_ASSIST_BASE_URL'),
+    )

debug_assist-1.0.0/pyproject.toml

@@ -0,0 +1,22 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "debug-assist"
+version = "1.0.0"
+description = "Auto-capture runtime errors and send diagnostics to DebugAssist API"
+readme = "README.md"
+requires-python = ">=3.8"
+license = {text = "MIT"}
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+]
+
+[project.urls]
+Homepage = "https://github.com/debug-assist/sdk-python"
+
+[tool.setuptools]
+py-modules = ["debug_assist"]

debug_assist-1.0.0/setup.cfg

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