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.1.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.1-py3-none-any.whl (29.2 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: whodb_sdk-0.127.1.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.1.tar.gz
Algorithm Hash digest
SHA256 f0953ffe59f0a39328dc7309f3fa1116b1df51c3aef900aa02ab28376fd3bc0d
MD5 f211fd78948ab568337f9adf724d8181
BLAKE2b-256 fa748398df74c5121870da0c80ed3526364dbad2d05a669c1554e30f8878fb10

See more details on using hashes here.

Provenance

The following attestation bundles were made for whodb_sdk-0.127.1.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.1-py3-none-any.whl.

File metadata

  • Download URL: whodb_sdk-0.127.1-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.1-py3-none-any.whl
Algorithm Hash digest
SHA256 8fcec9392348ab7e3c253266383a3e6d8c9354dda87f6197f4dde99b94a3a293
MD5 fe337f6412b91dd3231090b3832f7f52
BLAKE2b-256 4925ffcef764158bdf1bc539c7594917e5ddb96ac84473e308389d14b694bc69

See more details on using hashes here.

Provenance

The following attestation bundles were made for whodb_sdk-0.127.1-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

This release

0.127.1 This release

2 files

0.127.0

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