simple-module-feature-flags 0.0.9

Simple feature-flag module with per-tenant overrides and a consumer API for simple_module

simple_module_feature_flags

Feature flags for simple_module apps. Global flags with per-tenant overrides, a tiny consumer API, and no external service to run.

Install

pip install simple_module_feature_flags

What it provides

• Flag and TenantFlagOverride SQLModel tables.
• is_enabled("flag.name", tenant_id=...) consumer API.
• Admin UI at /feature-flags/admin — toggle flags, add tenant overrides.
• Cache layer so checking a flag on every request is cheap.

Usage

Gate a route:

from feature_flags import is_enabled   # type: ignore[import-not-found]
from fastapi import APIRouter, Depends, HTTPException

router = APIRouter()


@router.get("/new-feature")
async def new_feature(tenant_id: int = Depends(current_tenant_id)):
    if not await is_enabled("orders.new_pricing_engine", tenant_id=tenant_id):
        raise HTTPException(404)
    return {"rolled_out": True}

Seed a flag in a migration or admin UI:

# via migration
Flag(name="orders.new_pricing_engine", enabled=False)

Tenant override:

TenantFlagOverride(tenant_id=7, flag_name="orders.new_pricing_engine", enabled=True)

Depends on

• simple_module_core, simple_module_db, simple_module_hosting

License

MIT — see LICENSE.