liteguard 0.7.20260603

Feature guards, observability, and security response in a single import. Evaluated locally with zero network overhead per check

Liteguard Python SDK

• Website: liteguard.io
• Project Page: https://github.com/liteguard/liteguard
• Issues: https://github.com/liteguard/liteguard/issues/new

Installation

pip install liteguard

Requires Python 3.9+.

Quick Start

from liteguard import ClientOptions, LiteguardClient

client = LiteguardClient(
    "pct-...",
    ClientOptions(environment="env-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_token, 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.evaluate(name, options=None) returns a GuardDecision with the full evaluation result.
• scope.execute_if_open(name, fn, options=None) measures guarded execution.
• scope.start_execution() creates an execution correlation handle.
• scope.bind_protected_context(protected_context) returns a derived protected scope.
• scope.get_properties() returns the current property bag for transport.
• client.flush_signals() flushes buffered telemetry.
• client.shutdown() flushes and stops background workers.

Convenience helpers

For server applications that want request-scoped context propagation:

• client.run_with_scope(scope, fn) runs fn with scope as the active scope, propagated across async boundaries via contextvars.
• client.get_active_scope() returns the scope bound to the current request.
• client.with_properties(properties, fn) derives and activates a scope with additional properties.
• client.with_protected_context(protected_context, fn) derives and activates a protected scope.

Notes

• Guard evaluation is fully local after the initial fetch.
• Protected contexts use properties, signature, and optional issued_at / expires_at fields.
• Scopes are immutable and request-scoped.
• contextvars keep overlapping async request scopes isolated.
• Unadopted guards default open and emit no signals.
• The convenience helpers above also serve as infrastructure for auto-instrumentation of third-party dependencies. See the Liteguard CLI for build-time instrumentation.

Development

make test-python

License

Apache 2.0 see LICENSE.