iii-sdk

Python SDK for the iii engine.

Install

pip install iii-sdk

Hello World

from iii import register_worker

iii = register_worker("ws://localhost:49134")

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

iii.register_function("hello::greet", greet)

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

iii.connect()

result = iii.trigger({"function_id": "hello::greet", "payload": {"name": "world"}})
print(result)  # {"message": "Hello, world!"}

API

Operation	Signature	Description
Initialize	`register_worker(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 result)	`iii.trigger({"function_id": id, "payload": data})`	Invoke a function and wait for the result
Invoke (fire-and-forget)	`iii.trigger({"function_id": id, ..., "action": TriggerAction.Void()})`	Fire-and-forget
Invoke (enqueue)	`iii.trigger({"function_id": id, ..., "action": TriggerAction.Enqueue(queue="name")})`	Route invocation through a named queue
Shutdown	`iii.shutdown()`	Disconnect and stop background thread

register_worker() creates the SDK instance and auto-connects to the engine.

Registering Functions

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 = iii.trigger({"function_id": "orders::create", "payload": {"body": {"item": "widget"}}})

Development

Install in development mode

pip install -e .

Type checking

mypy src

Linting

ruff check src

Resources

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

iii_sdk-0.21.8.tar.gz (193.6 kB view details)

Uploaded Jul 22, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

iii_sdk-0.21.8-py3-none-any.whl (38.2 kB view details)

Uploaded Jul 22, 2026 Python 3

File details

Details for the file iii_sdk-0.21.8.tar.gz.

File metadata

Download URL: iii_sdk-0.21.8.tar.gz
Upload date: Jul 22, 2026
Size: 193.6 kB
Tags: Source
Uploaded using Trusted Publishing? No
Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for iii_sdk-0.21.8.tar.gz
Algorithm	Hash digest
SHA256	`ff8e34a03f8f3299dcf9d6155eae29f9c74dc01fde5eead24cddb267d6de45e9`
MD5	`730134ce0179f3d16b1059525eecf7f3`
BLAKE2b-256	`e5950d1b7ea485e1376747d7f84070e63690d1d578c39aea29a60e737a8a1523`

See more details on using hashes here.

File details

Details for the file iii_sdk-0.21.8-py3-none-any.whl.

File metadata

Download URL: iii_sdk-0.21.8-py3-none-any.whl
Upload date: Jul 22, 2026
Size: 38.2 kB
Tags: Python 3
Uploaded using Trusted Publishing? No
Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for iii_sdk-0.21.8-py3-none-any.whl
Algorithm	Hash digest
SHA256	`868851fab2a69dd6bd864efa5be4d90b1525b6ec77084b3d65e001ae1736db4a`
MD5	`1914f0f6a9e81041bd8c955359f37606`
BLAKE2b-256	`61b116caacf42e1b5e798b6daa2551c5c0e371c982122066be2694be9e7049c0`