ghosttrap-sdk 0.4.2__tar.gz → 0.4.4__tar.gz

ghosttrap_sdk-0.4.4/PKG-INFO

@@ -0,0 +1,90 @@
+Metadata-Version: 2.4
+Name: ghosttrap-sdk
+Version: 0.4.4
+Summary: Drop-in error reporter for ghosttrap.io
+Project-URL: Homepage, https://github.com/alex-rowley/ghosttrap-sdk
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+
+# ghosttrap-sdk
+
+Error reporting for Python apps, built for AI agents. Part of [ghosttrap](https://github.com/alex-rowley/ghosttrap-cli).
+
+## Install
+
+```
+pip install ghosttrap-sdk
+```
+
+## Use
+
+```python
+import ghosttrap
+ghosttrap.init("t_your_token_here")
+```
+
+Get your token by running `ghosttrap setup` from [ghosttrap-cli](https://github.com/alex-rowley/ghosttrap-cli).
+
+### Optional kwargs
+
+```python
+ghosttrap.init(
+    "t_your_token_here",
+    server="https://ghosttrap.io",  # override only if self-hosting
+    send_user=False,                # see "User context" below
+)
+```
+
+## What it hooks into
+
+- **`sys.excepthook`** — unhandled exceptions
+- **Python logging** — `logger.exception()` and `logger.error(..., exc_info=True)`
+- **Celery** — task failures via `celery.signals.task_failure` (auto-detected)
+
+## What it sends
+
+Every report includes the exception type, message, traceback, frames (file/line/function/code), and the server's hostname (`socket.gethostname()`).
+
+## Django
+
+```python
+INSTALLED_APPS = [
+    ...
+    "ghosttrap.django.GhostTrapApp",
+]
+
+MIDDLEWARE = [
+    "ghosttrap.django.GhostTrapMiddleware",
+    ...
+]
+```
+
+## Manually trap an event
+
+For errors you catch and handle but still want logged, or for non-exception conditions worth flagging:
+
+```python
+import ghosttrap
+
+try:
+    do_thing()
+except ValueError as e:
+    ghosttrap.trap(e)        # caught exception — sent with type, message, traceback
+    fallback()
+
+ghosttrap.trap("payment gateway returned 503")  # synthetic event labelled "TrappedEvent"
+```
+
+`trap()` accepts an exception instance or a string. Strings get the caller's stack attached and a `TrappedEvent` type so they're distinct from real exceptions in the CLI. Both go through the same 5-minute dedup window as the auto-hook.
+
+## User context
+
+Off by default. Pass `send_user=True` to `init()` and the Django middleware will attach the authenticated user's `id` and `username` to each report. Has no effect outside Django.
+
+```python
+ghosttrap.init("t_your_token_here", send_user=True)
+```
+
+## Zero dependencies
+
+Pure Python stdlib. No transitive dependencies in your production image.

ghosttrap_sdk-0.4.4/README.md

@@ -0,0 +1,82 @@
+# ghosttrap-sdk
+
+Error reporting for Python apps, built for AI agents. Part of [ghosttrap](https://github.com/alex-rowley/ghosttrap-cli).
+
+## Install
+
+```
+pip install ghosttrap-sdk
+```
+
+## Use
+
+```python
+import ghosttrap
+ghosttrap.init("t_your_token_here")
+```
+
+Get your token by running `ghosttrap setup` from [ghosttrap-cli](https://github.com/alex-rowley/ghosttrap-cli).
+
+### Optional kwargs
+
+```python
+ghosttrap.init(
+    "t_your_token_here",
+    server="https://ghosttrap.io",  # override only if self-hosting
+    send_user=False,                # see "User context" below
+)
+```
+
+## What it hooks into
+
+- **`sys.excepthook`** — unhandled exceptions
+- **Python logging** — `logger.exception()` and `logger.error(..., exc_info=True)`
+- **Celery** — task failures via `celery.signals.task_failure` (auto-detected)
+
+## What it sends
+
+Every report includes the exception type, message, traceback, frames (file/line/function/code), and the server's hostname (`socket.gethostname()`).
+
+## Django
+
+```python
+INSTALLED_APPS = [
+    ...
+    "ghosttrap.django.GhostTrapApp",
+]
+
+MIDDLEWARE = [
+    "ghosttrap.django.GhostTrapMiddleware",
+    ...
+]
+```
+
+## Manually trap an event
+
+For errors you catch and handle but still want logged, or for non-exception conditions worth flagging:
+
+```python
+import ghosttrap
+
+try:
+    do_thing()
+except ValueError as e:
+    ghosttrap.trap(e)        # caught exception — sent with type, message, traceback
+    fallback()
+
+ghosttrap.trap("payment gateway returned 503")  # synthetic event labelled "TrappedEvent"
+```
+
+`trap()` accepts an exception instance or a string. Strings get the caller's stack attached and a `TrappedEvent` type so they're distinct from real exceptions in the CLI. Both go through the same 5-minute dedup window as the auto-hook.
+
+## User context
+
+Off by default. Pass `send_user=True` to `init()` and the Django middleware will attach the authenticated user's `id` and `username` to each report. Has no effect outside Django.
+
+```python
+ghosttrap.init("t_your_token_here", send_user=True)
+```
+
+## Zero dependencies
+
+Pure Python stdlib. No transitive dependencies in your production image.

ghosttrap_sdk-0.4.4/ghosttrap/__init__.py

@@ -0,0 +1,3 @@
+from ghosttrap.client import init, report, trap
+
+__all__ = ["init", "report", "trap"]

{ghosttrap_sdk-0.4.2 → ghosttrap_sdk-0.4.4}/ghosttrap/client.py

@@ -61,16 +61,30 @@ def init(dsn, server=None, send_user=False):
 
 
 def report(exc, user=None):
-    """Report a caught exception to the ghosttrap server.
+    """Report a caught exception. Kept for backward compatibility; prefer `trap`."""
+    trap(exc, user=user)
+
+
+def trap(exc_or_message, user=None):
+    """Manually trap an event.
+
+    Pass an exception instance to report a caught error (its type, message,
+    and traceback are sent). Pass a string to report a synthetic event with
+    the caller's current stack — labelled `TrappedEvent` so it's distinct
+    from real exceptions.
 
     Args:
-        exc: the exception instance from an `except Exception as exc` block
+        exc_or_message: exception instance or string
         user: optional dict with user context (id, username). Only sent
               if init() was called with send_user=True.
     """
     if _endpoint is None:
         return
-    _post(_build_payload(type(exc), exc, exc.__traceback__, user=user))
+    if isinstance(exc_or_message, BaseException):
+        exc = exc_or_message
+        _post(_build_payload(type(exc), exc, exc.__traceback__, user=user))
+    else:
+        _post(_build_synthetic_payload(str(exc_or_message), user=user))
 
 
 def _error_hook(exc_type, exc_value, exc_tb):
@@ -102,6 +116,27 @@ class _GhostTrapLogHandler(logging.Handler):
             report(record.exc_info[1])
 
 
+def _build_synthetic_payload(message, user=None):
+    frames_obj = traceback.extract_stack()[:-2]  # drop trap() and this builder
+    formatted = ["Traceback (most recent call last):\n"]
+    formatted += traceback.format_list(frames_obj)
+    formatted.append(f"TrappedEvent: {message}\n")
+    payload = {
+        "type": "TrappedEvent",
+        "message": message,
+        "traceback": formatted,
+        "frames": [
+            {"file": f.filename, "line": f.lineno, "function": f.name, "code": f.line}
+            for f in frames_obj
+        ],
+    }
+    if _server_name:
+        payload["server_name"] = _server_name
+    if user and _send_user:
+        payload["user"] = user
+    return payload
+
+
 def _build_payload(exc_type, exc_value, exc_tb, user=None):
     frames = traceback.extract_tb(exc_tb) if exc_tb else []
     payload = {

ghosttrap_sdk-0.4.4/ghosttrap_sdk.egg-info/PKG-INFO

@@ -0,0 +1,90 @@
+Metadata-Version: 2.4
+Name: ghosttrap-sdk
+Version: 0.4.4
+Summary: Drop-in error reporter for ghosttrap.io
+Project-URL: Homepage, https://github.com/alex-rowley/ghosttrap-sdk
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+
+# ghosttrap-sdk
+
+Error reporting for Python apps, built for AI agents. Part of [ghosttrap](https://github.com/alex-rowley/ghosttrap-cli).
+
+## Install
+
+```
+pip install ghosttrap-sdk
+```
+
+## Use
+
+```python
+import ghosttrap
+ghosttrap.init("t_your_token_here")
+```
+
+Get your token by running `ghosttrap setup` from [ghosttrap-cli](https://github.com/alex-rowley/ghosttrap-cli).
+
+### Optional kwargs
+
+```python
+ghosttrap.init(
+    "t_your_token_here",
+    server="https://ghosttrap.io",  # override only if self-hosting
+    send_user=False,                # see "User context" below
+)
+```
+
+## What it hooks into
+
+- **`sys.excepthook`** — unhandled exceptions
+- **Python logging** — `logger.exception()` and `logger.error(..., exc_info=True)`
+- **Celery** — task failures via `celery.signals.task_failure` (auto-detected)
+
+## What it sends
+
+Every report includes the exception type, message, traceback, frames (file/line/function/code), and the server's hostname (`socket.gethostname()`).
+
+## Django
+
+```python
+INSTALLED_APPS = [
+    ...
+    "ghosttrap.django.GhostTrapApp",
+]
+
+MIDDLEWARE = [
+    "ghosttrap.django.GhostTrapMiddleware",
+    ...
+]
+```
+
+## Manually trap an event
+
+For errors you catch and handle but still want logged, or for non-exception conditions worth flagging:
+
+```python
+import ghosttrap
+
+try:
+    do_thing()
+except ValueError as e:
+    ghosttrap.trap(e)        # caught exception — sent with type, message, traceback
+    fallback()
+
+ghosttrap.trap("payment gateway returned 503")  # synthetic event labelled "TrappedEvent"
+```
+
+`trap()` accepts an exception instance or a string. Strings get the caller's stack attached and a `TrappedEvent` type so they're distinct from real exceptions in the CLI. Both go through the same 5-minute dedup window as the auto-hook.
+
+## User context
+
+Off by default. Pass `send_user=True` to `init()` and the Django middleware will attach the authenticated user's `id` and `username` to each report. Has no effect outside Django.
+
+```python
+ghosttrap.init("t_your_token_here", send_user=True)
+```
+
+## Zero dependencies
+
+Pure Python stdlib. No transitive dependencies in your production image.

{ghosttrap_sdk-0.4.2 → ghosttrap_sdk-0.4.4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "ghosttrap-sdk"
-version = "0.4.2"
+version = "0.4.4"
 description = "Drop-in error reporter for ghosttrap.io"
 readme = "README.md"
 requires-python = ">=3.10"

ghosttrap_sdk-0.4.2/PKG-INFO

@@ -1,50 +0,0 @@
-Metadata-Version: 2.4
-Name: ghosttrap-sdk
-Version: 0.4.2
-Summary: Drop-in error reporter for ghosttrap.io
-Project-URL: Homepage, https://github.com/alex-rowley/ghosttrap-sdk
-Requires-Python: >=3.10
-Description-Content-Type: text/markdown
-
-# ghosttrap-sdk
-
-Error reporting for Python apps, built for AI agents. Part of [ghosttrap](https://github.com/alex-rowley/ghosttrap-cli).
-
-## Install
-
-```
-pip install ghosttrap-sdk
-```
-
-## Use
-
-```python
-import ghosttrap
-ghosttrap.init("t_your_token_here")
-```
-
-Get your token by running `ghosttrap setup` from [ghosttrap-cli](https://github.com/alex-rowley/ghosttrap-cli).
-
-## What it hooks into
-
-- **`sys.excepthook`** — unhandled exceptions
-- **Python logging** — `logger.exception()` and `logger.error(..., exc_info=True)`
-- **Celery** — task failures via `celery.signals.task_failure` (auto-detected)
-
-## Django
-
-```python
-INSTALLED_APPS = [
-    ...
-    "ghosttrap.django.GhostTrapApp",
-]
-
-MIDDLEWARE = [
-    "ghosttrap.django.GhostTrapMiddleware",
-    ...
-]
-```
-
-## Zero dependencies
-
-Pure Python stdlib. No transitive dependencies in your production image.

ghosttrap_sdk-0.4.2/README.md

@@ -1,42 +0,0 @@
-# ghosttrap-sdk
-
-Error reporting for Python apps, built for AI agents. Part of [ghosttrap](https://github.com/alex-rowley/ghosttrap-cli).
-
-## Install
-
-```
-pip install ghosttrap-sdk
-```
-
-## Use
-
-```python
-import ghosttrap
-ghosttrap.init("t_your_token_here")
-```
-
-Get your token by running `ghosttrap setup` from [ghosttrap-cli](https://github.com/alex-rowley/ghosttrap-cli).
-
-## What it hooks into
-
-- **`sys.excepthook`** — unhandled exceptions
-- **Python logging** — `logger.exception()` and `logger.error(..., exc_info=True)`
-- **Celery** — task failures via `celery.signals.task_failure` (auto-detected)
-
-## Django
-
-```python
-INSTALLED_APPS = [
-    ...
-    "ghosttrap.django.GhostTrapApp",
-]
-
-MIDDLEWARE = [
-    "ghosttrap.django.GhostTrapMiddleware",
-    ...
-]
-```
-
-## Zero dependencies
-
-Pure Python stdlib. No transitive dependencies in your production image.

ghosttrap_sdk-0.4.2/ghosttrap/__init__.py

@@ -1,3 +0,0 @@
-from ghosttrap.client import init, report
-
-__all__ = ["init", "report"]

ghosttrap_sdk-0.4.2/ghosttrap_sdk.egg-info/PKG-INFO

@@ -1,50 +0,0 @@
-Metadata-Version: 2.4
-Name: ghosttrap-sdk
-Version: 0.4.2
-Summary: Drop-in error reporter for ghosttrap.io
-Project-URL: Homepage, https://github.com/alex-rowley/ghosttrap-sdk
-Requires-Python: >=3.10
-Description-Content-Type: text/markdown
-
-# ghosttrap-sdk
-
-Error reporting for Python apps, built for AI agents. Part of [ghosttrap](https://github.com/alex-rowley/ghosttrap-cli).
-
-## Install
-
-```
-pip install ghosttrap-sdk
-```
-
-## Use
-
-```python
-import ghosttrap
-ghosttrap.init("t_your_token_here")
-```
-
-Get your token by running `ghosttrap setup` from [ghosttrap-cli](https://github.com/alex-rowley/ghosttrap-cli).
-
-## What it hooks into
-
-- **`sys.excepthook`** — unhandled exceptions
-- **Python logging** — `logger.exception()` and `logger.error(..., exc_info=True)`
-- **Celery** — task failures via `celery.signals.task_failure` (auto-detected)
-
-## Django
-
-```python
-INSTALLED_APPS = [
-    ...
-    "ghosttrap.django.GhostTrapApp",
-]
-
-MIDDLEWARE = [
-    "ghosttrap.django.GhostTrapMiddleware",
-    ...
-]
-```
-
-## Zero dependencies
-
-Pure Python stdlib. No transitive dependencies in your production image.