blipit 0.1.0__py3-none-any.whl

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.dist-info/METADATA

@@ -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.dist-info/RECORD

@@ -0,0 +1,4 @@
+blipit/__init__.py,sha256=1_nNtoNXVzbtz5QwO2tRm4hGijMoiovkHGxVyDCODko,2034
+blipit-0.1.0.dist-info/METADATA,sha256=YDUEu6TCgDYJjZf6bBT9WKs8SJNvDmxN1e-JpzGIf38,1770
+blipit-0.1.0.dist-info/WHEEL,sha256=W3fkpkm7-wf9vBI5Z-7s0eWkeM-spu78I8Neb98DeEg,87
+blipit-0.1.0.dist-info/RECORD,,

blipit-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.32.4
+Root-Is-Purelib: true
+Tag: py3-none-any