watchdock-errors 0.2.4__tar.gz → 0.3.0__tar.gz

{watchdock_errors-0.2.4/src/watchdock_errors.egg-info → watchdock_errors-0.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: watchdock-errors
-Version: 0.2.4
+Version: 0.3.0
 Summary: Application error tracking SDK for the Watchdock platform
 License: MIT
 Keywords: error-tracking,observability,watchdock

{watchdock_errors-0.2.4 → watchdock_errors-0.3.0}/src/watchdock_errors/utils.py

@@ -6,6 +6,35 @@ import socket
 import traceback
 
 
+#: Number of source lines captured on each side of the failing line. Matches the
+#: window the backend uses when it falls back to enriching frames itself, so a
+#: frame looks the same whether the context came from here or from the server.
+CONTEXT_LINES = 2
+
+
+def _source_context(filename: str, lineno: int) -> tuple[list[str], list[str]]:
+    """Read the source lines immediately before and after ``lineno``.
+
+    Returns ``(pre_context, post_context)``. We do this in the SDK, on the box
+    where the code actually runs, because the source is here — the backend can
+    only guess at it from its own filesystem, which is the wrong machine for any
+    real app. Out-of-range lines come back as empty strings so the two lists are
+    always the same length regardless of where in the file the error landed.
+    """
+    if not filename or not lineno:
+        return [], []
+
+    pre = [
+        linecache.getline(filename, i).rstrip("\n")
+        for i in range(max(1, lineno - CONTEXT_LINES), lineno)
+    ]
+    post = [
+        linecache.getline(filename, i).rstrip("\n")
+        for i in range(lineno + 1, lineno + CONTEXT_LINES + 1)
+    ]
+    return pre, post
+
+
 def extract_stacktrace(exc: BaseException) -> list[dict]:
     """Extract structured stack frames from an exception."""
     tb = exc.__traceback__
@@ -15,12 +44,15 @@ def extract_stacktrace(exc: BaseException) -> list[dict]:
     frames = []
     for frame_summary in traceback.extract_tb(tb):
         context_line = linecache.getline(frame_summary.filename, frame_summary.lineno).strip()
+        pre_context, post_context = _source_context(frame_summary.filename, frame_summary.lineno)
         frames.append(
             {
                 "filename": frame_summary.filename,
                 "function": frame_summary.name,
                 "lineno": frame_summary.lineno,
                 "context_line": context_line,
+                "pre_context": pre_context,
+                "post_context": post_context,
             }
         )
     return frames

{watchdock_errors-0.2.4 → watchdock_errors-0.3.0/src/watchdock_errors.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: watchdock-errors
-Version: 0.2.4
+Version: 0.3.0
 Summary: Application error tracking SDK for the Watchdock platform
 License: MIT
 Keywords: error-tracking,observability,watchdock

{watchdock_errors-0.2.4 → watchdock_errors-0.3.0}/src/watchdock_errors.egg-info/SOURCES.txt

@@ -19,4 +19,5 @@ src/watchdock_errors/integrations/__init__.py
 src/watchdock_errors/integrations/django.py
 src/watchdock_errors/integrations/fastapi.py
 tests/test_client.py
-tests/test_event.py
+tests/test_event.py
+tests/test_utils.py

{watchdock_errors-0.2.4 → watchdock_errors-0.3.0}/src/watchdock_errors.egg-info/scm_file_list.json

@@ -1,19 +1,20 @@
 {
   "files": [
+    ".gitignore",
     "README.md",
     "pyproject.toml",
-    ".gitignore",
-    "src/watchdock_errors/__init__.py",
+    "src/watchdock_errors/event.py",
+    "src/watchdock_errors/client.py",
     "src/watchdock_errors/config.py",
     "src/watchdock_errors/utils.py",
-    "src/watchdock_errors/client.py",
-    "src/watchdock_errors/event.py",
-    "src/watchdock_errors/integrations/__init__.py",
+    "src/watchdock_errors/__init__.py",
     "src/watchdock_errors/integrations/fastapi.py",
     "src/watchdock_errors/integrations/django.py",
-    "tests/test_client.py",
-    "tests/test_event.py",
+    "src/watchdock_errors/integrations/__init__.py",
+    ".github/workflows/ci.yml",
     ".github/workflows/release.yml",
-    ".github/workflows/ci.yml"
+    "tests/test_event.py",
+    "tests/test_client.py",
+    "tests/test_utils.py"
   ]
 }

watchdock_errors-0.3.0/src/watchdock_errors.egg-info/scm_version.json

@@ -0,0 +1,8 @@
+{
+  "tag": "0.3.0",
+  "distance": 0,
+  "node": "g711d547840b425c8a17c295e36cd0e731bdadbc4",
+  "dirty": false,
+  "branch": "HEAD",
+  "node_date": "2026-07-22"
+}

watchdock_errors-0.3.0/tests/test_utils.py

@@ -0,0 +1,44 @@
+from watchdock_errors.utils import extract_stacktrace
+
+
+def _boom():
+    # This line and the two on either side are what the context capture should
+    # pick up. Keep the surrounding lines stable so the assertions below hold.
+    x = 1
+    raise ValueError("boom")  # <-- failing line
+    return x
+
+
+def test_extract_stacktrace_captures_source_context():
+    try:
+        _boom()
+    except ValueError as exc:
+        frames = extract_stacktrace(exc)
+
+    assert frames, "expected at least one frame"
+
+    # The frame for _boom is the one whose failing line raised.
+    boom_frame = next(f for f in frames if f["function"] == "_boom")
+
+    assert boom_frame["context_line"] == 'raise ValueError("boom")  # <-- failing line'
+    # Two lines before and two after, in order, with indentation preserved.
+    assert len(boom_frame["pre_context"]) == 2
+    assert len(boom_frame["post_context"]) == 2
+    # The line immediately before the raise is `x = 1` (indentation kept).
+    assert boom_frame["pre_context"][1] == "    x = 1"
+    # The line immediately after the raise is the return.
+    assert boom_frame["post_context"][0] == "    return x"
+
+
+def test_frames_always_have_context_keys():
+    try:
+        raise KeyError("missing")
+    except KeyError as exc:
+        frames = extract_stacktrace(exc)
+
+    for frame in frames:
+        assert "context_line" in frame
+        assert "pre_context" in frame
+        assert "post_context" in frame
+        assert isinstance(frame["pre_context"], list)
+        assert isinstance(frame["post_context"], list)

watchdock_errors-0.2.4/src/watchdock_errors.egg-info/scm_version.json

@@ -1,8 +0,0 @@
-{
-  "tag": "0.2.4",
-  "distance": 0,
-  "node": "g8207b34ddbb2d7b5c9fe4f4df0960161f5b11709",
-  "dirty": false,
-  "branch": "HEAD",
-  "node_date": "2026-07-11"
-}