EchoStash
Docs

Python SDK

Official Python client

Installation

bash
pip install plp-client

Requires Python 3.9+

Setup

python
from plp_client import PLPClient

client = PLPClient(
    base_url="https://api.example.com/v1",
    api_key="your-key",
    timeout=10  # seconds
)

# Or use as context manager
with PLPClient("https://...", api_key="...") as client:
    prompt = client.get("welcome-email")

Prompt Operations

python
# Get prompt
prompt = client.get("welcome-email")
v1 = client.get("welcome-email", version="1.0.0")

# Create or update
client.put("welcome-email", {
    "content": "Hello {{name}}!",
    "meta": {"description": "Welcome template"}
})

# Delete
client.delete("welcome-email")

Deploy & Eval

python
client.deploy("welcome-email", version_no=3, environment="production")

result = client.run_eval("welcome-email", eval_yaml_content)

Context Store

python
assets = client.list_context_store()
asset = client.get_context_store_asset("company-logo")
client.add_prompt_context("welcome-email", "logo", "company-logo")
resolved = client.resolve_prompt_context("welcome-email", ["logo"])

Error Handling

python
from plp_client import PLPError

try:
    prompt = client.get("nonexistent")
except PLPError as e:
    print(e.status_code)  # 404
    print(e.response)     # {"error": "Not Found", ...}