blipit 0.1.0__tar.gz

blipit-0.1.0/.gitignore

@@ -0,0 +1,12 @@
+node_modules/
+dist/
+.next/
+.env
+.env.*
+!.env.example
+*.log
+.DS_Store
+*.tsbuildinfo
+.vercel
+.env*
+.claude/worktrees/

blipit-0.1.0/PKG-INFO

@@ -0,0 +1,55 @@
+Metadata-Version: 2.5
+Name: blipit
+Version: 0.1.0
+Summary: Blipit error monitoring for Python: Django, Flask, FastAPI, Celery and scripts. Know your app broke before your users tell you.
+Project-URL: Homepage, https://blipit.io
+Project-URL: Documentation, https://docs.blipit.io/python
+Project-URL: Changelog, https://blipit.io/changelog
+Author-email: Louward Labs <support@blipit.io>
+License-Expression: MIT
+Keywords: blipit,django,error-monitoring,errors,fastapi,flask,logging
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: System :: Monitoring
+Requires-Python: >=3.8
+Requires-Dist: sentry-sdk>=2.0
+Description-Content-Type: text/markdown
+
+# blipit
+
+Blipit error monitoring for Python. Know your app broke before your users tell you.
+
+## Install
+
+```sh
+pip install blipit
+```
+
+## Quick start
+
+Call `init` once at startup, before the app is created. For Django, put it at the top of `settings.py`.
+
+```python
+import blipit
+
+blipit.init(key="<public key>", project=<project id>, environment="production", release="myapp@1.4.2")
+```
+
+Both values are on the project's Keys page at app.blipit.io. Unhandled exceptions are reported on their own; Django, Flask, FastAPI, Celery, SQLAlchemy and other integrations are detected automatically.
+
+## Manual capture
+
+```python
+blipit.capture_exception(err)
+blipit.capture_message("cache miss rate above 50%", level="warning")
+blipit.set_user({"id": "42", "email": "ana@example.com"})
+blipit.set_tag("region", "ap-southeast-1")
+```
+
+## Performance
+
+Pass `traces_sample_rate=0.2` to `init` and requests show up on the Performance page.
+
+Docs: https://docs.blipit.io/python

blipit-0.1.0/README.md

@@ -0,0 +1,36 @@
+# blipit
+
+Blipit error monitoring for Python. Know your app broke before your users tell you.
+
+## Install
+
+```sh
+pip install blipit
+```
+
+## Quick start
+
+Call `init` once at startup, before the app is created. For Django, put it at the top of `settings.py`.
+
+```python
+import blipit
+
+blipit.init(key="<public key>", project=<project id>, environment="production", release="myapp@1.4.2")
+```
+
+Both values are on the project's Keys page at app.blipit.io. Unhandled exceptions are reported on their own; Django, Flask, FastAPI, Celery, SQLAlchemy and other integrations are detected automatically.
+
+## Manual capture
+
+```python
+blipit.capture_exception(err)
+blipit.capture_message("cache miss rate above 50%", level="warning")
+blipit.set_user({"id": "42", "email": "ana@example.com"})
+blipit.set_tag("region", "ap-southeast-1")
+```
+
+## Performance
+
+Pass `traces_sample_rate=0.2` to `init` and requests show up on the Performance page.
+
+Docs: https://docs.blipit.io/python

blipit-0.1.0/blipit/__init__.py

@@ -0,0 +1,75 @@
+from __future__ import annotations
+
+from typing import Any, Optional
+
+import sentry_sdk
+from sentry_sdk import add_breadcrumb, capture_exception, capture_message, set_tag, set_user
+
+DEFAULT_ENDPOINT = "https://in.blipit.io"
+
+__all__ = [
+    "init",
+    "capture_exception",
+    "capture_message",
+    "capture_security",
+    "set_user",
+    "set_tag",
+    "add_breadcrumb",
+    "flush",
+]
+
+
+def dsn(key: str, project: int | str, endpoint: str = DEFAULT_ENDPOINT) -> str:
+    host = endpoint.split("://", 1)[-1].rstrip("/")
+    scheme = "http" if endpoint.startswith("http://") else "https"
+    return f"{scheme}://{key}@{host}/{project}"
+
+
+def init(
+    key: str,
+    project: int | str,
+    environment: Optional[str] = None,
+    release: Optional[str] = None,
+    traces_sample_rate: float = 0.0,
+    endpoint: str = DEFAULT_ENDPOINT,
+    **options: Any,
+) -> None:
+    if not key:
+        raise ValueError("blipit.init needs the project's public key")
+    options.setdefault("send_default_pii", False)
+    sentry_sdk.init(
+        dsn=dsn(key, project, endpoint),
+        environment=environment,
+        release=release,
+        traces_sample_rate=traces_sample_rate,
+        **options,
+    )
+
+
+def capture_security(
+    kind: str,
+    actor: str,
+    outcome: Optional[str] = None,
+    actor_id: Optional[str] = None,
+    ip: Optional[str] = None,
+    user_agent: Optional[str] = None,
+    target: Optional[str] = None,
+) -> None:
+    payload = {
+        "kind": kind,
+        "actor": actor,
+        "outcome": outcome,
+        "actor_id": actor_id,
+        "ip": ip,
+        "user_agent": user_agent,
+        "target": target,
+    }
+    with sentry_sdk.new_scope() as scope:
+        scope.set_context("security", {k: v for k, v in payload.items() if v is not None})
+        scope.set_tag("security.kind", kind)
+        level = "warning" if kind in ("login_failed", "login_blocked") else "info"
+        capture_message(f"{kind} for {actor}", level=level)
+
+
+def flush(timeout: float = 2.0) -> None:
+    sentry_sdk.flush(timeout)

blipit-0.1.0/pyproject.toml

@@ -0,0 +1,29 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "blipit"
+version = "0.1.0"
+description = "Blipit error monitoring for Python: Django, Flask, FastAPI, Celery and scripts. Know your app broke before your users tell you."
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.8"
+authors = [{ name = "Louward Labs", email = "support@blipit.io" }]
+keywords = ["error-monitoring", "errors", "logging", "blipit", "django", "flask", "fastapi"]
+classifiers = [
+  "Development Status :: 4 - Beta",
+  "Intended Audience :: Developers",
+  "License :: OSI Approved :: MIT License",
+  "Programming Language :: Python :: 3",
+  "Topic :: System :: Monitoring",
+]
+dependencies = ["sentry-sdk>=2.0"]
+
+[project.urls]
+Homepage = "https://blipit.io"
+Documentation = "https://docs.blipit.io/python"
+Changelog = "https://blipit.io/changelog"
+
+[tool.hatch.build.targets.wheel]
+packages = ["blipit"]

blipit-0.1.0/tests/test_blipit.py

@@ -0,0 +1,45 @@
+import json
+import threading
+import zlib
+from http.server import BaseHTTPRequestHandler, HTTPServer
+
+import blipit
+
+received = []
+
+
+class Handler(BaseHTTPRequestHandler):
+    def do_POST(self):
+        body = self.rfile.read(int(self.headers.get("Content-Length", 0)))
+        if self.headers.get("Content-Encoding") == "gzip":
+            body = zlib.decompress(body, 16 + zlib.MAX_WBITS)
+        received.append((self.path, body))
+        self.send_response(200)
+        self.end_headers()
+        self.wfile.write(b"{}")
+
+    def log_message(self, *args):
+        pass
+
+
+def test_events_reach_blipit():
+    srv = HTTPServer(("127.0.0.1", 0), Handler)
+    threading.Thread(target=srv.serve_forever, daemon=True).start()
+    port = srv.server_address[1]
+    assert blipit.dsn("blipit_pk_abc", 7) == "https://blipit_pk_abc@in.blipit.io/7"
+    blipit.init(key="blipit_pk_abc", project=7, environment="test", endpoint=f"http://127.0.0.1:{port}")
+    blipit.capture_message("hello from python")
+    blipit.flush()
+    assert received, "nothing was sent"
+    path, body = received[0]
+    assert path == "/api/7/envelope/"
+    lines = body.decode().split("\n")
+    event = json.loads(lines[2])
+    assert event["message"] == "hello from python"
+    assert event["environment"] == "test"
+    srv.shutdown()
+    print("python sdk ok")
+
+
+if __name__ == "__main__":
+    test_events_reach_blipit()