From 0000000000000000000000000000000000000000 Mon Sep 17 00:00:00 2001
From: Matej Cepl <mcepl@suse.com>
Date: Thu, 10 Sep 2026 01:00:00 +0000
Subject: [PATCH] docs: import extension annotation types at runtime

Import Node, Sphinx, and BuildEnvironment at runtime rather than under
TYPE_CHECKING. Sphinx 9 evaluates extension annotations while loading
them, and building without postponed evaluation evaluates parameter types
at definition time. Also fall back to object if ExtensionMetadata cannot
be imported from sphinx.util.typing on older Sphinx versions.
Index: Python-3.13.16/Doc/tools/extensions/changes.py
===================================================================
--- Python-3.13.16.orig/Doc/tools/extensions/changes.py	2026-10-09 18:11:24.665201699 +0200
+++ Python-3.13.16/Doc/tools/extensions/changes.py	2026-10-09 18:12:29.273112604 +0200
@@ -3,21 +3,21 @@
 import re
 
 from docutils import nodes
+from docutils.nodes import Node
 from sphinx import addnodes
+from sphinx.application import Sphinx
 from sphinx.builders.changes import ChangesBuilder
+from sphinx.environment import BuildEnvironment
 from sphinx.domains.changeset import (
     VersionChange,
     versionlabel_classes,
     versionlabels,
 )
 from sphinx.locale import _ as sphinx_gettext
-
-TYPE_CHECKING = False
-if TYPE_CHECKING:
-    from docutils.nodes import Node
-    from sphinx.application import Sphinx
-    from sphinx.environment import BuildEnvironment
+try:
     from sphinx.util.typing import ExtensionMetadata
+except ImportError:
+    ExtensionMetadata = object
 
 
 def expand_version_arg(argument: str, release: str) -> str:
