gradual-sdk 0.1.0

Gradual feature flag SDK for Python

Gradual Python SDK

The official Python SDK for Gradual feature flags.

Installation

pip install gradual-sdk

Quick Start

from gradual import create_gradual, GradualOptions

client = create_gradual(GradualOptions(
    api_key="gra_xxx",
    environment="production",
))
client.wait_until_ready()

if client.is_enabled("new-feature"):
    # new code path
    pass

theme = client.get("theme", fallback="dark")

client.identify({"user": {"id": "user-123", "plan": "pro"}})
client.close()

API Reference

• create_gradual(options: GradualOptions) -- Create and return a new Gradual client instance.
• client.wait_until_ready() -- Block until the client has fetched its initial flag configuration.
• client.is_enabled(flag: str) -> bool -- Check whether a boolean feature flag is enabled.
• client.get(flag: str, fallback=None) -- Get the value of a feature flag, returning fallback if the flag is not found.
• client.identify(context: dict) -- Set the evaluation context (e.g. user attributes) for subsequent flag checks.
• client.close() -- Shut down the client and release resources.

Development

Install the package in development mode with test dependencies:

pip install -e ".[dev]"

Run the tests:

PYTHONPATH=src pytest tests/ -v

License

MIT