mirror of
https://github.com/langchain-ai/langgraph.git
synced 2026-08-17 21:25:46 +02:00
Elior Nataf LackritzandGitHub
ea5f9cc9fb
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.
104 lines
3.0 KiB
TOML
104 lines
3.0 KiB
TOML
[build-system]
|
|
requires = ["hatchling"]
|
|
build-backend = "hatchling.build"
|
|
|
|
[project]
|
|
name = "langgraph-sdk"
|
|
dynamic = ["version"]
|
|
description = "SDK for interacting with LangGraph API"
|
|
authors = []
|
|
requires-python = ">=3.10"
|
|
readme = "README.md"
|
|
license = "MIT"
|
|
license-files = ['LICENSE']
|
|
dependencies = [
|
|
"httpx>=0.25.2",
|
|
"orjson>=3.11.5",
|
|
"langchain-protocol>=0.0.15",
|
|
"langchain-core>=1.4.0,<2",
|
|
"websockets>=14,<17",
|
|
]
|
|
|
|
[tool.hatch.version]
|
|
path = "langgraph_sdk/__init__.py"
|
|
|
|
[project.urls]
|
|
Source = "https://github.com/langchain-ai/langgraph/tree/main/libs/sdk-py"
|
|
Twitter = "https://x.com/langchain_oss"
|
|
Slack = "https://www.langchain.com/join-community"
|
|
Reddit = "https://www.reddit.com/r/LangChain/"
|
|
|
|
[dependency-groups]
|
|
test = [
|
|
"pytest",
|
|
"pytest-asyncio",
|
|
"pytest-mock",
|
|
"pytest-watch",
|
|
]
|
|
lint = [
|
|
"ruff==0.15.20",
|
|
"codespell",
|
|
"ty",
|
|
"starlette",
|
|
]
|
|
dev = [
|
|
{ include-group = "test" },
|
|
{ include-group = "lint" },
|
|
"langgraph",
|
|
"pydantic>=2.12.4",
|
|
]
|
|
|
|
[tool.hatch.build.targets.wheel]
|
|
include = ["langgraph_sdk"]
|
|
|
|
[tool.pytest.ini_options]
|
|
addopts = "--strict-markers --strict-config --durations=5 -vv -m 'not integration'"
|
|
asyncio_mode = "auto"
|
|
markers = [
|
|
"integration: end-to-end tests that require a running langgraph-api stack at http://localhost:2024. Excluded from `make test` by default; opt in with `pytest -m integration` (and the autouse fixture skips if the API is unreachable).",
|
|
]
|
|
|
|
[tool.uv]
|
|
default-groups = ['dev']
|
|
|
|
[tool.uv.sources]
|
|
langgraph = { path = "../langgraph", editable = true }
|
|
|
|
[tool.ruff]
|
|
exclude = ["venv", ".venv", "build", "dist"]
|
|
[tool.ruff.lint]
|
|
select = [
|
|
"E", # pycodestyle errors
|
|
"F", # pyflakes
|
|
"I", # isort (import sorting)
|
|
"ARG", # unused arguments
|
|
"TID251", # banned imports
|
|
"TID252", # banned relative imports
|
|
"T20", # print statements
|
|
"UP", # pyupgrade (Python version-specific fixes)
|
|
"B", # flake8-bugbear (common bugs)
|
|
"SIM", # flake8-simplify (code simplification)
|
|
"RUF", # ruff-specific rules
|
|
"S101", # flake8-bandit: use of assert
|
|
"PLC0415", # import-outside-top-level
|
|
]
|
|
ignore = [
|
|
"E501", # line too long (handled by formatter)
|
|
"B006", # mutable default arguments (sometimes intentional)
|
|
"B904", # raise without from inside except (sometimes intentional)
|
|
"SIM102", # nested if statements (sometimes clearer)
|
|
]
|
|
# PLC0415 (import-outside-top-level) is enforced in tests only. Library code
|
|
# still has deferred imports that have not been reviewed, so it stays exempt
|
|
# for now.
|
|
per-file-ignores = { "tests/**" = ["S101", "B017"], "integration/**" = ["S101", "T20", "B017", "ARG001", "ARG002", "PLC0415"], "langgraph_sdk/**" = ["PLC0415"] }
|
|
|
|
[tool.ty.src]
|
|
# The `integration/` graphs run inside the docker image (with `deepagents`
|
|
# and other graph-only deps installed there) and are not part of the SDK
|
|
# package surface, so we don't typecheck them in the sdk-py venv.
|
|
exclude = ["integration"]
|
|
|
|
[tool.ty.rules]
|
|
no-matching-overload = "ignore"
|