From be8aee3a9673a485584792baebd6399c5de52c02 Mon Sep 17 00:00:00 2001
From: Jeremiah Lowin <153965+jlowin@users.noreply.github.com>
Date: Mon, 6 Jul 2026 21:36:51 -0400
Subject: [PATCH] Skip live-import validation for frozen v2 doc snapshots

---
 tests/docs/test_doc_examples.py | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/tests/docs/test_doc_examples.py b/tests/docs/test_doc_examples.py
index 9e1a8e4ea..3d51e4e2b 100644
--- a/tests/docs/test_doc_examples.py
+++ b/tests/docs/test_doc_examples.py
@@ -121,6 +121,12 @@ def test_doc_examples_quality():
             syntax_failures.append(err)
             continue
 
+        # Frozen version snapshots (docs/v2/...) document older FastMCP releases,
+        # so their imports are validated against a package that no longer ships
+        # them. Syntax-check them above, but skip live-import validation.
+        if Path(ex.path).relative_to(DOCS_DIR).parts[0] == "v2":
+            continue
+
         import_failures.extend(_check_fastmcp_imports(ex))
 
     total = len(examples)