booboo-sdk 0.11.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).

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().

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