Files
langgraph/libs/sdk-py/tests/integration/test_store.py
T
Elior Nataf LackritzandGitHub ea5f9cc9fb chore: enforce PLC0415 in tests for the remaining packages (#8547)
Follow-up to #8540, which turned on `PLC0415` (import-outside-top-level)
for checkpoint-postgres and checkpoint-sqlite. This does the remaining
six packages: checkpoint, checkpoint-conformance, langgraph, prebuilt,
cli, sdk-py.

Scoped to tests, per @sydney-runkle's call on #8540: library code is
exempted with `per-file-ignores`, since it still has deferred imports
nobody has reviewed and mixing that in would make this hard to read.

## What changed

Function-level imports across 56 test files moved to module level. Nine
could not move and carry an explicit `# noqa: PLC0415` with a reason:

| File | Why it stays local |
|---|---|
| `libs/langgraph/tests/test_deprecation.py` (4) | the import has to run
inside `pytest.warns` for the warning to be observed |
| `libs/langgraph/tests/test_serde_allowlist.py` | try/except guard,
skips when langchain_core is absent |
| `libs/langgraph/tests/test_delta_channel_benchmark.py` | optional
psycopg probe |
| `libs/checkpoint/tests/test_conformance_delta.py` (3) | protected by a
module-level `pytest.importorskip`; hoisting past the guard turns a skip
into a collection error |

That last one is the trap: an import moved above `pytest.importorskip`
silently defeats the guard. I hit it locally and it turned the skip into
a `ModuleNotFoundError` at collection. Every file with an `importorskip`
or `except ImportError` was checked by hand for this.

## Verification

`make lint` and `make test` in each of the six:

| Package | Tests |
|---|---|
| checkpoint | 156 passed, 17 skipped |
| checkpoint-conformance | 1 passed |
| langgraph | 1968 passed, 4 skipped |
| prebuilt | 284 passed |
| cli | 336 passed |
| sdk-py | 493 passed |

Also confirmed the rule actually fires: a throwaway test file with a
function-level import is flagged in all six packages, and the source
exemption holds.
2026-08-07 09:40:18 -04:00

125 lines
3.9 KiB
Python

"""`StoreClient` against the integration API.
Covers the put / get / search / list_namespaces / delete round-trip
under a unique-per-test namespace so concurrent runs don't collide.
"""
from __future__ import annotations
import uuid
import pytest
from langgraph_sdk._async.http import HttpClient
from langgraph_sdk._async.store import StoreClient
from langgraph_sdk._sync.http import SyncHttpClient
from langgraph_sdk._sync.store import SyncStoreClient
pytestmark = pytest.mark.integration
def _async_store(raw):
return StoreClient(HttpClient(raw))
def _sync_store(raw):
return SyncStoreClient(SyncHttpClient(raw))
def _unique_namespace(label: str) -> list[str]:
return ["test-integration", label, uuid.uuid4().hex[:12]]
async def test_store_put_get_delete_async(async_threads) -> None:
_, raw = async_threads
store = _async_store(raw)
ns = _unique_namespace("put-async")
key = "doc-1"
payload = {"title": "Hello", "body": "World"}
await store.put_item(ns, key=key, value=payload)
try:
fetched = await store.get_item(ns, key=key)
assert fetched["value"] == payload
assert fetched["namespace"] == ns
assert fetched["key"] == key
finally:
await store.delete_item(ns, key=key)
missing = await store.get_item(ns, key=key)
assert missing is None
def test_store_put_get_delete_sync(sync_threads) -> None:
_, raw = sync_threads
store = _sync_store(raw)
ns = _unique_namespace("put-sync")
key = "doc-1"
payload = {"title": "Hello", "body": "World"}
store.put_item(ns, key=key, value=payload)
try:
fetched = store.get_item(ns, key=key)
assert fetched["value"] == payload
assert fetched["namespace"] == ns
assert fetched["key"] == key
finally:
store.delete_item(ns, key=key)
missing = store.get_item(ns, key=key)
assert missing is None
async def test_store_search_and_list_namespaces_async(async_threads) -> None:
_, raw = async_threads
store = _async_store(raw)
ns = _unique_namespace("search-async")
await store.put_item(ns, key="a", value={"kind": "alpha"})
await store.put_item(ns, key="b", value={"kind": "beta"})
try:
search = await store.search_items(ns, limit=10)
items = search.get("items", search) if isinstance(search, dict) else search
keys = sorted(i["key"] for i in items)
assert keys == ["a", "b"]
namespaces_result = await store.list_namespaces(prefix=ns[:1], limit=100)
namespaces = (
namespaces_result.get("namespaces", namespaces_result)
if isinstance(namespaces_result, dict)
else namespaces_result
)
assert any(list(found) == ns for found in namespaces), (
f"namespace {ns!r} not in list_namespaces result"
)
finally:
await store.delete_item(ns, key="a")
await store.delete_item(ns, key="b")
def test_store_search_and_list_namespaces_sync(sync_threads) -> None:
_, raw = sync_threads
store = _sync_store(raw)
ns = _unique_namespace("search-sync")
store.put_item(ns, key="a", value={"kind": "alpha"})
store.put_item(ns, key="b", value={"kind": "beta"})
try:
search = store.search_items(ns, limit=10)
items = search.get("items", search) if isinstance(search, dict) else search
keys = sorted(i["key"] for i in items)
assert keys == ["a", "b"]
namespaces_result = store.list_namespaces(prefix=ns[:1], limit=100)
namespaces = (
namespaces_result.get("namespaces", namespaces_result)
if isinstance(namespaces_result, dict)
else namespaces_result
)
assert any(list(found) == ns for found in namespaces), (
f"namespace {ns!r} not in list_namespaces result"
)
finally:
store.delete_item(ns, key="a")
store.delete_item(ns, key="b")