errorgap 0.1.0__tar.gz → 0.1.1__tar.gz

errorgap-0.1.1/CHANGELOG.md

@@ -0,0 +1,9 @@
+# Changelog
+
+## 0.1.1 — 2026-07-18
+
+- Include bounded inline source excerpts for readable application and dependency
+  traceback frames so
+  Errorgap can render highlighted source without a repository integration.
+- Order traceback frames innermost-first so frame 0 and group fingerprints use
+  the actual exception site.

{errorgap-0.1.0 → errorgap-0.1.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: errorgap
-Version: 0.1.0
+Version: 0.1.1
 Summary: Python notifier for Errorgap error tracking.
 Project-URL: Homepage, https://github.com/errorgaphq/errorgap-python
 Project-URL: Source, https://github.com/errorgaphq/errorgap-python
@@ -37,7 +37,8 @@ Description-Content-Type: text/markdown
 # errorgap
 
 Python notifier for [Errorgap](https://errorgap.com). Captures exceptions,
-normalizes tracebacks, and ships notices to an Errorgap server. Single
+normalizes tracebacks with bounded source excerpts for readable frames, and ships
+notices to an Errorgap server. Single
 package covers plain Python, Django, Flask, and FastAPI.
 
 ## Install
@@ -125,7 +126,7 @@ app.add_middleware(ErrorgapMiddleware)
 | `project_id` | `ERRORGAP_PROJECT_ID` | Optional, embedded in payload |
 | `api_key` | `ERRORGAP_API_KEY` | Sent as `x-errorgap-project-key` |
 | `environment` | `ERRORGAP_ENVIRONMENT`, `ENV`, or `development` | |
-| `root_directory` | `os.getcwd()` | Used to mark frames as `in_app` |
+| `root_directory` | `os.getcwd()` | Marks application frames; readable dependency frames also include bounded source excerpts |
 | `async_` | `True` | Background-thread delivery |
 | `logger` | `logging.getLogger("errorgap")` | Pass `None` to silence |
 | `filter_keys` | `("password", "token", ...)` | Substring match, case-insensitive |

{errorgap-0.1.0 → errorgap-0.1.1}/README.md

@@ -1,7 +1,8 @@
 # errorgap
 
 Python notifier for [Errorgap](https://errorgap.com). Captures exceptions,
-normalizes tracebacks, and ships notices to an Errorgap server. Single
+normalizes tracebacks with bounded source excerpts for readable frames, and ships
+notices to an Errorgap server. Single
 package covers plain Python, Django, Flask, and FastAPI.
 
 ## Install
@@ -89,7 +90,7 @@ app.add_middleware(ErrorgapMiddleware)
 | `project_id` | `ERRORGAP_PROJECT_ID` | Optional, embedded in payload |
 | `api_key` | `ERRORGAP_API_KEY` | Sent as `x-errorgap-project-key` |
 | `environment` | `ERRORGAP_ENVIRONMENT`, `ENV`, or `development` | |
-| `root_directory` | `os.getcwd()` | Used to mark frames as `in_app` |
+| `root_directory` | `os.getcwd()` | Marks application frames; readable dependency frames also include bounded source excerpts |
 | `async_` | `True` | Background-thread delivery |
 | `logger` | `logging.getLogger("errorgap")` | Pass `None` to silence |
 | `filter_keys` | `("password", "token", ...)` | Substring match, case-insensitive |

{errorgap-0.1.0 → errorgap-0.1.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "errorgap"
-version = "0.1.0"
+version = "0.1.1"
 description = "Python notifier for Errorgap error tracking."
 readme = "README.md"
 license = { text = "MIT" }

errorgap-0.1.1/src/errorgap/backtrace.py

@@ -0,0 +1,79 @@
+from __future__ import annotations
+
+import os
+import traceback
+from typing import Any, Dict, List, Optional
+
+SOURCE_CONTEXT_RADIUS = 6
+MAX_SOURCE_LINE_CHARS = 400
+
+
+def parse_backtrace(exc: BaseException, root_directory: str) -> List[Dict[str, Any]]:
+    frames: List[Dict[str, Any]] = []
+    # traceback.extract_tb returns oldest -> newest. Errorgap frame index 0 is
+    # the innermost frame where the exception was raised.
+    tb_frames = reversed(traceback.extract_tb(exc.__traceback__))
+
+    for index, frame in enumerate(tb_frames):
+        file = frame.filename
+        in_app = _is_in_app(file, root_directory)
+        normalized: Dict[str, Any] = {
+            "file": _relative_file(file, root_directory),
+            "line": frame.lineno,
+            "function": frame.name,
+            "in_app": in_app,
+            "index": index,
+        }
+        source = _source_excerpt(file, frame.lineno)
+        if source is not None:
+            normalized["source"] = source
+        frames.append(normalized)
+
+    return frames
+
+
+def _relative_file(file: Optional[str], root: str) -> Optional[str]:
+    if not file:
+        return file
+    if not root:
+        return file
+    normalized = root if root.endswith(os.sep) else root + os.sep
+    if file.startswith(normalized):
+        return file[len(normalized):]
+    return file
+
+
+def _is_in_app(file: Optional[str], root: str) -> bool:
+    if not file or not root:
+        return False
+    if "site-packages" in file:
+        return False
+    if file.startswith("<"):
+        return False
+    return file.startswith(root)
+
+
+def _source_excerpt(file: str, line: int) -> Optional[Dict[str, Any]]:
+    if line < 1:
+        return None
+    start_line = max(1, line - SOURCE_CONTEXT_RADIUS)
+    end_line = line + SOURCE_CONTEXT_RADIUS
+    lines: List[str] = []
+    target_found = False
+
+    try:
+        with open(file, encoding="utf-8", errors="replace") as source_file:
+            for number, text in enumerate(source_file, start=1):
+                if number < start_line:
+                    continue
+                if number > end_line:
+                    break
+                lines.append(text.rstrip("\r\n")[:MAX_SOURCE_LINE_CHARS])
+                if number == line:
+                    target_found = True
+    except OSError:
+        return None
+
+    if not lines or not target_found:
+        return None
+    return {"start_line": start_line, "lines": lines}

errorgap-0.1.1/src/errorgap/version.py

@@ -0,0 +1 @@
+VERSION = "0.1.1"

errorgap-0.1.1/tests/test_backtrace.py

@@ -0,0 +1,81 @@
+from __future__ import annotations
+
+import os
+
+from errorgap.backtrace import (
+    MAX_SOURCE_LINE_CHARS,
+    SOURCE_CONTEXT_RADIUS,
+    _source_excerpt,
+    parse_backtrace,
+)
+
+
+def _raise_and_capture() -> Exception:
+    try:
+        raise ValueError("boom")
+    except Exception as exc:
+        return exc
+
+
+def test_parses_frames():
+    exc = _raise_and_capture()
+    frames = parse_backtrace(exc, os.getcwd())
+    assert len(frames) >= 1
+    top = frames[0]
+    assert top["function"] == "_raise_and_capture"
+    assert top["line"] > 0
+    assert "test_backtrace" in (top["file"] or "")
+    assert top["index"] == 0
+
+
+def test_in_app_marks_files_under_root():
+    exc = _raise_and_capture()
+    frames = parse_backtrace(exc, os.getcwd())
+    assert frames[0]["in_app"] is True
+
+
+def test_empty_for_exception_without_traceback():
+    exc = ValueError("no tb")
+    assert parse_backtrace(exc, os.getcwd()) == []
+
+
+def _inner_failure() -> None:
+    raise RuntimeError("inner boom")
+
+
+def _outer_failure() -> None:
+    _inner_failure()
+
+
+def test_innermost_frame_is_first_and_includes_source_context():
+    try:
+        _outer_failure()
+    except RuntimeError as exc:
+        frames = parse_backtrace(exc, os.getcwd())
+
+    assert frames[0]["function"] == "_inner_failure"
+    assert frames[1]["function"] == "_outer_failure"
+    source = frames[0]["source"]
+    target_offset = frames[0]["line"] - source["start_line"]
+    assert 'raise RuntimeError("inner boom")' in source["lines"][target_offset]
+
+
+def test_attaches_source_to_readable_vendor_frames():
+    exc = _raise_and_capture()
+    frames = parse_backtrace(exc, "/path/that/does/not/contain/tests")
+    assert frames[0]["in_app"] is False
+    source = frames[0]["source"]
+    target_offset = frames[0]["line"] - source["start_line"]
+    assert 'raise ValueError("boom")' in source["lines"][target_offset]
+
+
+def test_source_excerpt_is_bounded(tmp_path):
+    source_file = tmp_path / "app.py"
+    source_file.write_text("\n".join(["x" * 500] * 30), encoding="utf-8")
+
+    source = _source_excerpt(str(source_file), 15)
+
+    assert source is not None
+    assert source["start_line"] == 15 - SOURCE_CONTEXT_RADIUS
+    assert len(source["lines"]) == SOURCE_CONTEXT_RADIUS * 2 + 1
+    assert all(len(line) == MAX_SOURCE_LINE_CHARS for line in source["lines"])

errorgap-0.1.0/src/errorgap/backtrace.py

@@ -1,45 +0,0 @@
-from __future__ import annotations
-
-import os
-import traceback
-from typing import Any, Dict, List, Optional
-
-
-def parse_backtrace(exc: BaseException, root_directory: str) -> List[Dict[str, Any]]:
-    frames: List[Dict[str, Any]] = []
-    tb_frames = traceback.extract_tb(exc.__traceback__)
-
-    for index, frame in enumerate(tb_frames):
-        file = frame.filename
-        frames.append(
-            {
-                "file": _relative_file(file, root_directory),
-                "line": frame.lineno,
-                "function": frame.name,
-                "in_app": _is_in_app(file, root_directory),
-                "index": index,
-            }
-        )
-
-    return frames
-
-
-def _relative_file(file: Optional[str], root: str) -> Optional[str]:
-    if not file:
-        return file
-    if not root:
-        return file
-    normalized = root if root.endswith(os.sep) else root + os.sep
-    if file.startswith(normalized):
-        return file[len(normalized):]
-    return file
-
-
-def _is_in_app(file: Optional[str], root: str) -> bool:
-    if not file or not root:
-        return False
-    if "site-packages" in file:
-        return False
-    if file.startswith("<"):
-        return False
-    return file.startswith(root)

errorgap-0.1.0/src/errorgap/version.py

@@ -1 +0,0 @@
-VERSION = "0.1.0"

errorgap-0.1.0/tests/test_backtrace.py

@@ -1,34 +0,0 @@
-from __future__ import annotations
-
-import os
-
-from errorgap.backtrace import parse_backtrace
-
-
-def _raise_and_capture() -> Exception:
-    try:
-        raise ValueError("boom")
-    except Exception as exc:
-        return exc
-
-
-def test_parses_frames():
-    exc = _raise_and_capture()
-    frames = parse_backtrace(exc, os.getcwd())
-    assert len(frames) >= 1
-    top = frames[0]
-    assert top["function"] == "_raise_and_capture"
-    assert top["line"] > 0
-    assert "test_backtrace" in (top["file"] or "")
-    assert top["index"] == 0
-
-
-def test_in_app_marks_files_under_root():
-    exc = _raise_and_capture()
-    frames = parse_backtrace(exc, os.getcwd())
-    assert frames[0]["in_app"] is True
-
-
-def test_empty_for_exception_without_traceback():
-    exc = ValueError("no tb")
-    assert parse_backtrace(exc, os.getcwd()) == []