tackbox-report (Python)
Direct error-reporting helpers for Python applications using Sentry or
GlitchTip. A thin wrapper over sentry-sdk. An empty DSN makes every call a
log-only no-op, so a repo can adopt the API before any Sentry/GlitchTip
endpoint exists.
This is one runtime arm of tackbox. The linter recognizes these helpers as one
valid report outcome; propagating the error or carrying an explained local
exception stays valid too. The linter ships separately as the tackbox
distribution; installing this helper does not pull the linter, and vice versa.
Install
pip install tackbox-report
Distribution tackbox-report, import package tackbox_report. Requires
Python 3.11+ and sentry-sdk 2.x.
Use
import tackbox_report as report
report.init(report.dsn_from_env()) # empty DSN -> log-only no-op
report.set_notifier(on_notice) # user-lane sink; None clears it
report.report_error("db write failed", cause=exc, dedup_key="vault.save")
report.report_warn("cache miss", cause=exc, dedup_key="cache.read")
report.report_quiet("degraded, fell back", cause=exc, dedup_key="idx.stale")
report.notify("you appear to be offline", cause=exc, dedup_key="conn.offline")
report.report_panic("ipc-loop", recovered) # fatal, fingerprint panic:<name>
report.crumb("ipc", "frame decoded")
report_error and report_warn feed the local log, the user lane, and Sentry
capture; report_quiet skips the user lane; notify feeds only the user lane;
report_panic feeds all three. set_notifier registers a
Callable[[Notice], None] and None clears it; Notice carries msg,
level, dedup_key, cause, and tags, and the app owns rendering and any
coalescing keyed on dedup_key.
Runtime contract
Lane routing, telemetry dedup, panic grouping, and capture isolation are the
shared cross-language contract, documented in
docs/report-contracts.md.
See DESIGN.md for the Python implementation choices.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file tackbox_report-0.2.0.tar.gz.
File metadata
- Download URL: tackbox_report-0.2.0.tar.gz
- Upload date:
- Size: 9.9 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.13
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
643f207de8d0c3242b808544f30f59b4dcf36cb8c3689800a4395daa9cd9007d
|
|
| MD5 |
afd14b215c43e77fb79d96efb28a3b1f
|
|
| BLAKE2b-256 |
c10db70f9384173441cdcd9bceae0d8a74649f7fdcf351ead4c85f455faccac9
|
Provenance
The following attestation bundles were made for tackbox_report-0.2.0.tar.gz:
Publisher:
publish-report-py.yml on nikitatsym/tackbox
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
tackbox_report-0.2.0.tar.gz -
Subject digest:
643f207de8d0c3242b808544f30f59b4dcf36cb8c3689800a4395daa9cd9007d - Sigstore transparency entry: 2204703182
- Sigstore integration time:
-
Permalink:
nikitatsym/tackbox@63812e1a8afef53534065e782cac322b59e4faa4 -
Branch / Tag:
refs/tags/report-py-v0.2.0 - Owner: https://github.com/nikitatsym
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish-report-py.yml@63812e1a8afef53534065e782cac322b59e4faa4 -
Trigger Event:
push
-
Statement type:
File details
Details for the file tackbox_report-0.2.0-py3-none-any.whl.
File metadata
- Download URL: tackbox_report-0.2.0-py3-none-any.whl
- Upload date:
- Size: 7.1 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.13
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
abad019a78a420e1840592a62cad1e15f9a39adccfb5c0b71054529e070b70fa
|
|
| MD5 |
de16ee3270c6ed5d9805ad4c10e5ed56
|
|
| BLAKE2b-256 |
227c7c27d1547eb64b2f348711d0decb07f8a3c426d410f565e511f2b4c0844a
|
Provenance
The following attestation bundles were made for tackbox_report-0.2.0-py3-none-any.whl:
Publisher:
publish-report-py.yml on nikitatsym/tackbox
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
tackbox_report-0.2.0-py3-none-any.whl -
Subject digest:
abad019a78a420e1840592a62cad1e15f9a39adccfb5c0b71054529e070b70fa - Sigstore transparency entry: 2204703186
- Sigstore integration time:
-
Permalink:
nikitatsym/tackbox@63812e1a8afef53534065e782cac322b59e4faa4 -
Branch / Tag:
refs/tags/report-py-v0.2.0 - Owner: https://github.com/nikitatsym
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish-report-py.yml@63812e1a8afef53534065e782cac322b59e4faa4 -
Trigger Event:
push
-
Statement type:
