mirror of
https://github.com/langchain-ai/langgraph.git
synced 2026-08-17 21:25:46 +02:00
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.
125 lines
3.9 KiB
Python
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")
|