opendecree 0.4.0a1

Python SDK for OpenDecree — schema-driven configuration management (alpha)

OpenDecree Python SDK

Python SDK for OpenDecree — schema-driven configuration management.

Alpha — This SDK is under active development. APIs and behavior may change without notice between versions.

Install

pip install opendecree

Quick Start

from opendecree import ConfigClient

with ConfigClient("localhost:9090", subject="myapp") as client:
    # Get config values (default: string)
    fee = client.get("tenant-id", "payments.fee")

    # Typed gets via overload
    retries = client.get("tenant-id", "payments.retries", int)
    enabled = client.get("tenant-id", "payments.enabled", bool)

    # Set values
    client.set("tenant-id", "payments.fee", "0.5%")

Watch for Changes

with ConfigClient("localhost:9090", subject="myapp") as client:
    with client.watch("tenant-id") as watcher:
        fee = watcher.field("payments.fee", float, default=0.01)
        enabled = watcher.field("payments.enabled", bool, default=False)

        if enabled:
            print(f"Current fee: {fee.value}")

        @fee.on_change
        def on_fee_change(old: float, new: float):
            print(f"Fee changed: {old} -> {new}")

Async

from opendecree import AsyncConfigClient

async with AsyncConfigClient("localhost:9090", subject="myapp") as client:
    val = await client.get("tenant-id", "payments.fee")
    retries = await client.get("tenant-id", "payments.retries", int)

Documentation

Full documentation, including guides and the API reference, is published at opendecree.github.io/decree-python:

• Connecting — client options (auth, TLS, retry, timeouts, error handling)
• Watching — live subscriptions and change patterns
• Async Usage — async client and watcher
• API Reference — full auto-generated API docs

For detailed concepts (schemas, typed values, versioning, auth), see the main OpenDecree docs.

Typing

This package is fully typed. It ships a py.typed marker and .pyi stub files for the generated gRPC layer, so mypy, pyright, and similar tools work without additional configuration.

Requirements

• Python 3.11+
• A running OpenDecree server (v0.8.0 – v0.x, pre-1.0)

License

Apache License 2.0 — see LICENSE.