datacrawl-sdk 0.1.1

DataCrawl Python SDK

DataCrawl Python SDK

Python client for DataCrawl agent authorization APIs.

Install

Editable local install from this repository root:

pip install -e ./packages/sdk-python

Install from package index (after publish):

pip install datacrawl

Quickstart

from datacrawl import DataCrawl

client = DataCrawl(
    api_key="dc_live_xxx",
    base_url="https://datacrawl.org",
)

result = client.authorize(
    tool="gmail.send_email",
    payload={"to": "[e-mail]", "subject": "Policy check"},
)

print(result.decision, result.reason, result.request_id)

API Surface

• DataCrawl.authorize(tool, payload, idempotency_key=None)
• DataCrawl.record(request_id, outcome, error_code=None, duration_ms=None)
• DataCrawl.protect(tool, overrides=None)
• DataCrawl.poll_approval(approval_id, poll_interval_s=2.0, timeout_s=60.0)
• DataCrawl.validate(contract_id, payload, request_id=None)
• DataCrawl.validate_contract(contract_id, payload, request_id=None)
• DataCrawl.list_tools(), DataCrawl.get_tool(tool_id), DataCrawl.execute_tool(tool_id, input_payload)
• DataCrawl.search_tools(query, limit=None, optimize=None), DataCrawl.find_tools(query, debug=False)
• DataCrawl.create_contract(tool_name, ..., runtime_settings=None)
• DataCrawl.list_contracts(), DataCrawl.get_contract(contract_id)
• DataCrawl.update_contract(contract_id, patch), DataCrawl.delete_contract(contract_id)

Local Validation

python -m pip install -e ./packages/sdk-python
python -c "from datacrawl import DataCrawl, DataCrawlError; print('ok')"
python -m pip show datacrawl

Release (Optional)

cd packages/sdk-python
python -m pip install --upgrade build twine
python -m build
twine check dist/*
# twine upload dist/*