Max Isbey
1b74b06753
Cut comment and docstring volume roughly in half across src, tests, examples, and docs_src: removed comments that restate the adjacent code, leftover development narration, section banners, and self-evident Args/Returns blocks, and compressed the remaining docstrings to a Google-style summary line plus only the detail that earns its place. Kept (and tightened) the load-bearing content: Raises sections, deprecation and version-availability notes, spec/RFC/issue references, why-comments for non-obvious decisions, and all coverage pragmas. The generated mcp_types.v* wire modules are untouched.
30 lines
1.2 KiB
Python
30 lines
1.2 KiB
Python
"""`docs/index.md`: the landing-page server does exactly what the page says it does."""
|
|
|
|
import pytest
|
|
from inline_snapshot import snapshot
|
|
from mcp_types import CallToolResult, TextContent, TextResourceContents
|
|
|
|
from docs_src.index.tutorial001 import mcp
|
|
from mcp import Client
|
|
|
|
# `pyproject.toml` globally ignores `mcp.MCPDeprecationWarning` (the SDK still calls those methods
|
|
# internally), but doc examples must never lean on that, so each module re-arms it as an error.
|
|
# Per-module mark, not a conftest hook: a collection hook would affect every test in the session.
|
|
pytestmark = [pytest.mark.anyio, pytest.mark.filterwarnings("error::mcp.MCPDeprecationWarning")]
|
|
|
|
|
|
async def test_add_tool() -> None:
|
|
async with Client(mcp) as client:
|
|
result = await client.call_tool("add", {"a": 1, "b": 2})
|
|
assert result == snapshot(
|
|
CallToolResult(content=[TextContent(type="text", text="3")], structured_content={"result": 3})
|
|
)
|
|
|
|
|
|
async def test_greeting_resource_template() -> None:
|
|
async with Client(mcp) as client:
|
|
result = await client.read_resource("greeting://World")
|
|
assert result.contents == snapshot(
|
|
[TextResourceContents(uri="greeting://World", mime_type="text/plain", text="Hello, World!")]
|
|
)
|