ZeroLock Python SDK

Python client SDK for ZeroLock - concurrency-correctness substrate for multi-agent AI systems.

Installation

pip install --pre zerolock-sdk     # pre-release (beta)

Usage

Async Client

from zerolock_sdk import ZeroLockClient, CreateShardOptions

async with ZeroLockClient(gateway="http://localhost:8080") as client:
    # Create a shard
    await client.create_shard("my-shard", CreateShardOptions(type="decision"))

    # Read a shard
    shard = await client.get_shard("my-shard")
    print(f"Value: {shard.value}, Version: {shard.version}")

    # Commit a new value
    result = await client.commit_shard("my-shard", "new-value", shard.version)
    print(f"New version: {result.version}")

Sync Client

from zerolock_sdk import ZeroLockSyncClient, CreateShardOptions

with ZeroLockSyncClient(gateway="http://localhost:8080") as client:
    shard = client.get_shard("my-shard")
    client.commit_shard("my-shard", "new-value", shard.version)

Error Handling

from zerolock_sdk import StaleCommitError, ShardNotFoundError

try:
    await client.commit_shard("my-shard", "value", expected_version)
except StaleCommitError as e:
    print(f"Conflict! Shard {e.shard_id} is now version {e.current_version}")
except ShardNotFoundError as e:
    print(f"Shard {e.shard_id} not found")