tusk-drift-python-sdk 0.1.22__tar.gz → 0.1.23__tar.gz

{tusk_drift_python_sdk-0.1.22 → tusk_drift_python_sdk-0.1.23}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tusk-drift-python-sdk
-Version: 0.1.22
+Version: 0.1.23
 Summary: Python SDK for Tusk Drift instrumentation and replay
 Author-email: Tusk <support@usetusk.ai>
 License: Apache-2.0
@@ -23,9 +23,9 @@ Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Requires-Python: >=3.9
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: protobuf>=6.0
+Requires-Dist: protobuf>=3.20.0
 Requires-Dist: PyYAML>=6.0
-Requires-Dist: requests>=2.32.5
+Requires-Dist: requests>=2.28.0
 Requires-Dist: tusk-drift-schemas>=0.1.24
 Requires-Dist: aiohttp>=3.9.0
 Requires-Dist: aiofiles>=23.0.0
@@ -42,7 +42,7 @@ Requires-Dist: starlette<0.42.0; extra == "fastapi"
 Provides-Extra: django
 Requires-Dist: Django>=4.2; extra == "django"
 Provides-Extra: rust
-Requires-Dist: drift-core-python>=0.1.7; extra == "rust"
+Requires-Dist: drift-core-python>=0.1.9; extra == "rust"
 Provides-Extra: dev
 Requires-Dist: Flask>=3.1.2; extra == "dev"
 Requires-Dist: fastapi>=0.115.6; extra == "dev"
@@ -61,13 +61,13 @@ Dynamic: license-file
 
 <p align="center">
   <a href="https://pypi.org/project/tusk-drift-python-sdk/"><img src="https://img.shields.io/pypi/v/tusk-drift-python-sdk" alt="PyPI version"></a>
+  <a href="https://pypi.org/project/tusk-drift-python-sdk/"><img alt="PyPI - Python Version" src="https://img.shields.io/pypi/pyversions/tusk-drift-python-sdk"></a>
   <a href="https://opensource.org/licenses/Apache-2.0"><img src="https://img.shields.io/badge/License-Apache_2.0-blue.svg" alt="License: Apache 2.0"></a>
-  <a href="https://github.com/Use-Tusk/drift-python-sdk/commits/main/"><img src="https://img.shields.io/github/last-commit/Use-Tusk/drift-python-sdk" alt="GitHub last commit"></a>
   <a href="https://x.com/usetusk"><img src="https://img.shields.io/twitter/url?url=https%3A%2F%2Fx.com%2Fusetusk&style=flat&logo=x&label=Tusk&color=BF40BF" alt="Tusk X account"></a>
   <a href="https://join.slack.com/t/tusk-community/shared_invite/zt-3fve1s7ie-NAAUn~UpHsf1m_2tdoGjsQ"><img src="https://img.shields.io/badge/slack-badge?style=flat&logo=slack&label=Tusk&color=BF40BF" alt="Tusk Community Slack"></a>
 </p>
 
-The Python Tusk Drift SDK enables fast and deterministic API testing by capturing and replaying API calls made to/from your service. Automatically record real-world API calls, then replay them as tests using the [Tusk CLI](https://github.com/Use-Tusk/tusk-drift-cli) to find regressions. During replay, all outbound requests are intercepted with recorded data to ensure consistent behavior without side-effects.
+The Python Tusk Drift SDK enables fast and deterministic API testing by capturing and replaying API calls made to/from your service. Automatically record real-world API calls, then replay them as tests using the [Tusk CLI](https://github.com/Use-Tusk/tusk-cli) to find regressions. During replay, all outbound requests are intercepted with recorded data to ensure consistent behavior without side-effects.
 
 <div align="center">
 
@@ -124,7 +124,7 @@ If you're using packages or versions not listed above, please create an issue wi
 
 ### Step 1: Install the CLI
 
-First, install the Tusk Drift CLI by following our [CLI installation guide](https://github.com/Use-Tusk/tusk-drift-cli?tab=readme-ov-file#install).
+First, install the Tusk Drift CLI by following our [CLI installation guide](https://github.com/Use-Tusk/tusk-cli?tab=readme-ov-file#install).
 
 ### Step 2: Set up Tusk Drift
 
@@ -135,7 +135,7 @@ Use our AI agent to automatically set up Tusk Drift for your service:
 ```bash
 cd path/to/your/service
 export ANTHROPIC_API_KEY=your-api-key
-tusk setup
+tusk drift setup
 ```
 
 The agent will analyze your codebase, install the SDK, instrument it into your application, create configuration files, and test the setup with recording and replay.
@@ -156,7 +156,7 @@ Alternatively, you can set up Tusk Drift manually:
 
    *For more information about Rust acceleration, refer to [this doc](docs/rust-core-bindings).*
 
-2. Create configuration: Run `tusk init` to create your `.tusk/config.yaml` config file interactively, or create it manually per the [configuration docs](https://github.com/Use-Tusk/tusk-drift-cli/blob/main/docs/configuration.md).
+2. Create configuration: Run `tusk init` to create your `.tusk/config.yaml` config file interactively, or create it manually per the [configuration docs](https://github.com/Use-Tusk/tusk-cli/blob/main/docs/drift/configuration.md).
 
 3. Initialize the SDK: Refer to the [initialization guide](docs/initialization.md) to instrument the SDK in your service.
 

{tusk_drift_python_sdk-0.1.22 → tusk_drift_python_sdk-0.1.23}/README.md

@@ -4,13 +4,13 @@
 
 <p align="center">
   <a href="https://pypi.org/project/tusk-drift-python-sdk/"><img src="https://img.shields.io/pypi/v/tusk-drift-python-sdk" alt="PyPI version"></a>
+  <a href="https://pypi.org/project/tusk-drift-python-sdk/"><img alt="PyPI - Python Version" src="https://img.shields.io/pypi/pyversions/tusk-drift-python-sdk"></a>
   <a href="https://opensource.org/licenses/Apache-2.0"><img src="https://img.shields.io/badge/License-Apache_2.0-blue.svg" alt="License: Apache 2.0"></a>
-  <a href="https://github.com/Use-Tusk/drift-python-sdk/commits/main/"><img src="https://img.shields.io/github/last-commit/Use-Tusk/drift-python-sdk" alt="GitHub last commit"></a>
   <a href="https://x.com/usetusk"><img src="https://img.shields.io/twitter/url?url=https%3A%2F%2Fx.com%2Fusetusk&style=flat&logo=x&label=Tusk&color=BF40BF" alt="Tusk X account"></a>
   <a href="https://join.slack.com/t/tusk-community/shared_invite/zt-3fve1s7ie-NAAUn~UpHsf1m_2tdoGjsQ"><img src="https://img.shields.io/badge/slack-badge?style=flat&logo=slack&label=Tusk&color=BF40BF" alt="Tusk Community Slack"></a>
 </p>
 
-The Python Tusk Drift SDK enables fast and deterministic API testing by capturing and replaying API calls made to/from your service. Automatically record real-world API calls, then replay them as tests using the [Tusk CLI](https://github.com/Use-Tusk/tusk-drift-cli) to find regressions. During replay, all outbound requests are intercepted with recorded data to ensure consistent behavior without side-effects.
+The Python Tusk Drift SDK enables fast and deterministic API testing by capturing and replaying API calls made to/from your service. Automatically record real-world API calls, then replay them as tests using the [Tusk CLI](https://github.com/Use-Tusk/tusk-cli) to find regressions. During replay, all outbound requests are intercepted with recorded data to ensure consistent behavior without side-effects.
 
 <div align="center">
 
@@ -67,7 +67,7 @@ If you're using packages or versions not listed above, please create an issue wi
 
 ### Step 1: Install the CLI
 
-First, install the Tusk Drift CLI by following our [CLI installation guide](https://github.com/Use-Tusk/tusk-drift-cli?tab=readme-ov-file#install).
+First, install the Tusk Drift CLI by following our [CLI installation guide](https://github.com/Use-Tusk/tusk-cli?tab=readme-ov-file#install).
 
 ### Step 2: Set up Tusk Drift
 
@@ -78,7 +78,7 @@ Use our AI agent to automatically set up Tusk Drift for your service:
 ```bash
 cd path/to/your/service
 export ANTHROPIC_API_KEY=your-api-key
-tusk setup
+tusk drift setup
 ```
 
 The agent will analyze your codebase, install the SDK, instrument it into your application, create configuration files, and test the setup with recording and replay.
@@ -99,7 +99,7 @@ Alternatively, you can set up Tusk Drift manually:
 
    *For more information about Rust acceleration, refer to [this doc](docs/rust-core-bindings).*
 
-2. Create configuration: Run `tusk init` to create your `.tusk/config.yaml` config file interactively, or create it manually per the [configuration docs](https://github.com/Use-Tusk/tusk-drift-cli/blob/main/docs/configuration.md).
+2. Create configuration: Run `tusk init` to create your `.tusk/config.yaml` config file interactively, or create it manually per the [configuration docs](https://github.com/Use-Tusk/tusk-cli/blob/main/docs/drift/configuration.md).
 
 3. Initialize the SDK: Refer to the [initialization guide](docs/initialization.md) to instrument the SDK in your service.
 

{tusk_drift_python_sdk-0.1.22 → tusk_drift_python_sdk-0.1.23}/drift/core/drift_sdk.py

@@ -5,6 +5,7 @@ import atexit
 import json
 import logging
 import os
+import platform
 import random
 import stat
 import time
@@ -17,10 +18,11 @@ from opentelemetry.sdk.trace import TracerProvider
 from opentelemetry.trace import SpanKind as OTelSpanKind
 
 from ..instrumentation.registry import install_hooks
+from ..version import SDK_VERSION
 from .communication.communicator import CommunicatorConfig, ProtobufCommunicator
 from .communication.types import MockRequestInput, MockResponseOutput
 from .config import TuskConfig, TuskFileConfig, load_tusk_config
-from .logger import LogLevel, configure_logger
+from .logger import LogLevel, configure_logger, get_log_level
 from .sampling import should_sample, validate_sampling_rate
 from .trace_blocking_manager import TraceBlockingManager, should_block_span
 from .tracing import TdSpanAttributes, TdSpanExporter, TdSpanExporterConfig
@@ -99,13 +101,40 @@ class TuskDrift:
             logger.info("Rust core path enabled at startup (env=%s, reason=%s).", env_display, status["reason"])
             return
 
-        logger.warning(
-            "Rust core path requested but binding unavailable; falling back to Python path (env=%s, reason=%s, error=%s).",
+        logger.info(
+            "Rust core path unavailable at startup; using Python path instead (env=%s, reason=%s, error=%s).",
             env_display,
             status["reason"],
             status["binding_error"],
         )
 
+    def _log_startup_summary(self, env: str, use_remote_export: bool) -> None:
+        service_name = (
+            self.file_config.service.name
+            if self.file_config and self.file_config.service and self.file_config.service.name
+            else "unknown"
+        )
+        service_id = (
+            self.file_config.service.id
+            if self.file_config and self.file_config.service and self.file_config.service.id
+            else "<unset>"
+        )
+
+        logger.info(
+            "SDK initialized successfully (version=%s, mode=%s, env=%s, service=%s, serviceId=%s, exportSpans=%s, samplingRate=%s, logLevel=%s, runtime=python %s, platform=%s/%s).",
+            SDK_VERSION,
+            self.mode,
+            env,
+            service_name,
+            service_id,
+            use_remote_export,
+            self._sampling_rate,
+            get_log_level(),
+            platform.python_version(),
+            platform.system().lower(),
+            platform.machine().lower(),
+        )
+
     @classmethod
     def initialize(
         cls,
@@ -216,8 +245,6 @@ class TuskDrift:
             export_spans_enabled and effective_api_key is not None and effective_observable_service_id is not None
         )
 
-        from ..version import SDK_VERSION as sdk_version
-
         exporter_config = TdSpanExporterConfig(
             base_directory=base_dir,
             mode=instance.mode,
@@ -226,7 +253,7 @@ class TuskDrift:
             api_key=effective_api_key,
             tusk_backend_base_url=effective_backend_url,
             environment=env,
-            sdk_version=sdk_version,
+            sdk_version=SDK_VERSION,
             sdk_instance_id=instance._sdk_instance_id,
         )
         instance.span_exporter = TdSpanExporter(exporter_config)
@@ -236,7 +263,7 @@ class TuskDrift:
         resource = Resource.create(
             {
                 "service.name": service_name,
-                "service.version": sdk_version,
+                "service.version": SDK_VERSION,
                 "deployment.environment": env,
             }
         )
@@ -281,7 +308,7 @@ class TuskDrift:
         atexit.register(instance.shutdown)
 
         cls._initialized = True
-        logger.info("SDK initialized in %s mode", instance.mode)
+        instance._log_startup_summary(env=env, use_remote_export=use_remote_export)
 
         return instance
 
@@ -416,7 +443,7 @@ class TuskDrift:
             pass
 
         try:
-            import httpx  # type: ignore[unresolved-import]
+            import httpx
 
             from ..instrumentation.httpx import HttpxInstrumentation
 
@@ -446,7 +473,7 @@ class TuskDrift:
             pass
 
         try:
-            import sqlalchemy  # type: ignore[unresolved-import]
+            import sqlalchemy
 
             from ..instrumentation.sqlalchemy import SqlAlchemyInstrumentation
 
@@ -463,7 +490,7 @@ class TuskDrift:
 
         # Try psycopg2 first
         try:
-            import psycopg2  # type: ignore[unresolved-import]
+            import psycopg2
 
             from ..instrumentation.psycopg2 import Psycopg2Instrumentation
 
@@ -475,7 +502,7 @@ class TuskDrift:
 
         # Try psycopg (v3)
         try:
-            import psycopg  # type: ignore[unresolved-import]
+            import psycopg
 
             from ..instrumentation.psycopg import PsycopgInstrumentation
 
@@ -491,7 +518,7 @@ class TuskDrift:
             logger.debug("Both psycopg2 and psycopg available - instrumented both")
 
         try:
-            import redis  # type: ignore[unresolved-import]
+            import redis
 
             from ..instrumentation.redis import RedisInstrumentation
 
@@ -501,7 +528,7 @@ class TuskDrift:
             pass
 
         try:
-            import grpc  # type: ignore[unresolved-import]
+            import grpc
 
             from ..instrumentation.grpc import GrpcInstrumentation
 
@@ -619,8 +646,6 @@ class TuskDrift:
         if self._td_span_processor:
             self._td_span_processor.update_app_ready(True)
 
-        logger.debug("Application marked as ready")
-
         if self.mode == TuskDriftMode.REPLAY:
             logger.debug("Replay mode active - ready to serve mocked responses")
         elif self.mode == TuskDriftMode.RECORD:

{tusk_drift_python_sdk-0.1.22 → tusk_drift_python_sdk-0.1.23}/drift/core/mode_utils.py

@@ -113,7 +113,9 @@ def handle_replay_mode(
 
     # Background request: App is ready + not within a trace (no parent span) + not a server request
     if is_app_ready and not current_span_info and not is_server_request:
-        logger.debug("[ModeUtils] Handling no-op request")
+        logger.warning(
+            "[ModeUtils] Background request detected during replay (no active trace context). This typically means a background job, scheduled task, or middleware (e.g., rate limiters, message consumers) is running outside of a test trace. To avoid errors, disable these services when TUSK_DRIFT_MODE=REPLAY."
+        )
         return no_op_request_handler()
 
     return replay_mode_handler()

{tusk_drift_python_sdk-0.1.22 → tusk_drift_python_sdk-0.1.23}/drift/core/rust_core_binding.py

@@ -9,7 +9,10 @@ from __future__ import annotations
 import json
 import logging
 import os
-from typing import Any
+from typing import TYPE_CHECKING, Any
+
+if TYPE_CHECKING:
+    from .types import PackageType, SpanKind, StatusCode
 
 logger = logging.getLogger(__name__)
 
@@ -161,16 +164,16 @@ def build_span_proto_bytes(
     package_name: str,
     instrumentation_name: str,
     submodule_name: str,
-    package_type: int,
+    package_type: PackageType,
     environment: str | None,
-    kind: int,
+    kind: SpanKind,
     input_schema: dict[str, Any],
     output_schema: dict[str, Any],
     input_schema_hash: str,
     output_schema_hash: str,
     input_value_hash: str,
     output_value_hash: str,
-    status_code: int,
+    status_code: StatusCode,
     status_message: str,
     is_pre_app_start: bool,
     is_root_span: bool,
@@ -190,6 +193,14 @@ def build_span_proto_bytes(
     if binding is None:
         return None
     try:
+        from .types import PackageType, SpanKind, StatusCode
+
+        if not isinstance(package_type, PackageType):
+            raise TypeError(f"package_type must be PackageType, got {type(package_type).__name__}")
+        if not isinstance(kind, SpanKind):
+            raise TypeError(f"kind must be SpanKind, got {type(kind).__name__}")
+        if not isinstance(status_code, StatusCode):
+            raise TypeError(f"status_code must be StatusCode, got {type(status_code).__name__}")
         return binding.build_span_proto_bytes_pyobject(
             trace_id,
             span_id,
@@ -198,16 +209,16 @@ def build_span_proto_bytes(
             package_name,
             instrumentation_name,
             submodule_name,
-            package_type,
+            package_type.value,
             environment,
-            kind,
+            kind.value,
             input_schema,
             output_schema,
             input_schema_hash,
             output_schema_hash,
             input_value_hash,
             output_value_hash,
-            status_code,
+            status_code.value,
             status_message,
             is_pre_app_start,
             is_root_span,

{tusk_drift_python_sdk-0.1.22 → tusk_drift_python_sdk-0.1.23}/drift/core/tracing/otel_converter.py

@@ -420,9 +420,6 @@ def otel_span_to_clean_span_data(
     # Convert kind
     kind = otel_span_kind_to_drift(otel_span.kind)
 
-    kind_value = kind.value if hasattr(kind, "value") else kind
-    status_code_value = status.code.value if hasattr(status.code, "value") else status.code
-    package_type_value = package_type.value if hasattr(package_type, "value") else package_type
     span_proto_bytes = build_span_proto_bytes(
         trace_id=trace_id,
         span_id=span_id,
@@ -431,16 +428,16 @@ def otel_span_to_clean_span_data(
         package_name=package_name,
         instrumentation_name=instrumentation_name,
         submodule_name=submodule_name,
-        package_type=package_type_value,
+        package_type=package_type,
         environment=environment,
-        kind=kind_value,
+        kind=kind,
         input_schema=input_schema,
         output_schema=output_schema,
         input_schema_hash=input_schema_hash,
         output_schema_hash=output_schema_hash,
         input_value_hash=input_value_hash,
         output_value_hash=output_value_hash,
-        status_code=status_code_value,
+        status_code=status.code,
         status_message=status.message,
         is_pre_app_start=is_pre_app_start,
         is_root_span=is_root_span,

{tusk_drift_python_sdk-0.1.22 → tusk_drift_python_sdk-0.1.23}/drift/instrumentation/aiohttp/e2e-tests/src/app.py

@@ -6,6 +6,10 @@ import aiohttp
 from flask import Flask, jsonify, request
 
 from drift import TuskDrift
+from drift.instrumentation.e2e_common.external_http import (
+    external_http_timeout_seconds,
+    upstream_url,
+)
 
 # Initialize SDK
 sdk = TuskDrift.initialize(
@@ -14,6 +18,25 @@ sdk = TuskDrift.initialize(
 )
 
 app = Flask(__name__)
+EXTERNAL_HTTP_TIMEOUT_SECONDS = external_http_timeout_seconds()
+
+
+def _configure_aiohttp_for_mock_and_timeouts():
+    original_request = aiohttp.ClientSession._request
+
+    async def patched_request(self, method, str_or_url, *args, **kwargs):
+        session_timeout = getattr(self, "_timeout", None)
+        default_timeout = getattr(aiohttp.client, "DEFAULT_TIMEOUT", None)
+        using_default_session_timeout = session_timeout is default_timeout or session_timeout == default_timeout
+        if "timeout" not in kwargs and using_default_session_timeout:
+            kwargs["timeout"] = aiohttp.ClientTimeout(total=EXTERNAL_HTTP_TIMEOUT_SECONDS)
+        rewritten = upstream_url(str(str_or_url))
+        return await original_request(self, method, rewritten, *args, **kwargs)
+
+    aiohttp.ClientSession._request = patched_request
+
+
+_configure_aiohttp_for_mock_and_timeouts()
 
 
 # =============================================================================

tusk_drift_python_sdk-0.1.23/drift/instrumentation/django/e2e-tests/src/views.py

@@ -0,0 +1,216 @@
+"""Django views for e2e test application."""
+
+import json
+from concurrent.futures import ThreadPoolExecutor
+
+import requests
+from django.http import HttpResponse, JsonResponse
+from django.middleware.csrf import get_token
+from django.views.decorators.csrf import csrf_exempt
+from django.views.decorators.http import require_GET, require_http_methods, require_POST
+from opentelemetry import context as otel_context
+
+from drift.instrumentation.e2e_common.external_http import (
+    external_http_timeout_seconds,
+    upstream_url,
+)
+
+EXTERNAL_HTTP_TIMEOUT_SECONDS = external_http_timeout_seconds()
+
+
+def _run_with_context(ctx, fn, *args, **kwargs):
+    """Helper to run a function with OpenTelemetry context in a thread pool."""
+    token = otel_context.attach(ctx)
+    try:
+        return fn(*args, **kwargs)
+    finally:
+        otel_context.detach(token)
+
+
+@require_GET
+def health(request):
+    """Health check endpoint."""
+    return JsonResponse({"status": "healthy"})
+
+
+@require_GET
+def get_weather(request):
+    """Fetch weather data from external API."""
+    try:
+        response = requests.get(
+            upstream_url("https://api.open-meteo.com/v1/forecast"),
+            params={
+                "latitude": 40.7128,
+                "longitude": -74.0060,
+                "current_weather": "true",
+            },
+            timeout=EXTERNAL_HTTP_TIMEOUT_SECONDS,
+        )
+        weather = response.json()
+
+        return JsonResponse(
+            {
+                "location": "New York",
+                "weather": weather.get("current_weather", {}),
+            }
+        )
+    except Exception as e:
+        return JsonResponse(
+            {
+                "location": "New York",
+                "weather": {},
+                "fallback": True,
+                "error": f"Failed to fetch weather: {str(e)}",
+            }
+        )
+
+
+@require_GET
+def get_user(request, user_id: str):
+    """Fetch user data from external API with seed."""
+    try:
+        response = requests.get(
+            upstream_url("https://randomuser.me/api/"),
+            params={"seed": user_id},
+            timeout=EXTERNAL_HTTP_TIMEOUT_SECONDS,
+        )
+        return JsonResponse(response.json())
+    except Exception as e:
+        return JsonResponse({"results": [], "fallback": True, "error": f"Failed to fetch user: {str(e)}"})
+
+
+@csrf_exempt
+@require_POST
+def create_post(request):
+    """Create a new post via external API."""
+    data = {}
+    try:
+        data = json.loads(request.body)
+        response = requests.post(
+            upstream_url("https://jsonplaceholder.typicode.com/posts"),
+            json={
+                "title": data.get("title"),
+                "body": data.get("body"),
+                "userId": data.get("userId", 1),
+            },
+            timeout=EXTERNAL_HTTP_TIMEOUT_SECONDS,
+        )
+        return JsonResponse(response.json(), status=201)
+    except Exception as e:
+        return JsonResponse(
+            {
+                "id": -1,
+                "title": data.get("title", ""),
+                "body": data.get("body", ""),
+                "userId": data.get("userId", 1),
+                "fallback": True,
+                "error": f"Failed to create post: {str(e)}",
+            },
+            status=201,
+        )
+
+
+@require_GET
+def get_post(request, post_id: int):
+    """Fetch post and comments in parallel using ThreadPoolExecutor."""
+    try:
+        ctx = otel_context.get_current()
+
+        with ThreadPoolExecutor(max_workers=2) as executor:
+            post_future = executor.submit(
+                _run_with_context,
+                ctx,
+                requests.get,
+                upstream_url(f"https://jsonplaceholder.typicode.com/posts/{post_id}"),
+                timeout=EXTERNAL_HTTP_TIMEOUT_SECONDS,
+            )
+            comments_future = executor.submit(
+                _run_with_context,
+                ctx,
+                requests.get,
+                upstream_url(f"https://jsonplaceholder.typicode.com/posts/{post_id}/comments"),
+                timeout=EXTERNAL_HTTP_TIMEOUT_SECONDS,
+            )
+
+            post_response = post_future.result()
+            comments_response = comments_future.result()
+
+        return JsonResponse(
+            {
+                "post": post_response.json(),
+                "comments": comments_response.json(),
+            }
+        )
+    except Exception as e:
+        return JsonResponse(
+            {
+                "post": {},
+                "comments": [],
+                "fallback": True,
+                "error": f"Failed to fetch post: {str(e)}",
+            }
+        )
+
+
+@csrf_exempt
+@require_http_methods(["DELETE"])
+def delete_post(request, post_id: int):
+    """Delete a post via external API."""
+    try:
+        requests.delete(
+            upstream_url(f"https://jsonplaceholder.typicode.com/posts/{post_id}"),
+            timeout=EXTERNAL_HTTP_TIMEOUT_SECONDS,
+        )
+        return JsonResponse({"message": f"Post {post_id} deleted successfully"})
+    except Exception as e:
+        return JsonResponse(
+            {
+                "message": f"Post {post_id} delete fallback",
+                "fallback": True,
+                "error": f"Failed to delete post: {str(e)}",
+            }
+        )
+
+
+@require_GET
+def get_activity(request):
+    """Fetch a random activity suggestion."""
+    try:
+        response = requests.get(
+            upstream_url("https://bored-api.appbrewery.com/random"),
+            timeout=EXTERNAL_HTTP_TIMEOUT_SECONDS,
+        )
+        return JsonResponse(response.json())
+    except Exception as e:
+        return JsonResponse(
+            {
+                "activity": "Take a short walk",
+                "type": "relaxation",
+                "participants": 1,
+                "fallback": True,
+                "error": f"Failed to fetch activity: {str(e)}",
+            }
+        )
+
+
+@require_GET
+def csrf_form(request):
+    """Return an HTML form with CSRF token for testing CSRF normalization.
+
+    This endpoint tests that CSRF tokens are properly normalized during
+    recording so that replay comparisons succeed.
+    """
+    csrf_token = get_token(request)
+    html = f"""<!DOCTYPE html>
+<html>
+<head><title>CSRF Test Form</title></head>
+<body>
+    <h1>CSRF Test Form</h1>
+    <form method="POST" action="/api/submit">
+        <input type="hidden" name="csrfmiddlewaretoken" value="{csrf_token}">
+        <input type="text" name="message" placeholder="Enter message">
+        <button type="submit">Submit</button>
+    </form>
+</body>
+</html>"""
+    return HttpResponse(html, content_type="text/html")