iii-sdk 0.8.0

III SDK for Python

iii-sdk

Python SDK for the iii engine.

Install

pip install iii-sdk

Hello World

import asyncio
from iii import init

async def main():
    iii = init("ws://localhost:49134")

    async def greet(data):
        return {"message": f"Hello, {data['name']}!"}

    iii.register_function("greet", greet)

    iii.register_trigger(
        type="http",
        function_id="greet",
        config={"api_path": "/greet", "http_method": "POST"}
    )

    result = await iii.trigger("greet", {"name": "world"})
    print(result)

asyncio.run(main())

API

Operation	Signature	Description
Initialize	init(url, options?)	Create an SDK instance and auto-connect
Register function	iii.register_function(id, handler)	Register a function that can be invoked by name
Register trigger	iii.register_trigger(type, function_id, config)	Bind a trigger (HTTP, cron, queue, etc.) to a function
Invoke (await)	await iii.trigger(id, data)	Invoke a function and wait for the result
Invoke (fire-and-forget)	iii.trigger_void(id, data)	Invoke a function without waiting (fire-and-forget)

init() must be called inside an async context. It creates the SDK instance and auto-connects to the engine.

Registering Functions

async def create_order(data):
    return {"status_code": 201, "body": {"id": "123", "item": data["body"]["item"]}}

iii.register_function("orders.create", create_order)

Registering Triggers

iii.register_trigger(
    type="http",
    function_id="orders.create",
    config={"api_path": "/orders", "http_method": "POST"}
)

Invoking Functions

result = await iii.trigger("orders.create", {"body": {"item": "widget"}})

iii.trigger_void("analytics.track", {"event": "page_view"})

Modules

Import	What it provides
iii	Core SDK (III, types)
iii.stream	Stream client for real-time state
iii.telemetry	OpenTelemetry integration

Development

Install in development mode

pip install -e .

Type checking

mypy src

Linting

ruff check src

Deprecated

call() and call_void() are deprecated aliases for trigger() and trigger_void(). They still work but will be removed in a future release.

Resources

• Documentation
• iii Engine
• Examples