liteguard 0.2.20260314

Feature guards, observability, and security response in a single import — evaluated locally, zero network overhead per check

Liteguard Python SDK

Installation

pip install liteguard

Requires Python 3.9+.

Quick Start

from liteguard import ClientOptions, LiteguardClient

client = LiteguardClient(
    "pckid-...",
    ClientOptions(environment="production"),
)
client.start()

scope = client.create_scope({"user_id": "user-123", "plan": "pro"})

if scope.is_open("payments.checkout"):
    ...

client.shutdown()

Primary API

• LiteguardClient(project_client_key_id, options) creates a client.
• client.start() fetches the initial bundle and starts refresh and flush workers.
• client.create_scope(properties=None) creates an immutable request scope.
• scope.is_open(name, options=None) evaluates a guard locally.
• scope.execute_if_open(name, fn, options=None) measures guarded execution.
• scope.bind_protected_context(protected_context) returns a derived protected scope.
• client.flush_signals() flushes buffered telemetry.
• client.shutdown() flushes and stops background workers.

Notes

• Guard evaluation is fully local after the initial fetch.
• Scopes are immutable and request-scoped.
• contextvars keep overlapping async request scopes isolated.
• Unadopted guards default open and emit no signals.

Development

make test-python

License

Apache 2.0 — see LICENSE.