Skip to main content

Python SDK API Reference

Complete API documentation for TealTiger Python SDK v1.1.x with Enterprise Adoption Features.

Installation

pip install tealtiger

Quick Start

from tealtiger import TealEngine, PolicyMode, ExecutionContext

# Create engine with policy mode configuration
engine = TealEngine(
    mode={
        "default": PolicyMode.ENFORCE,
        "overrides": {
            "cost-limit": PolicyMode.MONITOR
        }
    }
)

# Create execution context for traceability
context = ExecutionContext.create(
    actor={"id": "user-123", "type": "user"}
)

# Evaluate with context
decision = await engine.evaluate(request, context)

Enterprise Features (v1.1.x)

Core Modules

SDK Features

The Python SDK v1.1.x includes all enterprise features with full parity to TypeScript:
  • Policy Rollout Modes - ENFORCE, MONITOR, REPORT_ONLY for gradual rollout
  • Deterministic Decision Contract - Stable typed Decision object with versioning
  • Execution Context - Correlation IDs and traceability for distributed systems
  • Audit Logging - Versioned audit events with security-by-default redaction
  • Policy Test Harness - CLI/library test runner for CI/CD integration