Insert ``from __future__ import annotations``

21 files changed, 46 insertions, 5 deletions

diff --git a/tests/roots/test-ext-autodoc/target/TYPE_CHECKING.py b/tests/roots/test-ext-autodoc/target/TYPE_CHECKING.py
index aa7eb99a6..9d42b3872 100644
--- a/tests/roots/test-ext-autodoc/target/TYPE_CHECKING.py
+++ b/tests/roots/test-ext-autodoc/target/TYPE_CHECKING.py
@@ -1,3 +1,5 @@
+from __future__ import annotations
+
 from typing import TYPE_CHECKING
 
 if TYPE_CHECKING:
diff --git a/tests/roots/test-ext-autodoc/target/__init__.py b/tests/roots/test-ext-autodoc/target/__init__.py
index bb2290be6..d7ee4ac0f 100644
--- a/tests/roots/test-ext-autodoc/target/__init__.py
+++ b/tests/roots/test-ext-autodoc/target/__init__.py
@@ -1,7 +1,7 @@
 import enum
 from io import StringIO
 
-from sphinx.util import save_traceback
+from ._functions_to_import import function_to_be_imported
 
 __all__ = ['Class']
 
diff --git a/tests/roots/test-ext-autodoc/target/_functions_to_import.py b/tests/roots/test-ext-autodoc/target/_functions_to_import.py
new file mode 100644
index 000000000..7663e9798
--- /dev/null
+++ b/tests/roots/test-ext-autodoc/target/_functions_to_import.py
@@ -0,0 +1,8 @@
+from typing import TYPE_CHECKING, Optional
+
+if TYPE_CHECKING:
+    from sphinx.application import Sphinx
+
+
+def function_to_be_imported(app: Optional["Sphinx"]) -> str:
+    """docstring"""
diff --git a/tests/roots/test-ext-autodoc/target/annotated.py b/tests/roots/test-ext-autodoc/target/annotated.py
index 427188256..5b87518f9 100644
--- a/tests/roots/test-ext-autodoc/target/annotated.py
+++ b/tests/roots/test-ext-autodoc/target/annotated.py
@@ -1,3 +1,5 @@
+from __future__ import annotations
+
 from typing import Annotated
 
 
diff --git a/tests/roots/test-ext-autodoc/target/classes.py b/tests/roots/test-ext-autodoc/target/classes.py
index 5ba0294fb..e5cce7a69 100644
--- a/tests/roots/test-ext-autodoc/target/classes.py
+++ b/tests/roots/test-ext-autodoc/target/classes.py
@@ -1,3 +1,5 @@
+from __future__ import annotations
+
 from inspect import Parameter, Signature
 from typing import List, Union
 
diff --git a/tests/roots/test-ext-autodoc/target/final.py b/tests/roots/test-ext-autodoc/target/final.py
index ff78442e7..a8c3860e3 100644
--- a/tests/roots/test-ext-autodoc/target/final.py
+++ b/tests/roots/test-ext-autodoc/target/final.py
@@ -1,3 +1,5 @@
+from __future__ import annotations
+
 import typing
 from typing import final
 
diff --git a/tests/roots/test-ext-autodoc/target/generic_class.py b/tests/roots/test-ext-autodoc/target/generic_class.py
index e6ff38abc..1ec80584d 100644
--- a/tests/roots/test-ext-autodoc/target/generic_class.py
+++ b/tests/roots/test-ext-autodoc/target/generic_class.py
@@ -1,3 +1,5 @@
+from __future__ import annotations
+
 from typing import Generic, TypeVar
 
 T = TypeVar('T')
diff --git a/tests/roots/test-ext-autodoc/target/genericalias.py b/tests/roots/test-ext-autodoc/target/genericalias.py
index 3856e034d..06026fbbc 100644
--- a/tests/roots/test-ext-autodoc/target/genericalias.py
+++ b/tests/roots/test-ext-autodoc/target/genericalias.py
@@ -1,3 +1,5 @@
+from __future__ import annotations
+
 from typing import Callable, List
 
 #: A list of int
diff --git a/tests/roots/test-ext-autodoc/target/overload.py b/tests/roots/test-ext-autodoc/target/overload.py
index 1b395ee5b..902f00915 100644
--- a/tests/roots/test-ext-autodoc/target/overload.py
+++ b/tests/roots/test-ext-autodoc/target/overload.py
@@ -1,3 +1,5 @@
+from __future__ import annotations
+
 from typing import Any, overload
 
 
diff --git a/tests/roots/test-ext-autodoc/target/preserve_defaults.py b/tests/roots/test-ext-autodoc/target/preserve_defaults.py
index 0cc3b4e20..2759f27e8 100644
--- a/tests/roots/test-ext-autodoc/target/preserve_defaults.py
+++ b/tests/roots/test-ext-autodoc/target/preserve_defaults.py
@@ -1,3 +1,5 @@
+from __future__ import annotations
+
 from datetime import datetime
 from typing import Any
 
diff --git a/tests/roots/test-ext-autodoc/target/typehints.py b/tests/roots/test-ext-autodoc/target/typehints.py
index 4acfc8911..de2f6d2a8 100644
--- a/tests/roots/test-ext-autodoc/target/typehints.py
+++ b/tests/roots/test-ext-autodoc/target/typehints.py
@@ -1,3 +1,5 @@
+from __future__ import annotations
+
 import pathlib
 from typing import Any, Tuple, TypeVar, Union
 
diff --git a/tests/roots/test-ext-autodoc/target/typevar.py b/tests/roots/test-ext-autodoc/target/typevar.py
index ff2d46d19..1a02f3e2e 100644
--- a/tests/roots/test-ext-autodoc/target/typevar.py
+++ b/tests/roots/test-ext-autodoc/target/typevar.py
@@ -1,3 +1,5 @@
+from __future__ import annotations
+
 from datetime import date
 from typing import NewType, TypeVar
 
diff --git a/tests/roots/test-ext-autodoc/target/wrappedfunction.py b/tests/roots/test-ext-autodoc/target/wrappedfunction.py
index 0bd2d2069..064d77742 100644
--- a/tests/roots/test-ext-autodoc/target/wrappedfunction.py
+++ b/tests/roots/test-ext-autodoc/target/wrappedfunction.py
@@ -1,3 +1,5 @@
+from __future__ import annotations
+
 from contextlib import contextmanager
 from functools import lru_cache
 from typing import Generator
diff --git a/tests/roots/test-ext-autosummary-filename-map/autosummary_dummy_module.py b/tests/roots/test-ext-autosummary-filename-map/autosummary_dummy_module.py
index 0953b64b9..9fb1256e6 100644
--- a/tests/roots/test-ext-autosummary-filename-map/autosummary_dummy_module.py
+++ b/tests/roots/test-ext-autosummary-filename-map/autosummary_dummy_module.py
@@ -1,3 +1,5 @@
+from __future__ import annotations
+
 from os import path
 from typing import Union
 
diff --git a/tests/test_build_linkcheck.py b/tests/test_build_linkcheck.py
index dfdbb5ff3..0374e5d3f 100644
--- a/tests/test_build_linkcheck.py
+++ b/tests/test_build_linkcheck.py
@@ -1,5 +1,7 @@
 """Test the build process with manpage builder with the test root."""
 
+from __future__ import annotations
+
 import http.server
 import json
 import re
@@ -8,7 +10,6 @@ import time
 import wsgiref.handlers
 from datetime import datetime
 from queue import Queue
-from typing import Dict
 from unittest import mock
 
 import pytest
@@ -555,7 +556,7 @@ def test_too_many_requests_user_timeout(app, capsys):
 
 
 class FakeResponse:
-    headers: Dict[str, str] = {}
+    headers: dict[str, str] = {}
     url = "http://localhost/"
 
 
diff --git a/tests/test_ext_autodoc.py b/tests/test_ext_autodoc.py
index 6b00373f4..ec4388bf0 100644
--- a/tests/test_ext_autodoc.py
+++ b/tests/test_ext_autodoc.py
@@ -808,7 +808,7 @@ def test_autodoc_imported_members(app):
                "imported-members": None,
                "ignore-module-all": None}
     actual = do_autodoc(app, 'module', 'target', options)
-    assert '.. py:function:: save_traceback(app: ~typing.Optional[Sphinx]) -> str' in actual
+    assert '.. py:function:: function_to_be_imported(app: ~typing.Optional[Sphinx]) -> str' in actual
 
 
 @pytest.mark.sphinx('html', testroot='ext-autodoc')
diff --git a/tests/test_ext_autodoc_autoclass.py b/tests/test_ext_autodoc_autoclass.py
index 8d85d7cd3..412f3c955 100644
--- a/tests/test_ext_autodoc_autoclass.py
+++ b/tests/test_ext_autodoc_autoclass.py
@@ -4,6 +4,8 @@ This tests mainly the Documenters; the auto directives are tested in a test
 source file translated by test_build.
 """
 
+from __future__ import annotations
+
 from typing import List, Union
 
 import pytest
diff --git a/tests/test_ext_autodoc_configs.py b/tests/test_ext_autodoc_configs.py
index 31b9139fe..4f0d06bb4 100644
--- a/tests/test_ext_autodoc_configs.py
+++ b/tests/test_ext_autodoc_configs.py
@@ -1588,7 +1588,7 @@ def test_autodoc_default_options(app):
     actual = do_autodoc(app, 'class', 'target.CustomIter')
     assert '   .. py:method:: target.CustomIter' not in actual
     actual = do_autodoc(app, 'module', 'target')
-    assert '.. py:function:: save_traceback(app)' not in actual
+    assert '.. py:function:: function_to_be_imported(app)' not in actual
 
     # with :members:
     app.config.autodoc_default_options = {'members': None}
diff --git a/tests/test_ext_autodoc_mock.py b/tests/test_ext_autodoc_mock.py
index c10350fbe..0802811ae 100644
--- a/tests/test_ext_autodoc_mock.py
+++ b/tests/test_ext_autodoc_mock.py
@@ -1,5 +1,7 @@
 """Test the autodoc extension."""
 
+from __future__ import annotations
+
 import abc
 import sys
 from importlib import import_module
diff --git a/tests/test_util_inspect.py b/tests/test_util_inspect.py
index 753b363da..c7f9914cc 100644
--- a/tests/test_util_inspect.py
+++ b/tests/test_util_inspect.py
@@ -1,5 +1,7 @@
 """Tests util.inspect functions."""
 
+from __future__ import annotations
+
 import ast
 import datetime
 import enum
diff --git a/tests/test_util_nodes.py b/tests/test_util_nodes.py
index ad177a9f0..721851f92 100644
--- a/tests/test_util_nodes.py
+++ b/tests/test_util_nodes.py
@@ -1,4 +1,6 @@
 """Tests uti.nodes functions."""
+from __future__ import annotations
+
 import warnings
 from textwrap import dedent
 from typing import Any