litestar-flags 0.1.1

Production-ready feature flags library for Litestar

litestar-flags

Production-ready feature flags for Litestar applications.

Installation

uv add litestar-flags

# With extras
uv add litestar-flags[redis]      # Redis backend
uv add litestar-flags[database]   # SQLAlchemy backend
uv add litestar-flags[workflows]  # Approval workflows
uv add litestar-flags[all]        # Everything

Quick Start

from litestar import Litestar, get
from litestar_flags import FeatureFlagsPlugin, FeatureFlagsConfig, FeatureFlagsClient

config = FeatureFlagsConfig()
plugin = FeatureFlagsPlugin(config=config)

@get("/")
async def index(feature_flags: FeatureFlagsClient) -> dict:
    if await feature_flags.is_enabled("new_checkout"):
        return {"flow": "new"}
    return {"flow": "legacy"}

app = Litestar(plugins=[plugin])

Features

• Multiple backends - Memory, Redis, and SQLAlchemy storage
• Percentage rollouts - Gradual releases with consistent hashing
• User targeting - Rules based on user attributes
• A/B testing - Weighted variants for experiments
• Time-based rules - Scheduled launches and maintenance windows
• OpenFeature support - Vendor-agnostic evaluation via OpenFeature SDK
• Approval workflows - Human-in-the-loop governance for enterprise use

Documentation

Full docs at flags.litestar.scriptr.dev.

Development

git clone https://github.com/JacobCoffee/litestar-flags.git
cd litestar-flags
uv sync --all-extras
uv run pytest

License

MIT