booboo-sdk 0.12.0

Lightweight error tracking for Python

booboo-sdk

Official Python SDK for booboo.dev error tracking.

Installation

pip install booboo-sdk

Quick Start

import booboo

booboo.init("your-dsn-here")

That's it. Unhandled exceptions are automatically captured and sent to booboo.dev.

Manual Capture

try:
    risky_operation()
except Exception:
    booboo.capture_exception()  # captures the current exception

Or pass an exception explicitly:

try:
    risky_operation()
except Exception as e:
    booboo.capture_exception(e)

User Context

booboo.set_user({
    "id": "123",
    "email": "[e-mail]",
    "username": "alice",
})

Framework Integration

Django

Auto-detected — no extra setup needed. The SDK injects middleware and patches Django's internal exception handler to capture errors that never reach middleware (like DisallowedHost). 404 errors are filtered by default.

Flask

from flask import Flask
import booboo

app = Flask(__name__)
booboo.init("your-dsn-here", app=app)

Or without passing app — the SDK monkey-patches Flask.__init__ to auto-register on any Flask app created after init(). 404 errors are filtered by default.

FastAPI

from fastapi import FastAPI
import booboo

app = FastAPI()
booboo.init("your-dsn-here", app=app)

Same auto-detection as Flask if app is not passed explicitly.

Configuration

booboo.init(
    dsn="your-dsn-here",
    environment="production",
    ignore_errors=[KeyboardInterrupt, ConnectionError],
)

Parameter	Default	Description
dsn	(required)	Your project's DSN from booboo.dev
app	None	Flask/FastAPI app instance for explicit registration
environment	""	Environment name (e.g. "production", "staging"). Attached to every event.
ignore_errors	None	List of exception classes to suppress. Uses isinstance() so subclasses are matched.
endpoint	https://api.booboo.dev/ingest/	Ingestion endpoint URL

Features

• Automatic capture of unhandled exceptions
• Rich stack traces with source context and local variables
• Exception chain support (raise ... from ...)
• PII scrubbing for sensitive headers and variables
• Django, Flask, and FastAPI integrations
• Non-blocking event delivery
• Graceful shutdown flush
• Minimal dependency footprint (requests only)

License

MIT