vstorm-co / pydantic-ai-backend / 27433209105

100%

push

github

feat(backends): add KubernetesPodSandbox (#46)

* feat(backends): add KubernetesPodSandbox

New optional backend that runs each session as a dedicated Pod with a
small in-pod HTTP exec server. Mirrors the DockerSandbox surface:
execute/edit/read/write/read_bytes/ls_info/glob_info/grep_raw,
output truncation, last-activity tracking, idempotent stop.

Highlights:
- DNS-1123 safe pod name sanitization (`pab-sandbox-<id>`).
- `sandbox_id` / `session_id` alias parity with DaytonaSandbox.
- Optional `pod_template` override for cluster-specific specs.
- `delete_on_stop=False` keeps the pod for post-mortem inspection.
- `exec_token` header check on the in-pod HTTP path.

Tests: 14 unit tests with a hand-rolled fake k8s SDK + httpx double
(same style as `test_daytona_sandbox.py`). Real-cluster integration
gated behind `@pytest.mark.kubernetes` (default-deselected).

Docs: concepts/kubernetes.md, examples/kubernetes-sandbox.md,
api/kubernetes.md. Nav wired in mkdocs.yml.

Packaging: new `kubernetes` extra (`kubernetes>=29.0.0`, `httpx>=0.28.0`)
and added to `dev` group so checks have the import paths.

* fix(kubernetes): address PR #46 review feedback

- edit(): surface BaseSandbox.read_bytes b"[Error: ...]" sentinel
  (mode="api") instead of treating error text as file content, matching
  DaytonaSandbox.edit() (review: read_bytes/edit bug)
- replace hand-rolled _deep_copy with copy.deepcopy (review: handles
  tuples/sets, not just dict/list)
- drop dead `if TYPE_CHECKING: pass` block and unused import
- document timeout/coreutils + /bin/sh requirement for mode="api" in the
  class docstring, _execute_api, and docs/concepts/kubernetes.md
- add HTTP-mode tests for read, read_bytes, write, edit (incl. the
  api-mode [Error:] sentinel path) — the missing coverage flagged in review

65 of 65 new or added lines in 1 file covered. (100.0%)

1162 of 1162 relevant lines covered (100.0%)

1.0 hits per line