mockserver-client 7.2.0__tar.gz → 7.4.0__tar.gz

{mockserver_client-7.2.0 → mockserver_client-7.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mockserver-client
-Version: 7.2.0
+Version: 7.4.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
@@ -190,6 +190,63 @@ client.verify_sequence(
 client.verify_zero_interactions()
 ```
 
+## Request Matching
+
+### JWT matcher
+
+Match requests by the claims (and metadata) of a JWT carried in a header. Each
+claim value is exact-or-regex; prefix a value with `!` to negate it.
+
+```python
+from mockserver import HttpRequest, HttpResponse, Jwt
+
+client.when(
+    HttpRequest.request("/secure")
+        .with_method("GET")
+        .with_jwt(
+            claims={
+                "sub": "user-123",           # exact match
+                "email": "^.+@example.com$", # regex match
+                "role": "!admin",            # negated — matches any role except admin
+            },
+            issuer="https://issuer.example.com",
+            audience="my-api",
+            algorithm="RS256",
+            header="authorization",          # optional (defaults to Authorization)
+            scheme="Bearer",                 # optional token scheme
+        )
+).respond(
+    HttpResponse.response("granted", status_code=200)
+)
+
+# ...or pass a Jwt object directly:
+HttpRequest.request("/secure").with_jwt(Jwt(claims={"sub": "user-123"}))
+```
+
+### allOf body matcher
+
+Require a request body to satisfy **all** of several body matchers at once.
+
+```python
+from mockserver import AllOfBody, Body, JsonPathBody, RegexBody, HttpRequest
+
+client.when(
+    HttpRequest.request("/api/orders")
+        .with_method("POST")
+        .with_body(AllOfBody(body_all_of=[
+            JsonPathBody(json_path="$.name"),   # body has a name field
+            RegexBody(regex=".*active.*"),      # and mentions "active"
+        ]))
+).respond(
+    HttpResponse.response("ok")
+)
+
+# Shorthand factory:
+HttpRequest.request("/api/orders").with_body(
+    Body.all_of(JsonPathBody(json_path="$.name"), RegexBody(regex=".*active.*"))
+)
+```
+
 ## Retrieval
 
 ```python
@@ -228,6 +285,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 +486,7 @@ launcher_path = ensure_binary()  # returns Path to the launcher executable
 ```python
 from mockserver.launcher import start
 
-server = start(port=1080, version="7.2.0")
+server = start(port=1080, version="7.4.0")
 # ...
 server.stop()
 ```

{mockserver_client-7.2.0 → mockserver_client-7.4.0}/README.md

@@ -160,6 +160,63 @@ client.verify_sequence(
 client.verify_zero_interactions()
 ```
 
+## Request Matching
+
+### JWT matcher
+
+Match requests by the claims (and metadata) of a JWT carried in a header. Each
+claim value is exact-or-regex; prefix a value with `!` to negate it.
+
+```python
+from mockserver import HttpRequest, HttpResponse, Jwt
+
+client.when(
+    HttpRequest.request("/secure")
+        .with_method("GET")
+        .with_jwt(
+            claims={
+                "sub": "user-123",           # exact match
+                "email": "^.+@example.com$", # regex match
+                "role": "!admin",            # negated — matches any role except admin
+            },
+            issuer="https://issuer.example.com",
+            audience="my-api",
+            algorithm="RS256",
+            header="authorization",          # optional (defaults to Authorization)
+            scheme="Bearer",                 # optional token scheme
+        )
+).respond(
+    HttpResponse.response("granted", status_code=200)
+)
+
+# ...or pass a Jwt object directly:
+HttpRequest.request("/secure").with_jwt(Jwt(claims={"sub": "user-123"}))
+```
+
+### allOf body matcher
+
+Require a request body to satisfy **all** of several body matchers at once.
+
+```python
+from mockserver import AllOfBody, Body, JsonPathBody, RegexBody, HttpRequest
+
+client.when(
+    HttpRequest.request("/api/orders")
+        .with_method("POST")
+        .with_body(AllOfBody(body_all_of=[
+            JsonPathBody(json_path="$.name"),   # body has a name field
+            RegexBody(regex=".*active.*"),      # and mentions "active"
+        ]))
+).respond(
+    HttpResponse.response("ok")
+)
+
+# Shorthand factory:
+HttpRequest.request("/api/orders").with_body(
+    Body.all_of(JsonPathBody(json_path="$.name"), RegexBody(regex=".*active.*"))
+)
+```
+
 ## Retrieval
 
 ```python
@@ -198,6 +255,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 +456,7 @@ launcher_path = ensure_binary()  # returns Path to the launcher executable
 ```python
 from mockserver.launcher import start
 
-server = start(port=1080, version="7.2.0")
+server = start(port=1080, version="7.4.0")
 # ...
 server.stop()
 ```

{mockserver_client-7.2.0 → mockserver_client-7.4.0}/mockserver/__init__.py

@@ -1,17 +1,24 @@
 from mockserver.models import (
     AfterAction,
+    AllOfBody,
     BinaryResponse,
     Body,
+    CaptureRule,
+    CaptureSource,
     ConnectionOptions,
     CrossProtocolScenario,
     CrossProtocolTrigger,
     Delay,
     DelayDistribution,
     DnsRecord,
+    DnsRecordClass,
+    DnsRecordType,
+    DnsRequestDefinition,
     DnsResponse,
     Expectation,
     ExpectationId,
     ExpectationStep,
+    GraphQLBody,
     GrpcBidiResponse,
     GrpcBidiRule,
     GrpcStreamMessage,
@@ -20,6 +27,8 @@ from mockserver.models import (
     HttpClassCallback,
     HttpError,
     HttpForward,
+    HttpForwardValidateAction,
+    HttpForwardWithFallback,
     HttpObjectCallback,
     HttpOverrideForwardedRequest,
     HttpRequest,
@@ -30,14 +39,33 @@ from mockserver.models import (
     HttpWebSocketResponse,
     JsonPathBody,
     JsonRpcBody,
+    JsonSchemaBody,
+    Jwt,
     KeyToMultiValue,
+    MultipartBody,
+    ParameterBody,
+    Protocol,
+    RateLimit,
+    RateLimitAlgorithm,
+    ValidationMode,
+    WasmBody,
+    XmlBody,
+    XmlSchemaBody,
+    XPathBody,
+    LoadCapture,
+    LoadFeeder,
+    LoadPacing,
     LoadProfile,
     LoadScenario,
+    LoadShape,
     LoadStage,
     LoadStep,
+    LoadThreshold,
+    MockMode,
     OpenAPIDefinition,
     OpenAPIExpectation,
     Ports,
+    RegexBody,
     RequestDefinition,
     ResponseMode,
     SocketAddress,
@@ -47,10 +75,12 @@ from mockserver.models import (
     Verification,
     VerificationSequence,
     VerificationTimes,
+    WebSocketFrameMatcher,
     WebSocketMessage,
 )
 from mockserver.llm import (
     Completion,
+    ContentFilter,
     ConversationPredicates,
     EmbeddingResponse,
     HttpLlmResponse,
@@ -59,14 +89,17 @@ from mockserver.llm import (
     LlmConversationBuilder,
     LlmFailoverBuilder,
     LlmMockBuilder,
+    ModerationResponse,
     NormalizationOptions,
     Provider,
+    RerankResponse,
     Role,
     StreamingPhysics,
     ToolUse,
     TurnBuilder,
     Usage,
     completion,
+    content_filter,
     conversation,
     cookie,
     embedding,
@@ -74,7 +107,9 @@ from mockserver.llm import (
     llm_failover,
     llm_mock,
     llm_response,
+    moderation,
     query_parameter,
+    rerank,
     streaming_physics,
     time_to_first_token,
     tool_use,
@@ -95,6 +130,12 @@ from mockserver.mcp import (
     McpToolBuilder,
     mcp_mock,
 )
+from mockserver.a2a import (
+    A2aMockBuilder,
+    A2aSkillBuilder,
+    A2aTaskHandlerBuilder,
+    a2a_mock,
+)
 from mockserver.async_client import AsyncMockServerClient
 from mockserver.launcher import (
     MockServerProcess,
@@ -107,19 +148,26 @@ from mockserver.launcher import (
 
 __all__ = [
     "AfterAction",
+    "AllOfBody",
     "AsyncMockServerClient",
     "BinaryResponse",
     "Body",
+    "CaptureRule",
+    "CaptureSource",
     "ConnectionOptions",
     "CrossProtocolScenario",
     "CrossProtocolTrigger",
     "Delay",
     "DelayDistribution",
     "DnsRecord",
+    "DnsRecordClass",
+    "DnsRecordType",
+    "DnsRequestDefinition",
     "DnsResponse",
     "Expectation",
     "ExpectationId",
     "ExpectationStep",
+    "GraphQLBody",
     "GrpcBidiResponse",
     "GrpcBidiRule",
     "GrpcStreamMessage",
@@ -128,6 +176,8 @@ __all__ = [
     "HttpClassCallback",
     "HttpError",
     "HttpForward",
+    "HttpForwardValidateAction",
+    "HttpForwardWithFallback",
     "HttpObjectCallback",
     "HttpOverrideForwardedRequest",
     "HttpRequest",
@@ -138,12 +188,31 @@ __all__ = [
     "HttpWebSocketResponse",
     "JsonPathBody",
     "JsonRpcBody",
+    "JsonSchemaBody",
+    "Jwt",
     "KeyToMultiValue",
+    "MultipartBody",
+    "ParameterBody",
+    "Protocol",
+    "RateLimit",
+    "RateLimitAlgorithm",
+    "ValidationMode",
+    "WasmBody",
+    "XmlBody",
+    "XmlSchemaBody",
+    "XPathBody",
+    "LoadCapture",
+    "LoadFeeder",
+    "LoadPacing",
     "LoadProfile",
     "LoadScenario",
+    "LoadShape",
     "LoadStage",
     "LoadStep",
+    "LoadThreshold",
+    "MockMode",
     "Completion",
+    "ContentFilter",
     "ConversationPredicates",
     "EmbeddingResponse",
     "HttpLlmResponse",
@@ -152,14 +221,17 @@ __all__ = [
     "LlmConversationBuilder",
     "LlmFailoverBuilder",
     "LlmMockBuilder",
+    "ModerationResponse",
     "NormalizationOptions",
     "Provider",
+    "RerankResponse",
     "Role",
     "StreamingPhysics",
     "ToolUse",
     "TurnBuilder",
     "Usage",
     "completion",
+    "content_filter",
     "conversation",
     "cookie",
     "embedding",
@@ -167,7 +239,9 @@ __all__ = [
     "llm_failover",
     "llm_mock",
     "llm_response",
+    "moderation",
     "query_parameter",
+    "rerank",
     "streaming_physics",
     "time_to_first_token",
     "tool_use",
@@ -177,6 +251,10 @@ __all__ = [
     "McpResourceBuilder",
     "McpToolBuilder",
     "mcp_mock",
+    "A2aMockBuilder",
+    "A2aSkillBuilder",
+    "A2aTaskHandlerBuilder",
+    "a2a_mock",
     "MockServerCallbackError",
     "MockServerClient",
     "MockServerConnectionError",
@@ -186,6 +264,7 @@ __all__ = [
     "OpenAPIDefinition",
     "OpenAPIExpectation",
     "Ports",
+    "RegexBody",
     "RequestDefinition",
     "ResponseMode",
     "SocketAddress",
@@ -195,6 +274,7 @@ __all__ = [
     "Verification",
     "VerificationSequence",
     "VerificationTimes",
+    "WebSocketFrameMatcher",
     "WebSocketMessage",
     "MockServerProcess",
     "bundle_base_name",