datanature-sdk 0.2.0

DataNature DS/DE SDK — tenant-safe client for the sdk-layer service.

datanature-sdk (Python)

Tenant-safe DS/DE client for the DataNature sdk-layer service. Marketplace artifact (Track B). Full design: docs/sdk/SDK-PLAN.md; usage: docs/sdk/SDK-USE-CASES.md.

from datanature import Client

# machine / notebook / CI
c = Client("https://sdk.platform.dlytica.com", workspace_id="09588140-...",
           api_key="vmk_09588140_...")
# or interactive session token
c = Client.login("https://sdk.platform.dlytica.com", workspace_id="09588140-...",
                 token="<platform session token>")

c.version()          # sdk-layer API version
c.capabilities()     # DS/DE surfaces this workspace's plan entitles
c.de.query.run(...)  # DE surfaces (SDK-06..09)   — land per bead
c.ds.spark.session() # DS surfaces (SDK-10)        — land per bead

Design guarantees

• One Client == one workspace. workspace_id is fixed at construction; every path is built from it (Client._tenant_path). No API targets another tenant. The service still re-enforces require_tenant_match (defense in depth).
• Typed errors. HTTP status → AuthError/PermissionError_/NotFoundError/QuotaError/ServiceError.
• Honest surfaces. Not-yet-implemented capabilities raise NotImplementedYet with their tracking bead — never fake behavior.
• Resilient transport. Idempotent GETs retry on 429/5xx with capped backoff.

Layout

datanature/
  client.py       Client + tenant-safety core (SDK-05)
  auth.py         SessionTokenAuth / ApiKeyAuth (SDK-04)
  transport.py    httpx wrapper: retries, pagination, error mapping (SDK-03)
  errors.py       typed error hierarchy
  de/  ds/  governance/   capability namespaces (surfaces land per bead)
tests/            offline tests via httpx.MockTransport

Develop

cd sdk/python
pip install -e ".[dev]"
PYTHONPATH=. pytest tests/ -q