Skip to main content

onetaskgraph-sdk

The typed Python client for onetaskgraph. Its request vocabulary, response models, and method surface are generated from the JSON Schema and command help emitted by the real binary; the workspace's just lint rejects committed output that has drifted.

import asyncio
from onetaskgraph_sdk import Client

tasks = asyncio.run(Client().task_list(status=["todo"]))

Each async call runs one binary subprocess and validates its JSON response. The executable is resolved in this order: the binary= constructor argument, the ONETASKGRAPH_SDK_BINARY environment variable, then the onetaskgraph executable supplied on PATH by the packaged binary distribution. Pass cwd= to select the directory from which configuration is discovered. Partial query exit status 4 is parsed and returned, so callers can inspect each typed SourceFailure; other non-zero statuses raise OnetaskgraphError with the exit code.

Every call also passes --no-interactive, so no call ever waits on a prompt: a template variable nothing answers takes its default, and a required one left unanswered raises with exit code 2. template_render(file, search_path=..., answers={...}, var=[...]) hands the answers mapping to the binary on standard input, and each var (NAME=VALUE) outranks it.

task_create(source, project, title, template=..., answers={...}) and document_create(...) create an item from a template file — or from template_loader= (the path of a loader document naming what to render), or from a plain body= — and answer as task_show and document_show do; the item records its onetaskgraph.template provenance, which TemplateProvenance reads. task_render(id, ...) and document_render(id, ...) regenerate one in place from its stored answers, with answers, var and unset laid over them, and answer with a Regenerated; task_answers(id) and document_answers(id) answer with the stored TemplateAnswers. template_variables and template_render take template_loader= in place of a file. A body and answers are never passed together: both would go to the binary's one standard input, so the call raises TypeError instead.

Metadata

Release files for onetaskgraph-sdk 0.3.4

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for onetaskgraph-sdk 0.3.4
File Size Uploaded
onetaskgraph_sdk-0.3.4.tar.gz 101.8 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for onetaskgraph-sdk 0.3.4
File Interpreter ABI Platform
onetaskgraph_sdk-0.3.4-py3-none-any.whl Python 3 none any Details

Total release size: 208.6 kB

Release files / onetaskgraph_sdk-0.3.4.tar.gz

Download URL onetaskgraph_sdk-0.3.4.tar.gz
Size 101.8 kB
Tags Source
SHA-256 checksum
How to use checksums
b99a6f46a11e1a97328637b3a036d39fd6fcc93b936a75c8a47130e14a3f2619
BLAKE2b-256 checksum
How to use checksums
7a0daa90884983484aefb9992af0d556fce569a0b817d744ae67847ce0e68349
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.12.23 {"installer":{"name":"uv","version":"0.12.23","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Release files / onetaskgraph_sdk-0.3.4-py3-none-any.whl

Download URL onetaskgraph_sdk-0.3.4-py3-none-any.whl
Size 106.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
25a16a8e7657f5c1524340acc0e35b58f29328848fb316838de44049289274d5
BLAKE2b-256 checksum
How to use checksums
06cd3652d94bfc5f77f522f3811ff9bb97c8f3ca086274b4068f586f939e0389
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.12.23 {"installer":{"name":"uv","version":"0.12.23","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Release history Release notifications | RSS feed

0.6.0

2 release files

0.5.0

2 release files

0.4.0

2 release files

0.3.12

2 release files

0.3.11

2 release files

0.3.9

2 release files

0.3.8

2 release files

0.3.7

2 release files

0.3.6

2 release files

0.3.5

2 release files

This release

0.3.4 This release

2 release files

0.3.3

2 release files

0.3.2

2 release files

0.3.1

2 release files

0.3.0

2 release files

0.2.52

2 release files

0.2.51

2 release files

0.2.50

2 release files

0.2.49

2 release files

0.2.48

2 release files

0.2.47

2 release files

0.2.46

2 release files

0.2.45

2 release files

0.2.44

2 release files

0.2.43

2 release files

0.2.42

2 release files

0.2.41

2 release files

0.2.40

2 release files

0.2.39

2 release files

0.2.38

2 release files

0.2.37

2 release files

0.2.36

2 release files

0.2.35

2 release files

0.2.34

2 release files

0.2.33

2 release files

0.2.32

2 release files

0.2.31

2 release files

0.2.30

2 release files

0.2.29

2 release files

0.2.28

2 release files

0.2.13

2 release files

0.2.12

2 release files

0.2.11

2 release files

0.2.10

2 release files

0.2.9

2 release files

0.2.8

2 release files

0.2.7

2 release files

0.2.6

2 release files

0.2.5

2 release files

0.2.4

2 release files

0.2.3

2 release files

0.2.2

2 release files

0.2.1

2 release files

0.2.0

2 release files

0.1.0

2 release 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