This release is a pre-release and may not be stable for production use.
TreeDX Python SDK
treedx is the generic Python SDK for TreeDX. It implements the shared
packages/sdk-spec architecture, follows docs/api/openapi.yaml, and does not
encode TreeSeed product semantics. packages/trsd-sdk is a downstream
TreeSeed consumer/reference only.
The current sdk-manifest.yaml reports modules, capabilities, and test roots as
implemented. The SDK exposes all 118 /api/v1 OpenAPI operations through
first-class module methods and a validated raw operation fallback.
Install
python -m pip install treedx
Configure Client
from treedx import TreeDxClient, TreeDxApiError
client = TreeDxClient(
base_url="http://localhost:4000",
token="...",
)
The client also accepts an auth provider, custom transport, default headers, and timeout settings.
Authenticate
Bearer authentication uses the Authorization: Bearer <token> header. Tokens
may come from token or an auth provider. The SDK must not place production
identity in request JSON and must not log bearer tokens.
Basic Health Call
health = client.health()
version = client.version()
Repository Query
Repository-scoped query helpers live under client.query:
results = client.query.search_files(
"repo_demo",
{"query": "release provenance", "paths": ["docs/**"]},
)
file = client.query.read_file(
"repo_demo",
{"ref": "refs/heads/main", "path": "docs/index.md"},
)
Workspace File Lifecycle
Workspace-scoped file helpers live under client.workspaces and client.files:
workspace = client.workspaces.create("repo_demo", {"ref": "refs/heads/main"})
client.files.write("workspace_123", {"path": "docs/new.md", "content": "# New"})
client.files.patch("workspace_123", {"path": "docs/new.md", "patch": "..."})
client.files.commit("workspace_123", {"message": "Update docs"})
client.workspaces.close("workspace_123")
Blob Upload And Download
Binary helpers preserve byte payloads and reject strings as binary input.
client.blobs.upload("workspace_123", b"\x01\x02\x03")
blob = client.blobs.download("workspace_123", {"path": "asset.bin"})
Multipart helpers expose create, part upload, complete, and abort:
upload = client.blobs.create_multipart_upload("workspace_123", {"path": "large.bin"})
client.blobs.upload_part("workspace_123", upload["uploadId"], 1, b"\x01")
client.blobs.complete_multipart_upload(
"workspace_123",
upload["uploadId"],
{"parts": [{"partNumber": 1}]},
)
Graph And Context Query
client.graph.refresh("repo_demo")
graph = client.graph.query("repo_demo", {"query": "MATCH ..."})
context = client.context.build("repo_demo", {"query": "ctx docs"})
parsed = client.context.parse("repo_demo", {"source": "ctx docs"})
Federated Query
Federation helpers use portfolio/global TreeDX routes rather than a single configured repository:
plan = client.federation.plan({"query": "release provenance"})
results = client.federation.search({"query": "release provenance"})
Scoped Admin And Internal Modules
Full OpenAPI coverage includes sensitive scoped modules: Admin, Audit, Policy, SearchIndex, and FederationInternal. These APIs require appropriate TreeDX credentials and should be used carefully against production systems. They remain generic TreeDX APIs and do not encode TreeSeed product semantics.
The raw operation fallback validates method/path pairs against generated OpenAPI metadata before dispatch.
Error Handling
Non-2xx responses and network failures raise TreeDxApiError. The error keeps
status, code, message, details, and payload available. Network
failures use status=0 and code="network_error".
try:
client.whoami()
except TreeDxApiError as error:
print(error.status, error.code, error.message)
Pagination
TreeDxPage and TreeDxCursor model opaque server-owned cursor pagination.
Helpers preserve cursor metadata and do not decode cursor internals.
Binary And Multipart
Binary helpers accept bytes, bytearray, memoryview, and binary streams.
Multipart helper metadata is represented by MultipartUpload.
Conformance
The conformance adapter loads Phase 7 scenario records and reports
live or configured until executable live dispatch is wired. It must not fake
conformance success.
python -m pytest tests/conformance
Integration
Integration tests call a live TreeDX server only when TREEDX_BASE_URL is set.
Without that environment variable, they skip cleanly.
python -m pytest tests/integration
Development Commands
python -m pip install -e ".[dev]"
python scripts/check_treedx_generated_types.py
python -m build
python -m pytest tests/conformance
python -m pytest tests/integration
python -m pytest
1 maintainer
Metadata
1 maintainer
Release files for treedx 0.3.0rc14
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| treedx-0.3.0rc14.tar.gz | 17.1 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| treedx-0.3.0rc14-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 46.8 kB
Release files / treedx-0.3.0rc14.tar.gz
| Download URL | treedx-0.3.0rc14.tar.gz |
|---|---|
| Size | 17.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
91c310ab6e40a6845ab4f192c4fb9ffdd25e631421c859f66fb6d955a896ad58
|
|
BLAKE2b-256 checksum How to use checksums |
abf66dca48372cbe93d551de674c3082f1087c2517e4543db6baf85e7a5b82db
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.14
|
Release files / treedx-0.3.0rc14-py3-none-any.whl
| Download URL | treedx-0.3.0rc14-py3-none-any.whl |
|---|---|
| Size | 29.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
3cfee4bd2351ab9b1731cfcfaacda30b037ffbbff87541c2af2b3161758a66ef
|
|
BLAKE2b-256 checksum How to use checksums |
d9cb6eaede16cdefa1ffdcb5f75c2f3a9aa2c19aab0ffb954ca39710a87756a4
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.14
|
