bytekit-sdk 0.3.0__tar.gz

bytekit_sdk-0.3.0/.gitignore

@@ -0,0 +1,102 @@
+.DS_Store
+# Sublime Text project/workspace files (user-specific, incl. editor _backup copies)
+*.sublime-project
+*.sublime-workspace
+*.sublime-project_backup
+*.sublime-workspace_backup
+node_modules/
+.env
+.env.*
+# Woodpecker CI secret bootstrap (ci/scripts/load-secrets.ts) — never commit.
+.ci-secrets.env
+.dev.vars
+dist/
+# Package-manager debug logs — never meant to be committed.
+npm-debug.log*
+pnpm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+.claude/pipeline-output/
+.claude/worktrees/
+.claude/scheduled_tasks.lock
+# local-CI pre-push gate: freshness stamp written by the PreToolUse hook in .claude/settings.json
+.claude/.local-ci-pass
+# Generated cache + dev-server logs/pids — regenerable, never commit.
+.claude/cache/
+.claude/stack/dev-server-logs/
+.worktrees/
+# Operational pipeline state — never committed.
+.pipeline/.state/
+.pipeline/.candidates/
+.wrangler/
+*.tsbuildinfo
+# Turbo per-package run metadata (#1840). The shared content-addressed cache lives on the CI
+# agent volume /cache/turbo, never in the repo; .turbo/ is local run state and must stay untracked.
+.turbo/
+# pnpm content-addressable store, created when pnpm's store-dir is pointed at the repo (default is
+# ~/.local/share/pnpm/store). Local package cache like node_modules — must stay untracked.
+.pnpm-store/
+coverage/
+tests/e2e/results.json
+tests/e2e/.sweep/
+.playwright-mcp/
+# Local Playwright persistent context for ux-design/markup-verification (Chromium profile + Clerk session)
+/.cache/
+packages/http-fetcher/ja3check
+packages/http-fetcher/server
+packages/http-fetcher/browserforge-bench
+__pycache__/
+*.pyc
+# Generated artifact — reproduced via `pnpm --filter @rapidcrawl/sdk-python generate`
+packages/sdk-python/filtered-openapi.yaml
+# NOTE: the MCP server's generated docs JSON (see packages/mcp-server/src) is intentionally
+# TRACKED (#2469). Coolify builds the gateway image from a git checkout, so this prebuild-generated
+# file must be committed for the hosted MCP docs tools to work. Regenerate with:
+#   pnpm --filter @hunt-labs/bytekit-mcp prebuild
+# Generated by @tanstack/router-plugin/vite — reproduced on every dev/build
+packages/app/src/routeTree.gen.ts
+packages/app/.tanstack/
+# CloakBrowser spike result directories — contain raw trial data, not committed
+docs/plans/spike-cloakbrowser-results-*/
+# Skill-output scratch (lean/, code-review artifacts, baseline-rot diagnostics)
+.build/
+# External Claude Code plugin source — e.g. the ux-design workflow plugin at
+# ~/.claude/plugins/ux-design/. Prevent accidental re-add if someone copies
+# the source back into the tree. See .claude/stack/ux-design.md for the
+# invocation contract.
+ux-design/plugin/
+# Per-issue scratch notes
+.issues/
+# Per-ticket scratch (raw artifacts from `ticket` command runs)
+docs/tickets/
+.superpowers/
+# Build outputs (webrtc-probe, etc.) — anywhere in tree
+out/
+# Graphify generated artifacts (cache, graph.json, wiki/, GRAPH_REPORT.md)
+graphify-out/
+# Graphify raw run state (transcripts of individual analyses)
+.claude/learnings/raw/
+
+# Claude Design extracted bundle — bulk that's regenerable from each re-export
+# Keep the high-signal CSS / JSX / HTML / chats / README; drop the bulk.
+ux-design/claude-design/marketing/bundle/project/fonts/*.woff
+ux-design/claude-design/marketing/bundle/project/uploads/
+ux-design/claude-design/marketing/bundle/project/screenshots/
+ux-design/claude-design/marketing/bundle/project/verify/
+# Root-level project/*.jsx files are vestigial canvas-iteration artifacts that
+# Claude Design's export pipeline keeps including despite the files not existing
+# in live project state (snapshot-staleness pattern verified syncs 8, 13, 14).
+# Pattern matches root-level only (gitignore * doesn't recurse) — nested
+# project/X/*.jsx files (homepage, vs/firecrawl/, features/anti-bot/, etc.) stay tracked.
+ux-design/claude-design/marketing/bundle/project/*.jsx
+ux-design/screens/playground-sitemap/.auth-state.json
+# v2 verify saves a Clerk session storageState per screen — never commit (token).
+ux-design/screens/**/.auth-state.json
+# v2 verify scratch — OTP code + run log per screen, never commit.
+ux-design/screens/**/.verify-code
+ux-design/screens/**/.verify-run.log
+.ci-deploy-uuids
+
+# Astro types cache generated when astro runs from repo root (the package-level
+# caches are already ignored via the package pattern).
+/.astro/

bytekit_sdk-0.3.0/CHANGELOG.md

@@ -0,0 +1,33 @@
+# Changelog
+
+All notable changes to the ByteKit Python SDK are documented here.
+PyPI distribution: `bytekit-sdk`. Import name: `bytekit`.
+
+## 0.3.0
+
+### Breaking
+
+- **PyPI distribution renamed `bytekit` -> `bytekit-sdk`.** PyPI administratively
+  denylists the bare name `bytekit`, so the package installs as
+  `pip install bytekit-sdk`. The **import name is unchanged** — `import bytekit`
+  still works, and no module path moved. Nothing was ever published under the old
+  distribution name, so there is no migration for existing installs.
+- **`raise_on_unexpected_status` now defaults to `True`.** Undocumented response
+  statuses now raise `errors.UnexpectedStatus` instead of silently returning `None`.
+  Callers that relied on the old `None`-return behavior must pass
+  `raise_on_unexpected_status=False` explicitly to opt out.
+- **`base_url` is now a keyword-only argument.** It gained a default
+  (`https://api.bytekit.com`), and to satisfy attrs field ordering it became
+  keyword-only. Any caller passing `base_url` positionally must switch to the
+  `base_url=` keyword form. (`base_url=` was already the documented usage.)
+
+### Added
+
+- `AuthenticatedClient(token=...)` now works out of the box against production:
+  `base_url` defaults to `https://api.bytekit.com`.
+- Finite default request timeout of `120s` (`httpx.Timeout(120.0)`) — requests no
+  longer hang indefinitely. Override with `timeout=`.
+- `errors.UnexpectedStatus` now carries optional `.code` / `.message` attributes.
+  The `AuthenticatedClient.search()` wrapper populates them from the documented
+  `Error` envelope, and safely raises a typed error (never a bare
+  `json.JSONDecodeError`) on a non-JSON documented-status body such as an HTML 502.

bytekit_sdk-0.3.0/PKG-INFO

@@ -0,0 +1,141 @@
+Metadata-Version: 2.4
+Name: bytekit-sdk
+Version: 0.3.0
+Summary: Official Python SDK for the ByteKit API
+Project-URL: Homepage, https://bytekit.com
+Project-URL: Repository, https://github.com/Hunt-Labs-Inc/ByteKit
+Project-URL: Documentation, https://bytekit.com/docs
+License-Expression: MIT
+Keywords: api,bytekit,crawler,llm,markdown,scraping,screenshots,sdk,web-scraping
+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 :: Internet :: WWW/HTTP
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+Requires-Dist: attrs>=23.1.0
+Requires-Dist: httpx>=0.24.0
+Requires-Dist: python-dateutil>=2.8.0
+Description-Content-Type: text/markdown
+
+# bytekit-sdk
+
+Official Python SDK for the [ByteKit API](https://bytekit.com).
+
+The PyPI **distribution** is `bytekit-sdk`; the **import** name is `bytekit`.
+
+Generated from the OpenAPI spec using [openapi-python-client](https://github.com/openapi-generators/openapi-python-client), filtered to the stable v0.1 operations.
+
+## Installation
+
+```bash
+pip install bytekit-sdk
+```
+
+## Quick start
+
+```python
+from bytekit import AuthenticatedClient
+from bytekit.api.scrape import create_scrape
+from bytekit.errors import UnexpectedStatus
+from bytekit.models.scrape_request import ScrapeRequest
+
+# base_url defaults to https://api.bytekit.com, so only the token is required.
+client = AuthenticatedClient(token="sk_live_your_api_key_here")
+
+body = ScrapeRequest(url="https://example.com")
+
+try:
+    response = create_scrape.sync(client=client, body=body)
+    # response.formats.markdown is str | Unset — only present when "markdown" was requested
+    print(response.formats.markdown)
+except UnexpectedStatus as err:
+    # Errors now raise loudly by default instead of returning None.
+    print(f"request failed with status {err.status_code}: {err.code} {err.message}")
+```
+
+### Defaults
+
+The client ships with production-ready defaults so `AuthenticatedClient(token=...)` works out of the box:
+
+| Setting                      | Default                         | Notes                                                                                                                                                           |
+| ---------------------------- | ------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `base_url`                   | `https://api.bytekit.com`       | Pass `base_url=` to target staging or a proxy.                                                                                                                  |
+| `timeout`                    | `120s` (`httpx.Timeout(120.0)`) | Finite by default — requests no longer hang indefinitely. Pass `timeout=` to override.                                                                          |
+| `raise_on_unexpected_status` | `True`                          | Undocumented statuses raise `errors.UnexpectedStatus` instead of silently returning `None`. Pass `raise_on_unexpected_status=False` to restore the old opt-out. |
+
+Explicit constructor arguments always win over these defaults (explicit arg > default).
+
+## Async usage
+
+```python
+import asyncio
+from bytekit import AuthenticatedClient
+from bytekit.api.screenshots import create_screenshot
+from bytekit.models.screenshot_request import ScreenshotRequest
+
+async def main():
+    client = AuthenticatedClient(token="sk_live_your_api_key_here")
+    body = ScreenshotRequest(url="https://example.com")
+    response = await create_screenshot.asyncio(client=client, body=body)
+    print(response)
+
+asyncio.run(main())
+```
+
+## Available operations
+
+| Module            | Method                                                                                                        | Description                                |
+| ----------------- | ------------------------------------------------------------------------------------------------------------- | ------------------------------------------ |
+| `api.scrape`      | `create_scrape`, `get_scrape`                                                                                 | Web content extraction                     |
+| `api.screenshots` | `create_screenshot`, `get_screenshot`                                                                         | Page screenshots                           |
+| `api.bulk`        | `create_bulk`, `get_bulk`, `delete_bulk`, `list_bulk_screenshots`                                             | Bulk screenshot jobs                       |
+| `api.scrape_bulk` | `create_scrape_bulk`, `get_scrape_bulk`                                                                       | Bulk scrape jobs                           |
+| `api.fetch`       | `get_fetch`, `post_fetch`                                                                                     | Raw HTTP fetch                             |
+| `api.fetch_bulk`  | `create_fetch_bulk`, `get_fetch_bulk`                                                                         | Bulk fetch jobs                            |
+| `api.monitors`    | `create_monitor`, `list_monitors`, `get_monitor`, `update_monitor`, `delete_monitor`, `list_monitor_captures` | Page-change monitors (screenshot + scrape) |
+| `api.sitemap`     | `create_sitemap`, `get_sitemap`                                                                               | Sitemap crawl                              |
+| `api.search`      | `create_search` (or the `AuthenticatedClient.search(...)` convenience method)                                 | Web search                                 |
+| `api.usage`       | `get_usage`, `get_usage_daily`, `get_usage_by_endpoint`                                                       | Account usage & billing                    |
+| `api.webhooks`    | `list_webhook_deliveries`, `retry_webhook_delivery`                                                           | Webhook delivery log & retry               |
+| `api.account`     | `get_account`                                                                                                 | Account details                            |
+
+## Regenerating
+
+To regenerate the client after API changes:
+
+```bash
+pnpm --filter @bytekit/sdk-python generate
+```
+
+This runs `scripts/filter-spec.ts` to produce `filtered-openapi.yaml` (filtered to v0.1 operations), runs `scripts/prune-stale-api.py` to delete any `src/bytekit/api/<tag>/` directory the filtered spec no longer produces (`generate --overwrite` itself already rebuilds `api/` from scratch on every run, so this step is defense-in-depth for a standalone run of the prune script or a future generator version — the path that actually needs the guard is `pnpm generate:docs`, which enumerates `api/` on disk independent of `generate` and can otherwise resurrect a tag whose tracked files were `git rm`-ed but whose untracked `__pycache__/` survives; see `scripts/prune-stale-api.py`'s module docstring and `has_operations()` in `scripts/generate-docs.py`), invokes `openapi-python-client generate` to update `src/bytekit/`, then runs `scripts/inject-handwritten.py` to re-append hand-written fragments (e.g. the `AuthenticatedClient.search()` convenience method) from `scripts/hand_written/` and re-patch the generated `client.py`/`errors.py` with the runtime defaults and error enrichment described above — because `--overwrite` overwrites every file it emits, both the hand-written code and these patches are wiped on every regen and must be re-applied afterward.
+
+## Development
+
+```bash
+# Run tests
+cd packages/sdk-python
+python3 -m pytest tests/ -v
+```
+
+## Publishing
+
+PyPI publish is handled in [#2226](https://github.com/Hunt-Labs-Inc/ByteKit/issues/2226) —
+`.woodpecker/publish.yaml`'s `publish-pypi` step, version-gated the same way as the npm
+siblings (publishes only when the local `pyproject.toml` version differs from what's live on
+PyPI).
+
+**`bytekit-sdk` has never been published.** Before the commit that arms
+`packages/sdk-python/pyproject.toml` in `publish.yaml`'s workflow-level `when.path.include` is
+promoted from `staging` to `main`, an operator MUST publish `0.3.0` to PyPI manually and under
+supervision. Reason: bytekit-sdk 404s on PyPI today, so the automatic version-compare gate's
+`|| echo "0.0.0"` fallback always fires — the first time that arming reaches `main`, it would
+trigger a real, irreversible first `twine upload` with no manual confirmation step in between.
+Once the manual first release exists, PUBLISHED == CURRENT and every later automatic run at an
+unchanged version is a no-op, same as the npm packages. See the comment at the armed
+`when.path.include` entry in `.woodpecker/publish.yaml` for the mechanism.

bytekit_sdk-0.3.0/README.md

@@ -0,0 +1,116 @@
+# bytekit-sdk
+
+Official Python SDK for the [ByteKit API](https://bytekit.com).
+
+The PyPI **distribution** is `bytekit-sdk`; the **import** name is `bytekit`.
+
+Generated from the OpenAPI spec using [openapi-python-client](https://github.com/openapi-generators/openapi-python-client), filtered to the stable v0.1 operations.
+
+## Installation
+
+```bash
+pip install bytekit-sdk
+```
+
+## Quick start
+
+```python
+from bytekit import AuthenticatedClient
+from bytekit.api.scrape import create_scrape
+from bytekit.errors import UnexpectedStatus
+from bytekit.models.scrape_request import ScrapeRequest
+
+# base_url defaults to https://api.bytekit.com, so only the token is required.
+client = AuthenticatedClient(token="sk_live_your_api_key_here")
+
+body = ScrapeRequest(url="https://example.com")
+
+try:
+    response = create_scrape.sync(client=client, body=body)
+    # response.formats.markdown is str | Unset — only present when "markdown" was requested
+    print(response.formats.markdown)
+except UnexpectedStatus as err:
+    # Errors now raise loudly by default instead of returning None.
+    print(f"request failed with status {err.status_code}: {err.code} {err.message}")
+```
+
+### Defaults
+
+The client ships with production-ready defaults so `AuthenticatedClient(token=...)` works out of the box:
+
+| Setting                      | Default                         | Notes                                                                                                                                                           |
+| ---------------------------- | ------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `base_url`                   | `https://api.bytekit.com`       | Pass `base_url=` to target staging or a proxy.                                                                                                                  |
+| `timeout`                    | `120s` (`httpx.Timeout(120.0)`) | Finite by default — requests no longer hang indefinitely. Pass `timeout=` to override.                                                                          |
+| `raise_on_unexpected_status` | `True`                          | Undocumented statuses raise `errors.UnexpectedStatus` instead of silently returning `None`. Pass `raise_on_unexpected_status=False` to restore the old opt-out. |
+
+Explicit constructor arguments always win over these defaults (explicit arg > default).
+
+## Async usage
+
+```python
+import asyncio
+from bytekit import AuthenticatedClient
+from bytekit.api.screenshots import create_screenshot
+from bytekit.models.screenshot_request import ScreenshotRequest
+
+async def main():
+    client = AuthenticatedClient(token="sk_live_your_api_key_here")
+    body = ScreenshotRequest(url="https://example.com")
+    response = await create_screenshot.asyncio(client=client, body=body)
+    print(response)
+
+asyncio.run(main())
+```
+
+## Available operations
+
+| Module            | Method                                                                                                        | Description                                |
+| ----------------- | ------------------------------------------------------------------------------------------------------------- | ------------------------------------------ |
+| `api.scrape`      | `create_scrape`, `get_scrape`                                                                                 | Web content extraction                     |
+| `api.screenshots` | `create_screenshot`, `get_screenshot`                                                                         | Page screenshots                           |
+| `api.bulk`        | `create_bulk`, `get_bulk`, `delete_bulk`, `list_bulk_screenshots`                                             | Bulk screenshot jobs                       |
+| `api.scrape_bulk` | `create_scrape_bulk`, `get_scrape_bulk`                                                                       | Bulk scrape jobs                           |
+| `api.fetch`       | `get_fetch`, `post_fetch`                                                                                     | Raw HTTP fetch                             |
+| `api.fetch_bulk`  | `create_fetch_bulk`, `get_fetch_bulk`                                                                         | Bulk fetch jobs                            |
+| `api.monitors`    | `create_monitor`, `list_monitors`, `get_monitor`, `update_monitor`, `delete_monitor`, `list_monitor_captures` | Page-change monitors (screenshot + scrape) |
+| `api.sitemap`     | `create_sitemap`, `get_sitemap`                                                                               | Sitemap crawl                              |
+| `api.search`      | `create_search` (or the `AuthenticatedClient.search(...)` convenience method)                                 | Web search                                 |
+| `api.usage`       | `get_usage`, `get_usage_daily`, `get_usage_by_endpoint`                                                       | Account usage & billing                    |
+| `api.webhooks`    | `list_webhook_deliveries`, `retry_webhook_delivery`                                                           | Webhook delivery log & retry               |
+| `api.account`     | `get_account`                                                                                                 | Account details                            |
+
+## Regenerating
+
+To regenerate the client after API changes:
+
+```bash
+pnpm --filter @bytekit/sdk-python generate
+```
+
+This runs `scripts/filter-spec.ts` to produce `filtered-openapi.yaml` (filtered to v0.1 operations), runs `scripts/prune-stale-api.py` to delete any `src/bytekit/api/<tag>/` directory the filtered spec no longer produces (`generate --overwrite` itself already rebuilds `api/` from scratch on every run, so this step is defense-in-depth for a standalone run of the prune script or a future generator version — the path that actually needs the guard is `pnpm generate:docs`, which enumerates `api/` on disk independent of `generate` and can otherwise resurrect a tag whose tracked files were `git rm`-ed but whose untracked `__pycache__/` survives; see `scripts/prune-stale-api.py`'s module docstring and `has_operations()` in `scripts/generate-docs.py`), invokes `openapi-python-client generate` to update `src/bytekit/`, then runs `scripts/inject-handwritten.py` to re-append hand-written fragments (e.g. the `AuthenticatedClient.search()` convenience method) from `scripts/hand_written/` and re-patch the generated `client.py`/`errors.py` with the runtime defaults and error enrichment described above — because `--overwrite` overwrites every file it emits, both the hand-written code and these patches are wiped on every regen and must be re-applied afterward.
+
+## Development
+
+```bash
+# Run tests
+cd packages/sdk-python
+python3 -m pytest tests/ -v
+```
+
+## Publishing
+
+PyPI publish is handled in [#2226](https://github.com/Hunt-Labs-Inc/ByteKit/issues/2226) —
+`.woodpecker/publish.yaml`'s `publish-pypi` step, version-gated the same way as the npm
+siblings (publishes only when the local `pyproject.toml` version differs from what's live on
+PyPI).
+
+**`bytekit-sdk` has never been published.** Before the commit that arms
+`packages/sdk-python/pyproject.toml` in `publish.yaml`'s workflow-level `when.path.include` is
+promoted from `staging` to `main`, an operator MUST publish `0.3.0` to PyPI manually and under
+supervision. Reason: bytekit-sdk 404s on PyPI today, so the automatic version-compare gate's
+`|| echo "0.0.0"` fallback always fires — the first time that arming reaches `main`, it would
+trigger a real, irreversible first `twine upload` with no manual confirmation step in between.
+Once the manual first release exists, PUBLISHED == CURRENT and every later automatic run at an
+unchanged version is a no-op, same as the npm packages. See the comment at the armed
+`when.path.include` entry in `.woodpecker/publish.yaml` for the mechanism.

bytekit_sdk-0.3.0/pyproject.toml

@@ -0,0 +1,94 @@
+[project]
+# DISTRIBUTION name only. PyPI administratively denylists the bare name `bytekit`
+# (`400 The name 'bytekit' isn't allowed.` — observed on the first real publish attempt,
+# Woodpecker pipeline 2024/workflow 4, 2026-07-22; issue #2530), and no API can pre-check
+# a name — only a real upload can. The IMPORT name is deliberately unchanged: the wheel
+# still packages `src/bytekit` (see [tool.hatch.build.targets.wheel] below), so
+# `pip install bytekit-sdk` yields a working `import bytekit`. Mirrors the npm sibling
+# @hunt-labs/bytekit-sdk.
+name = "bytekit-sdk"
+version = "0.3.0"
+description = "Official Python SDK for the ByteKit API"
+readme = "README.md"
+requires-python = ">=3.10"
+# SPDX expression (PEP 639), matching the npm siblings @hunt-labs/bytekit-sdk and
+# @hunt-labs/bytekit-cli. Deliberately NOT paired with a legacy "License ::" trove
+# classifier: PyPI rejects an upload that carries both a License-Expression and a
+# License classifier, and that rejection would only surface at twine upload time.
+license = "MIT"
+keywords = [
+    "bytekit",
+    "scraping",
+    "web-scraping",
+    "crawler",
+    "screenshots",
+    "markdown",
+    "api",
+    "sdk",
+    "llm",
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Internet :: WWW/HTTP",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Typing :: Typed",
+]
+dependencies = [
+    "httpx>=0.24.0",
+    "attrs>=23.1.0",
+    "python-dateutil>=2.8.0",
+]
+
+[project.urls]
+Homepage = "https://bytekit.com"
+Repository = "https://github.com/Hunt-Labs-Inc/ByteKit"
+Documentation = "https://bytekit.com/docs"
+
+# Code-generation toolchain. Pinned to an exact version so `pnpm generate`
+# reproduces the same client tree across machines and CI runs (E1/E5 idempotency).
+# The generated style is version-sensitive, so bumping this pin is a deliberate,
+# reviewed regeneration — never an incidental upgrade.
+[dependency-groups]
+dev = [
+    "openapi-python-client==0.25.3",
+    # Read by scripts/prune-stale-api.py (parses filtered-openapi.yaml to derive which
+    # api/ group dirs the spec still produces) and by tests/conftest.py. Generation-time
+    # and test-time only — never a runtime dependency of the published client.
+    "pyyaml>=6.0",
+    # tomllib is stdlib-only from Python 3.11; this package's declared floor is 3.10
+    # (see requires-python above), so tests/test_publish_metadata.py falls back to the
+    # tomli backport below 3.11. CI pins python:3.12 so this never installs there —
+    # it exists purely so a contributor running pytest locally on 3.10 isn't stuck
+    # with a collection-time ModuleNotFoundError (issue #2226 code review).
+    "tomli>=2.0.0; python_version < '3.11'",
+]
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+# Source layout: generated client lives in src/bytekit/
+packages = ["src/bytekit"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+pythonpath = ["src"]
+
+[tool.hatch.build.targets.sdist]
+include = [
+    "src/bytekit/**",
+    "tests/**",
+    "README.md",
+    "CHANGELOG.md",
+]
+exclude = [
+    "node_modules",
+    "**/node_modules",
+]

bytekit_sdk-0.3.0/src/bytekit/__init__.py

@@ -0,0 +1,8 @@
+"""A client library for accessing ByteKit API"""
+
+from .client import AuthenticatedClient, Client
+
+__all__ = (
+    "AuthenticatedClient",
+    "Client",
+)

bytekit_sdk-0.3.0/src/bytekit/api/__init__.py

@@ -0,0 +1 @@
+"""Contains methods for accessing the API"""

bytekit_sdk-0.3.0/src/bytekit/api/account/__init__.py

@@ -0,0 +1 @@
+"""Contains endpoint functions for accessing the API"""

bytekit_sdk-0.3.0/src/bytekit/api/account/get_account.py

@@ -0,0 +1,157 @@
+from http import HTTPStatus
+from typing import Any, Optional, Union
+
+import httpx
+
+from ... import errors
+from ...client import AuthenticatedClient, Client
+from ...models.account_bearer_response import AccountBearerResponse
+from ...models.account_session_response import AccountSessionResponse
+from ...types import Response
+
+
+def _get_kwargs() -> dict[str, Any]:
+    _kwargs: dict[str, Any] = {
+        "method": "get",
+        "url": "/v1/account",
+    }
+
+    return _kwargs
+
+
+def _parse_response(
+    *, client: Union[AuthenticatedClient, Client], response: httpx.Response
+) -> Optional[Union["AccountBearerResponse", "AccountSessionResponse"]]:
+    if response.status_code == 200:
+
+        def _parse_response_200(
+            data: object,
+        ) -> Union["AccountBearerResponse", "AccountSessionResponse"]:
+            try:
+                if not isinstance(data, dict):
+                    raise TypeError()
+                response_200_type_0 = AccountBearerResponse.from_dict(data)
+
+                return response_200_type_0
+            except:  # noqa: E722
+                pass
+            if not isinstance(data, dict):
+                raise TypeError()
+            response_200_type_1 = AccountSessionResponse.from_dict(data)
+
+            return response_200_type_1
+
+        response_200 = _parse_response_200(response.json())
+
+        return response_200
+    if client.raise_on_unexpected_status:
+        raise errors.UnexpectedStatus(response.status_code, response.content)
+    else:
+        return None
+
+
+def _build_response(
+    *, client: Union[AuthenticatedClient, Client], response: httpx.Response
+) -> Response[Union["AccountBearerResponse", "AccountSessionResponse"]]:
+    return Response(
+        status_code=HTTPStatus(response.status_code),
+        content=response.content,
+        headers=response.headers,
+        parsed=_parse_response(client=client, response=response),
+    )
+
+
+def sync_detailed(
+    *,
+    client: AuthenticatedClient,
+) -> Response[Union["AccountBearerResponse", "AccountSessionResponse"]]:
+    """Get account details
+
+     Returns account, plan, and current API key details, including the
+    `api_key` and `subscription` fields.
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        Response[Union['AccountBearerResponse', 'AccountSessionResponse']]
+    """
+
+    kwargs = _get_kwargs()
+
+    response = client.get_httpx_client().request(
+        **kwargs,
+    )
+
+    return _build_response(client=client, response=response)
+
+
+def sync(
+    *,
+    client: AuthenticatedClient,
+) -> Optional[Union["AccountBearerResponse", "AccountSessionResponse"]]:
+    """Get account details
+
+     Returns account, plan, and current API key details, including the
+    `api_key` and `subscription` fields.
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        Union['AccountBearerResponse', 'AccountSessionResponse']
+    """
+
+    return sync_detailed(
+        client=client,
+    ).parsed
+
+
+async def asyncio_detailed(
+    *,
+    client: AuthenticatedClient,
+) -> Response[Union["AccountBearerResponse", "AccountSessionResponse"]]:
+    """Get account details
+
+     Returns account, plan, and current API key details, including the
+    `api_key` and `subscription` fields.
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        Response[Union['AccountBearerResponse', 'AccountSessionResponse']]
+    """
+
+    kwargs = _get_kwargs()
+
+    response = await client.get_async_httpx_client().request(**kwargs)
+
+    return _build_response(client=client, response=response)
+
+
+async def asyncio(
+    *,
+    client: AuthenticatedClient,
+) -> Optional[Union["AccountBearerResponse", "AccountSessionResponse"]]:
+    """Get account details
+
+     Returns account, plan, and current API key details, including the
+    `api_key` and `subscription` fields.
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        Union['AccountBearerResponse', 'AccountSessionResponse']
+    """
+
+    return (
+        await asyncio_detailed(
+            client=client,
+        )
+    ).parsed

bytekit_sdk-0.3.0/src/bytekit/api/bulk/__init__.py

@@ -0,0 +1 @@
+"""Contains endpoint functions for accessing the API"""