mockserver-client 7.1.0__tar.gz → 7.3.0__tar.gz

{mockserver_client-7.1.0 → mockserver_client-7.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mockserver-client
-Version: 7.1.0
+Version: 7.3.0
 Summary: Official Python client for MockServer — create expectations, verify requests, and register dynamic callbacks via WebSocket
 Author-email: James Bloom <jamesdbloom@gmail.com>
 License-Expression: Apache-2.0
@@ -228,6 +228,83 @@ if client.has_started():
 client.stop()
 ```
 
+## AI Protocol Mocking
+
+Declarative builders mock an MCP (Model Context Protocol) server or an A2A
+(Agent-to-Agent) server with a single fluent chain. Each builder produces a set of
+HTTP expectations that speak JSON-RPC 2.0 and echo the incoming request id.
+
+```python
+from mockserver import mcp_mock, a2a_mock
+
+# Mock an MCP server (Streamable HTTP, JSON-RPC 2.0) on /mcp
+mcp_mock() \
+    .with_tool("get_weather") \
+        .with_description("Get weather for a city") \
+        .with_input_schema('{"type": "object", "properties": {"city": {"type": "string"}}}') \
+        .responding_with("72F and sunny") \
+        .and_() \
+    .apply_to(client)
+
+# Mock an A2A agent on /a2a (agent card + tasks/send|get|cancel)
+a2a_mock() \
+    .with_agent_name("TranslatorAgent") \
+    .with_skill("translate") \
+        .with_name("Translation") \
+        .with_description("Translates text between languages") \
+        .with_tag("i18n") \
+        .with_example("Translate hello to Spanish") \
+        .and_() \
+    .on_task_send() \
+        .matching_message("translate.*") \
+        .responding_with("Hola") \
+        .and_() \
+    .apply_to(client)
+```
+
+The A2A builder also supports streaming (SSE) and push notifications:
+
+```python
+a2a_mock() \
+    .with_streaming() \
+    .with_push_notifications("http://localhost:1234/callback") \
+    .apply_to(client)
+```
+
+`build()` returns the list of `Expectation` objects without registering them, so
+you can inspect or persist them; `apply_to(client)` registers them via `upsert`.
+
+## SRE / Resilience
+
+Verify a service-level objective over recorded SLI samples, or run a scheduled
+multi-stage chaos experiment. Both require the corresponding server feature to be
+enabled (`sloTrackingEnabled`, chaos experiments).
+
+```python
+# Verify an SLO — a FAIL verdict (HTTP 406) raises MockServerVerificationError
+verdict = client.verify_slo({
+    "name": "checkout",
+    "minimumSampleCount": 100,
+    "objectives": [
+        {"sli": "errorRate", "comparator": "LESS_THAN", "threshold": 0.01},
+        {"sli": "p99LatencyMs", "comparator": "LESS_THAN", "threshold": 250},
+    ],
+})
+print(verdict["result"])  # PASS or INCONCLUSIVE
+
+# Start a multi-stage chaos experiment (only one may be active at a time)
+client.start_chaos_experiment({
+    "name": "latency-injection",
+    "loop": False,
+    "stages": [
+        {"durationMillis": 60000, "profiles": {"payments.svc": {"latencyMs": 500}}},
+    ],
+})
+```
+
+Both methods are available on the async client too (`await client.verify_slo(...)`,
+`await client.start_chaos_experiment(...)`).
+
 ## TLS Support
 
 ```python
@@ -352,7 +429,7 @@ launcher_path = ensure_binary()  # returns Path to the launcher executable
 ```python
 from mockserver.launcher import start
 
-server = start(port=1080, version="7.1.0")
+server = start(port=1080, version="7.3.0")
 # ...
 server.stop()
 ```

{mockserver_client-7.1.0 → mockserver_client-7.3.0}/README.md

@@ -198,6 +198,83 @@ if client.has_started():
 client.stop()
 ```
 
+## AI Protocol Mocking
+
+Declarative builders mock an MCP (Model Context Protocol) server or an A2A
+(Agent-to-Agent) server with a single fluent chain. Each builder produces a set of
+HTTP expectations that speak JSON-RPC 2.0 and echo the incoming request id.
+
+```python
+from mockserver import mcp_mock, a2a_mock
+
+# Mock an MCP server (Streamable HTTP, JSON-RPC 2.0) on /mcp
+mcp_mock() \
+    .with_tool("get_weather") \
+        .with_description("Get weather for a city") \
+        .with_input_schema('{"type": "object", "properties": {"city": {"type": "string"}}}') \
+        .responding_with("72F and sunny") \
+        .and_() \
+    .apply_to(client)
+
+# Mock an A2A agent on /a2a (agent card + tasks/send|get|cancel)
+a2a_mock() \
+    .with_agent_name("TranslatorAgent") \
+    .with_skill("translate") \
+        .with_name("Translation") \
+        .with_description("Translates text between languages") \
+        .with_tag("i18n") \
+        .with_example("Translate hello to Spanish") \
+        .and_() \
+    .on_task_send() \
+        .matching_message("translate.*") \
+        .responding_with("Hola") \
+        .and_() \
+    .apply_to(client)
+```
+
+The A2A builder also supports streaming (SSE) and push notifications:
+
+```python
+a2a_mock() \
+    .with_streaming() \
+    .with_push_notifications("http://localhost:1234/callback") \
+    .apply_to(client)
+```
+
+`build()` returns the list of `Expectation` objects without registering them, so
+you can inspect or persist them; `apply_to(client)` registers them via `upsert`.
+
+## SRE / Resilience
+
+Verify a service-level objective over recorded SLI samples, or run a scheduled
+multi-stage chaos experiment. Both require the corresponding server feature to be
+enabled (`sloTrackingEnabled`, chaos experiments).
+
+```python
+# Verify an SLO — a FAIL verdict (HTTP 406) raises MockServerVerificationError
+verdict = client.verify_slo({
+    "name": "checkout",
+    "minimumSampleCount": 100,
+    "objectives": [
+        {"sli": "errorRate", "comparator": "LESS_THAN", "threshold": 0.01},
+        {"sli": "p99LatencyMs", "comparator": "LESS_THAN", "threshold": 250},
+    ],
+})
+print(verdict["result"])  # PASS or INCONCLUSIVE
+
+# Start a multi-stage chaos experiment (only one may be active at a time)
+client.start_chaos_experiment({
+    "name": "latency-injection",
+    "loop": False,
+    "stages": [
+        {"durationMillis": 60000, "profiles": {"payments.svc": {"latencyMs": 500}}},
+    ],
+})
+```
+
+Both methods are available on the async client too (`await client.verify_slo(...)`,
+`await client.start_chaos_experiment(...)`).
+
 ## TLS Support
 
 ```python
@@ -322,7 +399,7 @@ launcher_path = ensure_binary()  # returns Path to the launcher executable
 ```python
 from mockserver.launcher import start
 
-server = start(port=1080, version="7.1.0")
+server = start(port=1080, version="7.3.0")
 # ...
 server.stop()
 ```

{mockserver_client-7.1.0 → mockserver_client-7.3.0}/mockserver/__init__.py

@@ -3,6 +3,8 @@ from mockserver.models import (
     BinaryResponse,
     Body,
     ConnectionOptions,
+    CrossProtocolScenario,
+    CrossProtocolTrigger,
     Delay,
     DelayDistribution,
     DnsRecord,
@@ -26,12 +28,24 @@ from mockserver.models import (
     HttpSseResponse,
     HttpTemplate,
     HttpWebSocketResponse,
+    JsonPathBody,
     JsonRpcBody,
     KeyToMultiValue,
+    LoadCapture,
+    LoadFeeder,
+    LoadPacing,
+    LoadProfile,
+    LoadScenario,
+    LoadShape,
+    LoadStage,
+    LoadStep,
+    LoadThreshold,
+    MockMode,
     OpenAPIDefinition,
     OpenAPIExpectation,
     Ports,
     RequestDefinition,
+    ResponseMode,
     SocketAddress,
     SseEvent,
     TimeToLive,
@@ -41,6 +55,37 @@ from mockserver.models import (
     VerificationTimes,
     WebSocketMessage,
 )
+from mockserver.llm import (
+    Completion,
+    ConversationPredicates,
+    EmbeddingResponse,
+    HttpLlmResponse,
+    IsolationSource,
+    LlmChaosProfile,
+    LlmConversationBuilder,
+    LlmFailoverBuilder,
+    LlmMockBuilder,
+    NormalizationOptions,
+    Provider,
+    Role,
+    StreamingPhysics,
+    ToolUse,
+    TurnBuilder,
+    Usage,
+    completion,
+    conversation,
+    cookie,
+    embedding,
+    header,
+    llm_failover,
+    llm_mock,
+    llm_response,
+    query_parameter,
+    streaming_physics,
+    time_to_first_token,
+    tool_use,
+    usage,
+)
 from mockserver.exceptions import (
     MockServerCallbackError,
     MockServerConnectionError,
@@ -49,6 +94,19 @@ from mockserver.exceptions import (
     MockServerWebSocketError,
 )
 from mockserver.client import MockServerClient
+from mockserver.mcp import (
+    McpMockBuilder,
+    McpPromptBuilder,
+    McpResourceBuilder,
+    McpToolBuilder,
+    mcp_mock,
+)
+from mockserver.a2a import (
+    A2aMockBuilder,
+    A2aSkillBuilder,
+    A2aTaskHandlerBuilder,
+    a2a_mock,
+)
 from mockserver.async_client import AsyncMockServerClient
 from mockserver.launcher import (
     MockServerProcess,
@@ -65,6 +123,8 @@ __all__ = [
     "BinaryResponse",
     "Body",
     "ConnectionOptions",
+    "CrossProtocolScenario",
+    "CrossProtocolTrigger",
     "Delay",
     "DelayDistribution",
     "DnsRecord",
@@ -88,8 +148,57 @@ __all__ = [
     "HttpSseResponse",
     "HttpTemplate",
     "HttpWebSocketResponse",
+    "JsonPathBody",
     "JsonRpcBody",
     "KeyToMultiValue",
+    "LoadCapture",
+    "LoadFeeder",
+    "LoadPacing",
+    "LoadProfile",
+    "LoadScenario",
+    "LoadShape",
+    "LoadStage",
+    "LoadStep",
+    "LoadThreshold",
+    "MockMode",
+    "Completion",
+    "ConversationPredicates",
+    "EmbeddingResponse",
+    "HttpLlmResponse",
+    "IsolationSource",
+    "LlmChaosProfile",
+    "LlmConversationBuilder",
+    "LlmFailoverBuilder",
+    "LlmMockBuilder",
+    "NormalizationOptions",
+    "Provider",
+    "Role",
+    "StreamingPhysics",
+    "ToolUse",
+    "TurnBuilder",
+    "Usage",
+    "completion",
+    "conversation",
+    "cookie",
+    "embedding",
+    "header",
+    "llm_failover",
+    "llm_mock",
+    "llm_response",
+    "query_parameter",
+    "streaming_physics",
+    "time_to_first_token",
+    "tool_use",
+    "usage",
+    "McpMockBuilder",
+    "McpPromptBuilder",
+    "McpResourceBuilder",
+    "McpToolBuilder",
+    "mcp_mock",
+    "A2aMockBuilder",
+    "A2aSkillBuilder",
+    "A2aTaskHandlerBuilder",
+    "a2a_mock",
     "MockServerCallbackError",
     "MockServerClient",
     "MockServerConnectionError",
@@ -100,6 +209,7 @@ __all__ = [
     "OpenAPIExpectation",
     "Ports",
     "RequestDefinition",
+    "ResponseMode",
     "SocketAddress",
     "SseEvent",
     "TimeToLive",