ditto Python SDK

Python client for provisioning ephemeral database copies from a running ditto host.

Install

pip install "ditto-sdk[pytest]"

For development from a repository checkout:

pip install -e "./sdk/python[pytest]"

Usage

import os

from ditto import Client

client = Client(
    server_url="http://ditto.internal:8080",
    token=os.environ["DITTO_TOKEN"],
    ttl_seconds=600,
)

copy = client.create()
print(copy["connection_string"])
client.destroy(copy["id"])

Use the context manager for automatic cleanup:

from ditto import Client

client = Client(server_url="http://ditto.internal:8080")

with client.with_copy() as dsn:
    print(dsn)

Environment variables

Client reads these variables by default:

• DITTO_SERVER_URL
• DITTO_TOKEN (typically a bearer JWT in shared-host mode)
• DITTO_TTL