tailcove 0.1.0__tar.gz

tailcove-0.1.0/.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,59 @@
+name: Bug report
+description: Something in tailcove isn't working as expected.
+labels: [bug]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for taking the time to report this. The more detail you give, the faster we can fix it.
+
+        **Never paste your ingest token or browser key.** Replace it with `***`.
+  - type: textarea
+    id: what-happened
+    attributes:
+      label: What happened?
+      description: Tell us what you saw, and what you expected to see instead.
+    validations:
+      required: true
+  - type: textarea
+    id: reproduce
+    attributes:
+      label: How can we reproduce it?
+      description: The smallest code or steps that show the problem.
+      render: python
+    validations:
+      required: true
+  - type: input
+    id: version
+    attributes:
+      label: tailcove version
+      placeholder: "0.1.1"
+    validations:
+      required: true
+  - type: input
+    id: runtime
+    attributes:
+      label: Python version
+      placeholder: "3.12.4"
+    validations:
+      required: true
+  - type: input
+    id: framework
+    attributes:
+      label: Framework (optional)
+      placeholder: "Django 5.1, Flask 3.0"
+  - type: textarea
+    id: logs
+    attributes:
+      label: Errors or output
+      description: Any error message, stack trace or console output. This is formatted as code automatically.
+      render: shell
+  - type: checkboxes
+    id: checks
+    attributes:
+      label: Before submitting
+      options:
+        - label: I searched existing issues and didn't find a duplicate.
+          required: true
+        - label: I removed any tokens, keys and private data from this report.
+          required: true

tailcove-0.1.0/.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,8 @@
+blank_issues_enabled: false
+contact_links:
+  - name: Documentation
+    url: https://tailcove.dev/docs/sending-logs/python
+    about: Setup guides and answers to common questions.
+  - name: Security vulnerability
+    url: mailto:security@tailcove.dev
+    about: Please email us privately instead of opening a public issue.

tailcove-0.1.0/.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,30 @@
+name: Feature request
+description: Suggest an improvement to tailcove.
+labels: [enhancement]
+body:
+  - type: textarea
+    id: problem
+    attributes:
+      label: What problem are you trying to solve?
+      description: Describe what you're trying to do and where tailcove gets in the way.
+    validations:
+      required: true
+  - type: textarea
+    id: solution
+    attributes:
+      label: What would you like to see?
+      description: How you imagine it working. Example code is welcome.
+    validations:
+      required: true
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Alternatives you've considered
+      description: Other approaches or workarounds you've tried.
+  - type: checkboxes
+    id: checks
+    attributes:
+      label: Before submitting
+      options:
+        - label: I searched existing issues and didn't find a duplicate.
+          required: true

tailcove-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,58 @@
+name: publish
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+permissions:
+  contents: read
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: '3.12'
+
+      - name: Check tag matches package version
+        run: |
+          version="$(python -c "import tomllib; print(tomllib.load(open('pyproject.toml','rb'))['project']['version'])")"
+          if [ "v$version" != "$GITHUB_REF_NAME" ]; then
+            echo "Tag $GITHUB_REF_NAME does not match pyproject.toml version $version" >&2
+            exit 1
+          fi
+
+      - name: Test
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install -e '.[dev]'
+          python -m pytest
+
+      - name: Build
+        run: |
+          python -m pip install build twine
+          python -m build
+          python -m twine check dist/*
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  publish:
+    needs: build
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+      - uses: pypa/gh-action-pypi-publish@release/v1

tailcove-0.1.0/.gitignore

@@ -0,0 +1,6 @@
+__pycache__/
+*.egg-info/
+.pytest_cache/
+.venv/
+dist/
+build/

tailcove-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Akcybex
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

tailcove-0.1.0/PKG-INFO

@@ -0,0 +1,201 @@
+Metadata-Version: 2.5
+Name: tailcove
+Version: 0.1.0
+Summary: Python client for shipping application logs to Tailcove — a stdlib logging.Handler that batches and ships NDJSON.
+Project-URL: Homepage, https://tailcove.dev
+Project-URL: Documentation, https://tailcove.dev/docs/sending-logs/python
+Project-URL: Source, https://github.com/tailcove/python
+Project-URL: Issues, https://github.com/tailcove/python/issues
+Author-email: Akcybex <developers@akcybex.com>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: logging,monolog,ndjson,tailcove
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: System :: Logging
+Classifier: Typing :: Typed
+Requires-Python: >=3.9
+Provides-Extra: dev
+Requires-Dist: pytest>=7; extra == 'dev'
+Description-Content-Type: text/markdown
+
+<h1 align="center">tailcove</h1>
+
+<p align="center">
+  Send Python logs to <a href="https://tailcove.dev">Tailcove</a> with the standard <code>logging</code> module.<br>
+  One handler, no dependencies, and it never slows down your code.
+</p>
+
+<p align="center">
+  <a href="https://pypi.org/project/tailcove/"><img alt="PyPI version" src="https://img.shields.io/pypi/v/tailcove?color=2DD4BF&labelColor=0A0A0A"></a>
+  <a href="https://pypi.org/project/tailcove/"><img alt="Python versions" src="https://img.shields.io/pypi/pyversions/tailcove?color=2DD4BF&labelColor=0A0A0A"></a>
+  <a href="https://pypi.org/project/tailcove/"><img alt="PyPI downloads" src="https://img.shields.io/pypi/dm/tailcove?color=2DD4BF&labelColor=0A0A0A"></a>
+  <a href="LICENSE"><img alt="MIT license" src="https://img.shields.io/badge/license-MIT-2DD4BF?labelColor=0A0A0A"></a>
+</p>
+
+<p align="center">
+  <a href="https://tailcove.dev/docs/sending-logs/python">Documentation</a> ·
+  <a href="https://github.com/tailcove/python/issues">Report a bug</a> ·
+  <a href="https://app.tailcove.dev/register">Get started free</a>
+</p>
+
+---
+
+## Why use it
+
+- **Plain `logging`.** `TailcoveHandler` is a normal `logging.Handler`. Keep the loggers you already have.
+- **Never blocks.** Records are batched and sent from a background thread, so a request or a hot loop never waits on the network.
+- **No dependencies.** Delivery uses `urllib` from the standard library.
+- **Safe.** A failed delivery is caught and never raised into your code.
+- **Structured exceptions.** Log an exception and it arrives as data (class, message, location, trace), so identical errors group together.
+
+## Install
+
+```bash
+pip install tailcove
+```
+
+Requires Python 3.9 or newer.
+
+## Quick start
+
+**1. Get a token.** Create a source in your [Tailcove dashboard](https://app.tailcove.dev) and copy its ingest token. It is shown only once, so save it somewhere safe (an environment variable is ideal).
+
+**2. Add the handler.**
+
+```python
+import logging
+import os
+
+from tailcove import TailcoveHandler
+
+logger = logging.getLogger("myapp")
+logger.addHandler(TailcoveHandler(token=os.environ["TAILCOVE_TOKEN"]))
+logger.setLevel(logging.INFO)
+
+logger.info("user signed up", extra={"user_id": 42})
+logger.error("payment failed", extra={"order_id": 99, "reason": "card_declined"})
+```
+
+**3. Open Tailcove.** Your records appear in search and live tail within a couple of seconds.
+
+Buffered records are flushed when your program exits normally, because Python's own `logging.shutdown()` closes every handler.
+
+## Options
+
+| Argument | Default | What it does |
+|---|---|---|
+| `token` | — | Your source's ingest token. **Required.** |
+| `endpoint` | `https://ingest.tailcove.dev/api/v1/logs` | The ingest URL. Only change this if you self-host. |
+| `batch_size` | `50` | Send once this many records are buffered. |
+| `batch_seconds` | `2.0` | Send once this many seconds have passed since the first buffered record. |
+| `timeout` | `2.0` | Seconds a delivery attempt may take before giving up. |
+| `trace_limit` | `10` | Most stack frames kept when a logged exception is rendered. |
+| `level` | `logging.NOTSET` | Lowest level this handler processes, on top of the logger's own level. |
+
+Records are sent once `batch_size` is reached or `batch_seconds` has passed, whichever comes first. They are never sent one HTTP request per log call. To send whatever is buffered right now, call `handler.flush()`. It blocks until the background thread confirms.
+
+## Structured context
+
+Anything you pass in `extra={...}` is shipped as the line's context, with the same keys:
+
+```python
+logger.info("order placed", extra={"order_id": 99, "total_cents": 4200})
+```
+
+## Exceptions
+
+Log with `exc_info=True`, or use `logger.exception(...)` inside an `except` block, and the exception is sent as structured data and not as a flattened string:
+
+```python
+try:
+    charge_card(order)
+except CardDeclined:
+    logger.error("payment failed", exc_info=True)
+```
+
+```json
+"exception": {
+    "class": "billing.errors.CardDeclined",
+    "message": "insufficient funds",
+    "location": "/app/billing/charge.py:42",
+    "trace": [
+        "/app/billing/charge.py:42 in charge_card",
+        "/app/orders/service.py:17 in place_order"
+    ]
+}
+```
+
+`location` is where the exception was raised, and `trace` is limited to `trace_limit` frames. It's the same shape the Laravel, Node and browser libraries use, so the same error groups into one issue whichever app reported it.
+
+## Frameworks
+
+### Django
+
+Add the handler to `LOGGING` in `settings.py`:
+
+```python
+LOGGING = {
+    "version": 1,
+    "disable_existing_loggers": False,
+    "handlers": {
+        "tailcove": {
+            "class": "tailcove.TailcoveHandler",
+            "token": env("TAILCOVE_TOKEN"),
+        },
+    },
+    "root": {
+        "handlers": ["console", "tailcove"],
+        "level": "INFO",
+    },
+    "loggers": {
+        "django.request": {
+            "handlers": ["tailcove"],
+            "level": "ERROR",
+            "propagate": True,
+        },
+    },
+}
+```
+
+### Flask
+
+Attach the handler to the app logger, or to the root logger if you want every `logging.getLogger(__name__)` in the app to ship too:
+
+```python
+from flask import Flask
+from tailcove import TailcoveHandler
+
+app = Flask(__name__)
+app.logger.addHandler(TailcoveHandler(token=app.config["TAILCOVE_TOKEN"]))
+app.logger.setLevel("INFO")
+
+
+@app.errorhandler(Exception)
+def handle_exception(exc):
+    app.logger.error("unhandled exception", exc_info=exc)
+    raise
+```
+
+## When delivery fails
+
+Network errors and non-2xx responses never raise into your code. `emit()` follows the standard `Handler` convention and routes its own failures through `handleError()`. Errors on the background thread are caught and printed to stderr. Logging is best-effort by design.
+
+## Help and feedback
+
+- **Docs:** [tailcove.dev/docs/sending-logs/python](https://tailcove.dev/docs/sending-logs/python)
+- **Bugs and feature requests:** [open an issue](https://github.com/tailcove/python/issues/new/choose)
+- **Security problems:** please email **security@tailcove.dev** instead of opening a public issue.
+
+## Other Tailcove libraries
+
+[Laravel](https://github.com/tailcove/laravel) · [Node.js](https://github.com/tailcove/node) · [Browser](https://github.com/tailcove/browser)
+
+## License
+
+[MIT](LICENSE) © Akcybex

tailcove-0.1.0/README.md

@@ -0,0 +1,175 @@
+<h1 align="center">tailcove</h1>
+
+<p align="center">
+  Send Python logs to <a href="https://tailcove.dev">Tailcove</a> with the standard <code>logging</code> module.<br>
+  One handler, no dependencies, and it never slows down your code.
+</p>
+
+<p align="center">
+  <a href="https://pypi.org/project/tailcove/"><img alt="PyPI version" src="https://img.shields.io/pypi/v/tailcove?color=2DD4BF&labelColor=0A0A0A"></a>
+  <a href="https://pypi.org/project/tailcove/"><img alt="Python versions" src="https://img.shields.io/pypi/pyversions/tailcove?color=2DD4BF&labelColor=0A0A0A"></a>
+  <a href="https://pypi.org/project/tailcove/"><img alt="PyPI downloads" src="https://img.shields.io/pypi/dm/tailcove?color=2DD4BF&labelColor=0A0A0A"></a>
+  <a href="LICENSE"><img alt="MIT license" src="https://img.shields.io/badge/license-MIT-2DD4BF?labelColor=0A0A0A"></a>
+</p>
+
+<p align="center">
+  <a href="https://tailcove.dev/docs/sending-logs/python">Documentation</a> ·
+  <a href="https://github.com/tailcove/python/issues">Report a bug</a> ·
+  <a href="https://app.tailcove.dev/register">Get started free</a>
+</p>
+
+---
+
+## Why use it
+
+- **Plain `logging`.** `TailcoveHandler` is a normal `logging.Handler`. Keep the loggers you already have.
+- **Never blocks.** Records are batched and sent from a background thread, so a request or a hot loop never waits on the network.
+- **No dependencies.** Delivery uses `urllib` from the standard library.
+- **Safe.** A failed delivery is caught and never raised into your code.
+- **Structured exceptions.** Log an exception and it arrives as data (class, message, location, trace), so identical errors group together.
+
+## Install
+
+```bash
+pip install tailcove
+```
+
+Requires Python 3.9 or newer.
+
+## Quick start
+
+**1. Get a token.** Create a source in your [Tailcove dashboard](https://app.tailcove.dev) and copy its ingest token. It is shown only once, so save it somewhere safe (an environment variable is ideal).
+
+**2. Add the handler.**
+
+```python
+import logging
+import os
+
+from tailcove import TailcoveHandler
+
+logger = logging.getLogger("myapp")
+logger.addHandler(TailcoveHandler(token=os.environ["TAILCOVE_TOKEN"]))
+logger.setLevel(logging.INFO)
+
+logger.info("user signed up", extra={"user_id": 42})
+logger.error("payment failed", extra={"order_id": 99, "reason": "card_declined"})
+```
+
+**3. Open Tailcove.** Your records appear in search and live tail within a couple of seconds.
+
+Buffered records are flushed when your program exits normally, because Python's own `logging.shutdown()` closes every handler.
+
+## Options
+
+| Argument | Default | What it does |
+|---|---|---|
+| `token` | — | Your source's ingest token. **Required.** |
+| `endpoint` | `https://ingest.tailcove.dev/api/v1/logs` | The ingest URL. Only change this if you self-host. |
+| `batch_size` | `50` | Send once this many records are buffered. |
+| `batch_seconds` | `2.0` | Send once this many seconds have passed since the first buffered record. |
+| `timeout` | `2.0` | Seconds a delivery attempt may take before giving up. |
+| `trace_limit` | `10` | Most stack frames kept when a logged exception is rendered. |
+| `level` | `logging.NOTSET` | Lowest level this handler processes, on top of the logger's own level. |
+
+Records are sent once `batch_size` is reached or `batch_seconds` has passed, whichever comes first. They are never sent one HTTP request per log call. To send whatever is buffered right now, call `handler.flush()`. It blocks until the background thread confirms.
+
+## Structured context
+
+Anything you pass in `extra={...}` is shipped as the line's context, with the same keys:
+
+```python
+logger.info("order placed", extra={"order_id": 99, "total_cents": 4200})
+```
+
+## Exceptions
+
+Log with `exc_info=True`, or use `logger.exception(...)` inside an `except` block, and the exception is sent as structured data and not as a flattened string:
+
+```python
+try:
+    charge_card(order)
+except CardDeclined:
+    logger.error("payment failed", exc_info=True)
+```
+
+```json
+"exception": {
+    "class": "billing.errors.CardDeclined",
+    "message": "insufficient funds",
+    "location": "/app/billing/charge.py:42",
+    "trace": [
+        "/app/billing/charge.py:42 in charge_card",
+        "/app/orders/service.py:17 in place_order"
+    ]
+}
+```
+
+`location` is where the exception was raised, and `trace` is limited to `trace_limit` frames. It's the same shape the Laravel, Node and browser libraries use, so the same error groups into one issue whichever app reported it.
+
+## Frameworks
+
+### Django
+
+Add the handler to `LOGGING` in `settings.py`:
+
+```python
+LOGGING = {
+    "version": 1,
+    "disable_existing_loggers": False,
+    "handlers": {
+        "tailcove": {
+            "class": "tailcove.TailcoveHandler",
+            "token": env("TAILCOVE_TOKEN"),
+        },
+    },
+    "root": {
+        "handlers": ["console", "tailcove"],
+        "level": "INFO",
+    },
+    "loggers": {
+        "django.request": {
+            "handlers": ["tailcove"],
+            "level": "ERROR",
+            "propagate": True,
+        },
+    },
+}
+```
+
+### Flask
+
+Attach the handler to the app logger, or to the root logger if you want every `logging.getLogger(__name__)` in the app to ship too:
+
+```python
+from flask import Flask
+from tailcove import TailcoveHandler
+
+app = Flask(__name__)
+app.logger.addHandler(TailcoveHandler(token=app.config["TAILCOVE_TOKEN"]))
+app.logger.setLevel("INFO")
+
+
+@app.errorhandler(Exception)
+def handle_exception(exc):
+    app.logger.error("unhandled exception", exc_info=exc)
+    raise
+```
+
+## When delivery fails
+
+Network errors and non-2xx responses never raise into your code. `emit()` follows the standard `Handler` convention and routes its own failures through `handleError()`. Errors on the background thread are caught and printed to stderr. Logging is best-effort by design.
+
+## Help and feedback
+
+- **Docs:** [tailcove.dev/docs/sending-logs/python](https://tailcove.dev/docs/sending-logs/python)
+- **Bugs and feature requests:** [open an issue](https://github.com/tailcove/python/issues/new/choose)
+- **Security problems:** please email **security@tailcove.dev** instead of opening a public issue.
+
+## Other Tailcove libraries
+
+[Laravel](https://github.com/tailcove/laravel) · [Node.js](https://github.com/tailcove/node) · [Browser](https://github.com/tailcove/browser)
+
+## License
+
+[MIT](LICENSE) © Akcybex

tailcove-0.1.0/pyproject.toml

@@ -0,0 +1,41 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "tailcove"
+version = "0.1.0"
+description = "Python client for shipping application logs to Tailcove — a stdlib logging.Handler that batches and ships NDJSON."
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+requires-python = ">=3.9"
+keywords = ["logging", "tailcove", "monolog", "ndjson"]
+authors = [{ name = "Akcybex", email = "developers@akcybex.com" }]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: System :: Logging",
+    "Typing :: Typed",
+]
+dependencies = []
+
+[project.optional-dependencies]
+dev = ["pytest>=7"]
+
+[project.urls]
+Homepage = "https://tailcove.dev"
+Documentation = "https://tailcove.dev/docs/sending-logs/python"
+Source = "https://github.com/tailcove/python"
+Issues = "https://github.com/tailcove/python/issues"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/tailcove"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]

tailcove-0.1.0/src/tailcove/__init__.py

@@ -0,0 +1,5 @@
+from .handler import TailcoveHandler
+from .transport import DeliveryError
+
+__all__ = ["TailcoveHandler", "DeliveryError"]
+__version__ = "0.1.0"

tailcove-0.1.0/src/tailcove/context.py

@@ -0,0 +1,25 @@
+from __future__ import annotations
+
+import logging
+from typing import Any, Dict, FrozenSet
+
+# The stdlib `logging` module doesn't nest `extra={...}` under a key — each
+# entry lands as a top-level attribute directly on the LogRecord. To recover
+# "the extra dict" we diff a record's __dict__ against the attributes a
+# vanilla LogRecord always carries; whatever's left over is caller-supplied
+# context. Computed once from a throwaway record rather than hardcoded, so
+# it stays correct if a future Python version adds/removes a built-in field.
+_DUMMY_RECORD = logging.LogRecord(
+    name="tailcove",
+    level=logging.INFO,
+    pathname=__file__,
+    lineno=0,
+    msg="",
+    args=(),
+    exc_info=None,
+)
+RESERVED_ATTRS: FrozenSet[str] = frozenset(vars(_DUMMY_RECORD).keys()) | {"message", "asctime"}
+
+
+def extra_context(record: logging.LogRecord) -> Dict[str, Any]:
+    return {key: value for key, value in vars(record).items() if key not in RESERVED_ATTRS}

tailcove-0.1.0/src/tailcove/exceptions.py

@@ -0,0 +1,40 @@
+from __future__ import annotations
+
+import traceback
+from types import TracebackType
+from typing import Any, Dict, List, Optional, Tuple, Type
+
+ExcInfo = Tuple[Optional[Type[BaseException]], Optional[BaseException], Optional[TracebackType]]
+
+
+def format_exception(exc_info: ExcInfo, trace_limit: int = 10) -> Dict[str, Any]:
+    """
+    Renders a caught exception as structured data instead of a flat string,
+    matching the tailcove/laravel package's `{class, message, location,
+    trace}` shape so fingerprinting (Milestone 11) works identically
+    regardless of which client sent the line. `location` is the file:line
+    of the frame where the exception was actually raised (the last frame in
+    the traceback); `trace` is trimmed to `trace_limit` frames the same way
+    the Laravel package trims its stringified trace.
+    """
+    exc_type, exc_value, exc_tb = exc_info
+
+    frames = traceback.extract_tb(exc_tb)
+    location = f"{frames[-1].filename}:{frames[-1].lineno}" if frames else ""
+
+    trace: List[str] = [
+        f"{frame.filename}:{frame.lineno} in {frame.name}" for frame in frames
+    ][:trace_limit]
+
+    class_name = "UnknownException"
+    if exc_type is not None:
+        class_name = exc_type.__qualname__
+        if exc_type.__module__ not in ("builtins", "__main__"):
+            class_name = f"{exc_type.__module__}.{class_name}"
+
+    return {
+        "class": class_name,
+        "message": str(exc_value) if exc_value is not None else "",
+        "location": location,
+        "trace": trace,
+    }