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
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
f0953ffe59f0a39328dc7309f3fa1116b1df51c3aef900aa02ab28376fd3bc0d
|
|
| MD5 |
f211fd78948ab568337f9adf724d8181
|
|
| BLAKE2b-256 |
fa748398df74c5121870da0c80ed3526364dbad2d05a669c1554e30f8878fb10
|
Provenance
The following attestation bundles were made for whodb_sdk-0.127.1.tar.gz:
Publisher:
release-ce.yml on clidey/whodb
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
whodb_sdk-0.127.1.tar.gz -
Subject digest:
f0953ffe59f0a39328dc7309f3fa1116b1df51c3aef900aa02ab28376fd3bc0d - Sigstore transparency entry: 2600209550
- Sigstore integration time:
-
Permalink:
clidey/whodb@5649d077576770b05aa2c8a2eadc985b39806790 -
Branch / Tag:
refs/heads/main - Owner: https://github.com/clidey
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release-ce.yml@5649d077576770b05aa2c8a2eadc985b39806790 -
Trigger Event:
workflow_dispatch
-
Statement type:
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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
8fcec9392348ab7e3c253266383a3e6d8c9354dda87f6197f4dde99b94a3a293
|
|
| MD5 |
fe337f6412b91dd3231090b3832f7f52
|
|
| BLAKE2b-256 |
4925ffcef764158bdf1bc539c7594917e5ddb96ac84473e308389d14b694bc69
|
Provenance
The following attestation bundles were made for whodb_sdk-0.127.1-py3-none-any.whl:
Publisher:
release-ce.yml on clidey/whodb
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
whodb_sdk-0.127.1-py3-none-any.whl -
Subject digest:
8fcec9392348ab7e3c253266383a3e6d8c9354dda87f6197f4dde99b94a3a293 - Sigstore transparency entry: 2600210044
- Sigstore integration time:
-
Permalink:
clidey/whodb@5649d077576770b05aa2c8a2eadc985b39806790 -
Branch / Tag:
refs/heads/main - Owner: https://github.com/clidey
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release-ce.yml@5649d077576770b05aa2c8a2eadc985b39806790 -
Trigger Event:
workflow_dispatch
-
Statement type: