d2b-sdk 0.1.0__tar.gz

d2b_sdk-0.1.0/.gitignore

@@ -0,0 +1,8 @@
+# This tree is replaced wholesale on every sync; these are what a local
+# checkout produces and must never be committed back.
+node_modules/
+dist/
+.venv/
+__pycache__/
+*.pyc
+.pytest_cache/

d2b_sdk-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 600
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

d2b_sdk-0.1.0/PKG-INFO

@@ -0,0 +1,103 @@
+Metadata-Version: 2.5
+Name: d2b-sdk
+Version: 0.1.0
+Summary: D2B Python SDK — Spreadsheets for AI Agents (typed, versioned, governed tables behind an agent-native API)
+Project-URL: Homepage, https://d2b.dev
+Project-URL: Documentation, https://docs.d2b.dev
+Project-URL: Repository, https://github.com/600/d2b-sdk
+Project-URL: Issues, https://github.com/600/d2b-sdk/issues
+License-Expression: MIT
+License-File: LICENSE
+Keywords: agents,d2b,duckdb,etl,excel,llm,mcp,spreadsheet
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering :: Information Analysis
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+Requires-Dist: httpx>=0.27
+Description-Content-Type: text/markdown
+
+# d2b-sdk — D2B Python SDK
+
+Spreadsheets for AI Agents: typed, versioned, governed tables behind an
+agent-native API.
+
+```bash
+pip install d2b-sdk
+```
+
+The distribution is `d2b-sdk`; the import package and the command are both
+`d2b` (`d2b` on PyPI is an unrelated project). With `uvx`, that means
+`uvx --from d2b-sdk d2b ...`.
+
+```python
+from d2b import D2BClient, ConflictError
+
+client = D2BClient(api_key="d2b_pat_...", base_url="https://d2b.dev")
+wb = client.workbooks.create(title="monthly")["id"]
+
+# Large files are safe: the SDK drives the async ingest and waits on the job.
+client.sources.upload(wb, "sales.xlsx", wait=True)
+
+for t in client.tables.list(wb):
+    print(t["name"], t["row_count"])
+
+# Row edits are optimistically locked — a 409 is ConflictError, and the
+# contract is to re-read and re-apply rather than retry.
+page = client.tables.rows(wb, "sales")
+try:
+    client.tables.upsert_rows(
+        wb, "sales",
+        rows=[{"product": "apple", "qty": 3}],
+        expected_version=page["edit_version"],
+    )
+except ConflictError:
+    page = client.tables.rows(wb, "sales")
+```
+
+The client is a thin skin over the REST API — every method maps to one
+endpoint:
+
+- an `Idempotency-Key` on every mutating call (retry-safe);
+- exponential-backoff retry on 429 / 5xx. **409 is never retried**;
+- problem+json errors raised with their `suggested_fix` attached (written for
+  LLMs to read and react to);
+- helpers for the parts that bite: `jobs.wait()`, `tables.iter_rows()`,
+  `webhooks.verify_delivery()` (signature + send-time check).
+
+Docs: [docs.d2b.dev](https://docs.d2b.dev) ·
+[API reference](https://docs.d2b.dev/en/api-reference) ·
+[日本語](https://docs.d2b.dev/ja)
+
+## CLI
+
+```bash
+d2b login                                            # browser login; no raw API keys
+d2b workbooks create --title monthly
+d2b upload sales.xlsx --workbook WB --wait
+d2b query 'SELECT 1' --workbook WB
+d2b pull --workbook WB                               # transforms/ sheets/ charts/ + d2b.json
+d2b pull --data customers                            # track base tables as data/*.csv too
+d2b push --commit "$(git rev-parse --short HEAD)"    # re-run what changed, then name the version after the commit
+d2b github-workflow > .github/workflows/d2b.yml      # CI: push on merge to main, scheduled pull → PR
+```
+
+Output is JSON on stdout; errors carry their `suggested_fix` on stderr; exit
+codes are 0 / 1 (API errors, refused syncs) / 2 (usage). Nothing prompts
+interactively.
+
+`d2b login` targets `https://d2b.dev` unless `--base-url` or `$D2B_BASE_URL`
+says otherwise. For non-interactive use set `D2B_API_KEY` and `D2B_BASE_URL`
+— **never pass secrets as command-line arguments** (`--api-key` is not
+accepted, and secret-shaped strings are redacted from error messages).
+
+## License
+
+MIT ([LICENSE](LICENSE)). "D2B", its name and logo, are trademarks and are not
+covered by this license.

d2b_sdk-0.1.0/README.md

@@ -0,0 +1,78 @@
+# d2b-sdk — D2B Python SDK
+
+Spreadsheets for AI Agents: typed, versioned, governed tables behind an
+agent-native API.
+
+```bash
+pip install d2b-sdk
+```
+
+The distribution is `d2b-sdk`; the import package and the command are both
+`d2b` (`d2b` on PyPI is an unrelated project). With `uvx`, that means
+`uvx --from d2b-sdk d2b ...`.
+
+```python
+from d2b import D2BClient, ConflictError
+
+client = D2BClient(api_key="d2b_pat_...", base_url="https://d2b.dev")
+wb = client.workbooks.create(title="monthly")["id"]
+
+# Large files are safe: the SDK drives the async ingest and waits on the job.
+client.sources.upload(wb, "sales.xlsx", wait=True)
+
+for t in client.tables.list(wb):
+    print(t["name"], t["row_count"])
+
+# Row edits are optimistically locked — a 409 is ConflictError, and the
+# contract is to re-read and re-apply rather than retry.
+page = client.tables.rows(wb, "sales")
+try:
+    client.tables.upsert_rows(
+        wb, "sales",
+        rows=[{"product": "apple", "qty": 3}],
+        expected_version=page["edit_version"],
+    )
+except ConflictError:
+    page = client.tables.rows(wb, "sales")
+```
+
+The client is a thin skin over the REST API — every method maps to one
+endpoint:
+
+- an `Idempotency-Key` on every mutating call (retry-safe);
+- exponential-backoff retry on 429 / 5xx. **409 is never retried**;
+- problem+json errors raised with their `suggested_fix` attached (written for
+  LLMs to read and react to);
+- helpers for the parts that bite: `jobs.wait()`, `tables.iter_rows()`,
+  `webhooks.verify_delivery()` (signature + send-time check).
+
+Docs: [docs.d2b.dev](https://docs.d2b.dev) ·
+[API reference](https://docs.d2b.dev/en/api-reference) ·
+[日本語](https://docs.d2b.dev/ja)
+
+## CLI
+
+```bash
+d2b login                                            # browser login; no raw API keys
+d2b workbooks create --title monthly
+d2b upload sales.xlsx --workbook WB --wait
+d2b query 'SELECT 1' --workbook WB
+d2b pull --workbook WB                               # transforms/ sheets/ charts/ + d2b.json
+d2b pull --data customers                            # track base tables as data/*.csv too
+d2b push --commit "$(git rev-parse --short HEAD)"    # re-run what changed, then name the version after the commit
+d2b github-workflow > .github/workflows/d2b.yml      # CI: push on merge to main, scheduled pull → PR
+```
+
+Output is JSON on stdout; errors carry their `suggested_fix` on stderr; exit
+codes are 0 / 1 (API errors, refused syncs) / 2 (usage). Nothing prompts
+interactively.
+
+`d2b login` targets `https://d2b.dev` unless `--base-url` or `$D2B_BASE_URL`
+says otherwise. For non-interactive use set `D2B_API_KEY` and `D2B_BASE_URL`
+— **never pass secrets as command-line arguments** (`--api-key` is not
+accepted, and secret-shaped strings are redacted from error messages).
+
+## License
+
+MIT ([LICENSE](LICENSE)). "D2B", its name and logo, are trademarks and are not
+covered by this license.

d2b_sdk-0.1.0/d2b/__init__.py

@@ -0,0 +1,39 @@
+"""D2B Python SDK — Spreadsheets for AI Agents.
+
+A thin, agent-native client over the D2B v1 API. The ergonomics live
+in behaviour, not just types:
+
+- automatic ``Idempotency-Key`` on every mutating call (retry-safe);
+- transparent retry with backoff on 429/5xx;
+- problem+json errors surfaced as typed exceptions carrying
+  ``suggested_fix`` (written for LLMs to read and react);
+- ``jobs.wait()`` for the async ingest flow;
+- ``webhooks.verify_delivery()`` for the delivery HMAC + send-time check.
+
+Quickstart::
+
+    from d2b import D2BClient
+
+    client = D2BClient(api_key="d2b_pat_...", base_url="https://d2b.dev")
+    wb = client.workbooks.create(title="monthly")
+    job = client.sources.upload(wb["id"], "sales.xlsx", wait=True)
+    for t in client.tables.list(wb["id"]):
+        print(t["name"], t["row_count"])
+"""
+from ._version import __version__
+from .client import (
+    ConflictError,
+    D2BClient,
+    D2BError,
+    NotFoundError,
+    PolicyError,
+)
+
+__all__ = [
+    "D2BClient",
+    "D2BError",
+    "ConflictError",
+    "NotFoundError",
+    "PolicyError",
+    "__version__",
+]

d2b_sdk-0.1.0/d2b/_version.py

@@ -0,0 +1,7 @@
+"""The one place the version is written.
+
+``pyproject.toml`` reads it (hatch dynamic version), and the client tags
+(``X-D2B-Client`` / ``User-Agent``) derive from it, so a release bumps one
+line and every surface follows.
+"""
+__version__ = "0.1.0"