Skip to main content

whodb-sdk

Official Python SDK for the WhoDB hosted platform — your ontology, datasets, and sources as in-code function APIs.

Install

pip install whodb-sdk

Requires Python ≥ 3.10.

Quickstart

import os
from whodb import WhoDB

# Production: API key (create one in org settings → API keys).
whodb = WhoDB(api_key=os.environ["WHODB_API_KEY"])

# Local development: zero config — reuses your `whodb login` session.
# whodb = WhoDB()

users = whodb.ontology("User")

user = users.get("u_123")
active = users.list(where={"status": {"eq": "active"}}, page_size=100).all()
users.create({"email": "a@b.co"})
users.create_many(rows, idempotency_key="import-42")
users.update("u_123", {"plan": "pro"})
orders = users.follow_link("u_123", "orders").all()

# Iterate everything, page by page:
for page in users.list(page_size=500).pages():
    print(len(page.rows))

# Async client:
from whodb import AsyncWhoDB
awhodb = AsyncWhoDB(api_key=os.environ["WHODB_API_KEY"])
user = await awhodb.ontology("User").get("u_123")

Authentication

Credential precedence: constructor args (api_key= / token= / credentials=) → WHODB_API_KEY env var → the whodb CLI's stored login. Workspace (org= / project=) is optional with an API key; pass project= when the key has access to more than one project.

Inside a WhoDB Function, WhoDB() auto-detects the runtime and needs no configuration at all.

Typed clients

whodb sdk generate --language python --out whodb_gen/

License

Apache-2.0

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

whodb_sdk-0.127.0.tar.gz (25.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

whodb_sdk-0.127.0-py3-none-any.whl (29.2 kB view details)

Uploaded Python 3

File details

Details for the file whodb_sdk-0.127.0.tar.gz.

File metadata

  • Download URL: whodb_sdk-0.127.0.tar.gz
  • Upload date:
  • Size: 25.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for whodb_sdk-0.127.0.tar.gz
Algorithm Hash digest
SHA256 d0b2de6023c3fe29f93095d5fe8461a44cdeeb8c88742a1afe2440cfcaa77527
MD5 7bc54dbc1f2313016d938f6f025fc763
BLAKE2b-256 d7c6960356b1d34df901828f63699218b80fb39753227225e048b00f533139f2

See more details on using hashes here.

Provenance

The following attestation bundles were made for whodb_sdk-0.127.0.tar.gz:

Publisher: release-ce.yml on clidey/whodb

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file whodb_sdk-0.127.0-py3-none-any.whl.

File metadata

  • Download URL: whodb_sdk-0.127.0-py3-none-any.whl
  • Upload date:
  • Size: 29.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for whodb_sdk-0.127.0-py3-none-any.whl
Algorithm Hash digest
SHA256 1f9d4cbc0316156839840b6742f431602555c0e9ea58397b08b32bc101cd6d0b
MD5 b7f9951c0a7b248b0a7bd21080cef54b
BLAKE2b-256 3b218aa8f43592243de4b7ae53de9a043caf2600dfb86ab902100b1be412c01f

See more details on using hashes here.

Provenance

The following attestation bundles were made for whodb_sdk-0.127.0-py3-none-any.whl:

Publisher: release-ce.yml on clidey/whodb

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

0.127.1

2 files

This release

0.127.0 This release

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page