Require the PEP 563 'annotations' future import

Author: AA-Turner

.ruff.toml

@@ -295,7 +295,7 @@ select = [
     "TC001",  # documentation doesn't need type-checking blocks
 ]
 "doc/conf.py" = ["INP001", "W605"]
-"doc/development/tutorials/examples/*" = ["INP001"]
+"doc/development/tutorials/examples/*" = ["I002", "INP001"]
 # allow print() in the tutorial
 "doc/development/tutorials/examples/recipe.py" = [
     "FURB118",
@@ -360,7 +360,7 @@ select = [
 
 # these tests need old ``typing`` generic aliases
 "tests/test_util/test_util_typing.py" = ["UP006", "UP007", "UP035"]
-"tests/test_util/typing_test_data.py" = ["FA100", "PYI030", "UP006", "UP007", "UP035"]
+"tests/test_util/typing_test_data.py" = ["FA100", "I002", "PYI030", "UP006", "UP007", "UP035"]
 
 "utils/*" = [
     "T201",  # whitelist ``print`` for stdout messages
@@ -377,6 +377,9 @@ inline-quotes = "single"
 forced-separate = [
     "tests",
 ]
+required-imports = [
+    "from __future__ import annotations",
+]
 
 [format]
 preview = true

sphinx/__init__.py

@@ -1,5 +1,7 @@
 """The Sphinx documentation toolchain."""
 
+from __future__ import annotations
+
 __version__ = '8.2.0'
 __display_version__ = __version__  # used for command line version
 

sphinx/__main__.py

@@ -1,5 +1,7 @@
 """The Sphinx documentation toolchain."""
 
+from __future__ import annotations
+
 import sys
 
 from sphinx.cmd.build import main

sphinx/builders/latex/nodes.py

@@ -1,5 +1,7 @@
 """Additional nodes for LaTeX writer."""
 
+from __future__ import annotations
+
 from docutils import nodes
 
 

sphinx/environment/adapters/asset.py

@@ -1,8 +1,14 @@
 """Assets adapter for sphinx.environment."""
 
-from sphinx.environment import BuildEnvironment
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
 from sphinx.util._pathlib import _StrPath
 
+if TYPE_CHECKING:
+    from sphinx.environment import BuildEnvironment
+
 
 class ImageAdapter:
     def __init__(self, env: BuildEnvironment) -> None:

sphinx/ext/intersphinx/__main__.py

@@ -1,5 +1,7 @@
 """Command line interface for the intersphinx extension."""
 
+from __future__ import annotations
+
 import logging as _logging
 import sys
 

sphinx/pygments_styles.py

@@ -1,5 +1,7 @@
 """Sphinx theme specific highlighting styles."""
 
+from __future__ import annotations
+
 from pygments.style import Style
 from pygments.styles.friendly import FriendlyStyle
 from pygments.token import (

sphinx/testing/restructuredtext.py

@@ -1,11 +1,18 @@
-from docutils import nodes
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
 from docutils.core import publish_doctree
 
-from sphinx.application import Sphinx
 from sphinx.io import SphinxStandaloneReader
 from sphinx.parsers import RSTParser
 from sphinx.util.docutils import sphinx_domains
 
+if TYPE_CHECKING:
+    from docutils import nodes
+
+    from sphinx.application import Sphinx
+
 
 def parse(app: Sphinx, text: str, docname: str = 'index') -> nodes.document:
     """Parse a string as reStructuredText with Sphinx application."""

sphinx/util/_lines.py

@@ -1,3 +1,6 @@
+from __future__ import annotations
+
+
 def parse_line_num_spec(spec: str, total: int) -> list[int]:
     """Parse a line number spec (such as "1,2,4-6") and return a list of
     wanted line numbers.

sphinx/util/build_phase.py

@@ -1,5 +1,7 @@
 """Build phase of Sphinx application."""
 
+from __future__ import annotations
+
 from enum import IntEnum