chore: use if TYPE_CHECKING: blocks (#2866)

test/conftest.py

@@ -1,7 +1,8 @@
+from __future__ import annotations
+
 import json
 import os
 import subprocess
-from collections.abc import Generator
 
 import pytest
 from filelock import FileLock
@@ -16,6 +17,10 @@ from cibuildwheel.venv import find_uv
 from . import utils
 from .utils import DEFAULT_CIBW_ENABLE, EMULATED_ARCHS, get_platform
 
+TYPE_CHECKING = False
+if TYPE_CHECKING:
+    from collections.abc import Generator
+
 
 def pytest_addoption(parser: pytest.Parser) -> None:
     parser.addoption(

test/test_0_basic.py

@@ -1,5 +1,6 @@
+from __future__ import annotations
+
 import textwrap
-from pathlib import Path
 
 import packaging.utils
 import pytest
@@ -9,6 +10,10 @@ from cibuildwheel.selector import EnableGroup
 
 from . import test_projects, utils
 
+TYPE_CHECKING = False
+if TYPE_CHECKING:
+    from pathlib import Path
+
 basic_project = test_projects.new_c_project(
     setup_py_add=textwrap.dedent(
         """

test/test_abi3audit.py

@@ -1,11 +1,16 @@
+from __future__ import annotations
+
 import subprocess
 import textwrap
-from pathlib import Path
 
 import pytest
 
 from . import test_projects, utils
 
+TYPE_CHECKING = False
+if TYPE_CHECKING:
+    from pathlib import Path
+
 pyproject_toml = r"""
 [build-system]
 requires = ["setuptools", "wheel"]

test/test_abi_variants.py

@@ -1,10 +1,15 @@
-import textwrap
-from pathlib import Path
+from __future__ import annotations
 
-import pytest
+import textwrap
 
 from . import test_projects, utils
 
+TYPE_CHECKING = False
+if TYPE_CHECKING:
+    from pathlib import Path
+
+    import pytest
+
 pyproject_toml = r"""
 [build-system]
 requires = ["setuptools", "wheel"]

test/test_before_all.py

@@ -1,11 +1,16 @@
+from __future__ import annotations
+
 import subprocess
 import textwrap
-from pathlib import Path
 
 import pytest
 
 from . import test_projects, utils
 
+TYPE_CHECKING = False
+if TYPE_CHECKING:
+    from pathlib import Path
+
 project_with_before_build_asserts = test_projects.new_c_project(
     setup_py_add=textwrap.dedent(
         r"""

test/test_before_build.py

@@ -1,11 +1,16 @@
+from __future__ import annotations
+
 import subprocess
 import textwrap
-from pathlib import Path
 
 import pytest
 
 from . import test_projects, utils
 
+TYPE_CHECKING = False
+if TYPE_CHECKING:
+    from pathlib import Path
+
 # pyodide does not support building without isolation, need to check the base_prefix
 SYS_PREFIX = f"sys.{'base_' if utils.get_platform() == 'pyodide' else ''}prefix"
 

test/test_before_test.py

@@ -1,7 +1,11 @@
-from pathlib import Path
+from __future__ import annotations
 
 from . import test_projects, utils
 
+TYPE_CHECKING = False
+if TYPE_CHECKING:
+    from pathlib import Path
+
 before_test_project = test_projects.new_c_project()
 before_test_project.files["test/spam_test.py"] = r"""
 import sys

test/test_build_frontend_args.py

@@ -1,10 +1,15 @@
+from __future__ import annotations
+
 import subprocess
-from pathlib import Path
 
 import pytest
 
 from . import test_projects, utils
 
+TYPE_CHECKING = False
+if TYPE_CHECKING:
+    from pathlib import Path
+
 
 @pytest.mark.parametrize(
     "frontend_name",

test/test_build_skip.py

@@ -1,8 +1,13 @@
+from __future__ import annotations
+
 import textwrap
-from pathlib import Path
 
 from . import test_projects, utils
 
+TYPE_CHECKING = False
+if TYPE_CHECKING:
+    from pathlib import Path
+
 project_with_skip_asserts = test_projects.new_c_project(
     setup_py_add=textwrap.dedent(
         rf"""

test/test_container_engine.py

@@ -1,9 +1,13 @@
-from pathlib import Path
+from __future__ import annotations
 
 import pytest
 
 from . import test_projects, utils
 
+TYPE_CHECKING = False
+if TYPE_CHECKING:
+    from pathlib import Path
+
 basic_project = test_projects.new_c_project()
 
 

test/test_container_images.py

@@ -1,11 +1,16 @@
+from __future__ import annotations
+
 import platform
 import textwrap
-from pathlib import Path
 
 import pytest
 
 from . import test_projects, utils
 
+TYPE_CHECKING = False
+if TYPE_CHECKING:
+    from pathlib import Path
+
 dockcross_only_project = test_projects.new_c_project(
     setup_py_add=textwrap.dedent(
         r"""

test/test_cpp_standards.py

@@ -1,10 +1,14 @@
-from pathlib import Path
+from __future__ import annotations
 
 import jinja2
 
 from . import utils
 from .test_projects import TestProject
 
+TYPE_CHECKING = False
+if TYPE_CHECKING:
+    from pathlib import Path
+
 cpp_test_project = TestProject()
 
 setup_py_template = r"""

test/test_custom_repair_wheel.py

@@ -1,7 +1,8 @@
+from __future__ import annotations
+
 import subprocess
 import textwrap
 from contextlib import nullcontext as does_not_raise
-from pathlib import Path
 
 import pytest
 
@@ -9,6 +10,10 @@ from test import test_projects
 
 from . import utils
 
+TYPE_CHECKING = False
+if TYPE_CHECKING:
+    from pathlib import Path
+
 basic_project = test_projects.new_c_project()
 basic_project.files["repair.py"] = """
 import shutil

test/test_dependency_versions.py

@@ -1,8 +1,9 @@
+from __future__ import annotations
+
 import json
 import re
 import subprocess
 import textwrap
-from pathlib import Path
 
 import pytest
 
@@ -10,6 +11,10 @@ from cibuildwheel.util import resources
 
 from . import test_projects, utils
 
+TYPE_CHECKING = False
+if TYPE_CHECKING:
+    from pathlib import Path
+
 VERSION_REGEX = r"([\w-]+)==([^;\s]+)"
 
 CHECK_VERSIONS_SCRIPT = """\

test/test_emulation.py

@@ -1,11 +1,16 @@
+from __future__ import annotations
+
 import itertools
 import subprocess
-from pathlib import Path
 
 import pytest
 
 from . import test_projects, utils
 
+TYPE_CHECKING = False
+if TYPE_CHECKING:
+    from pathlib import Path
+
 project_with_a_test = test_projects.new_c_project()
 
 project_with_a_test.files["test/spam_test.py"] = r"""

test/test_environment.py

@@ -1,13 +1,18 @@
+from __future__ import annotations
+
 import os
 import subprocess
 import sys
 import textwrap
-from pathlib import Path
 
 import pytest
 
 from . import test_projects, utils
 
+TYPE_CHECKING = False
+if TYPE_CHECKING:
+    from pathlib import Path
+
 project_with_environment_asserts = test_projects.new_c_project(
     setup_py_add=textwrap.dedent(
         r"""

test/test_from_sdist.py

@@ -1,17 +1,22 @@
+from __future__ import annotations
+
 import os
 import subprocess
 import sys
 import textwrap
-from collections.abc import Mapping
 from pathlib import Path
 from tempfile import TemporaryDirectory
 
-import pytest
-
-from test.test_projects.base import TestProject
-
 from . import test_projects, utils
 
+TYPE_CHECKING = False
+if TYPE_CHECKING:
+    from collections.abc import Mapping
+
+    import pytest
+
+    from test.test_projects.base import TestProject
+
 # utilities
 
 

test/test_ios.py

@@ -1,14 +1,19 @@
+from __future__ import annotations
+
 import os
 import platform
 import shutil
 import subprocess
 import textwrap
-from pathlib import Path
 
 import pytest
 
 from . import test_projects, utils
 
+TYPE_CHECKING = False
+if TYPE_CHECKING:
+    from pathlib import Path
+
 pytestmark = pytest.mark.ios
 
 CIBW_PLATFORM = os.environ.get("CIBW_PLATFORM", "ios")

test/test_linux_python.py

@@ -1,11 +1,16 @@
+from __future__ import annotations
+
 import platform
 import subprocess
-from pathlib import Path
 
 import pytest
 
 from . import test_projects, utils
 
+TYPE_CHECKING = False
+if TYPE_CHECKING:
+    from pathlib import Path
+
 
 def test_python_exist(tmp_path: Path, capfd: pytest.CaptureFixture[str]) -> None:
     if utils.get_platform() != "linux":

test/test_macos_archs.py

@@ -1,10 +1,15 @@
+from __future__ import annotations
+
 import platform
-from pathlib import Path
 
 import pytest
 
 from . import test_projects, utils
 
+TYPE_CHECKING = False
+if TYPE_CHECKING:
+    from pathlib import Path
+
 basic_project = test_projects.new_c_project()
 basic_project.files["tests/test_suite.py"] = r"""
 import platform

test/test_manylinuxXXXX_only.py

@@ -1,11 +1,16 @@
+from __future__ import annotations
+
 import platform
 import textwrap
-from pathlib import Path
 
 import pytest
 
 from . import test_projects, utils
 
+TYPE_CHECKING = False
+if TYPE_CHECKING:
+    from pathlib import Path
+
 # TODO: specify these at runtime according to manylinux_image
 project_with_manylinux_symbols = test_projects.new_c_project(
     spam_c_top_level_add=textwrap.dedent(

test/test_meson_python.py

@@ -1,9 +1,13 @@
-from pathlib import Path
+from __future__ import annotations
 
 import packaging.utils
 
 from . import test_projects, utils
 
+TYPE_CHECKING = False
+if TYPE_CHECKING:
+    from pathlib import Path
+
 meson_project = test_projects.new_meson_project()
 
 

test/test_musllinux_X_Y_only.py

@@ -1,10 +1,15 @@
+from __future__ import annotations
+
 import textwrap
-from pathlib import Path
 
 import pytest
 
 from . import test_projects, utils
 
+TYPE_CHECKING = False
+if TYPE_CHECKING:
+    from pathlib import Path
+
 project_with_manylinux_symbols = test_projects.new_c_project(
     spam_c_top_level_add=textwrap.dedent(
         r"""

test/test_pep518.py

@@ -1,8 +1,14 @@
+from __future__ import annotations
+
 import textwrap
 from pathlib import Path
 
 from . import test_projects, utils
 
+TYPE_CHECKING = False
+if TYPE_CHECKING:
+    from pathlib import Path
+
 basic_project = test_projects.new_c_project(
     setup_py_add=textwrap.dedent(
         """

test/test_projects/base.py

@@ -1,8 +1,13 @@
-from pathlib import Path
+from __future__ import annotations
+
 from typing import Any, Self
 
 import jinja2
 
+TYPE_CHECKING = False
+if TYPE_CHECKING:
+    from pathlib import Path
+
 FilesDict = dict[str, str | jinja2.Template]
 TemplateContext = dict[str, Any]
 

test/test_pure_wheel.py

@@ -1,3 +1,5 @@
+from __future__ import annotations
+
 import subprocess
 from pathlib import Path
 
@@ -7,6 +9,10 @@ from test import test_projects
 
 from . import utils
 
+TYPE_CHECKING = False
+if TYPE_CHECKING:
+    from pathlib import Path
+
 pure_python_project = test_projects.TestProject()
 pure_python_project.files["setup.py"] = """
 from setuptools import Extension, setup

test/test_pyodide.py

@@ -1,9 +1,10 @@
+from __future__ import annotations
+
 import contextlib
 import os
 import subprocess
 import sys
 import textwrap
-from pathlib import Path
 
 import pytest
 
@@ -11,6 +12,10 @@ from cibuildwheel.util.file import CIBW_CACHE_PATH
 
 from . import test_projects, utils
 
+TYPE_CHECKING = False
+if TYPE_CHECKING:
+    from pathlib import Path
+
 pytestmark = pytest.mark.pyodide
 
 CIBW_PLATFORM = os.environ.get("CIBW_PLATFORM", "pyodide")

test/test_ssl.py

@@ -1,10 +1,15 @@
+from __future__ import annotations
+
 import textwrap
-from pathlib import Path
 
 import pytest
 
 from . import test_projects, utils
 
+TYPE_CHECKING = False
+if TYPE_CHECKING:
+    from pathlib import Path
+
 project_with_ssl_tests = test_projects.new_c_project(
     setup_py_add=textwrap.dedent(
         r"""

test/test_subdir_package.py

@@ -1,12 +1,17 @@
+from __future__ import annotations
+
 from pathlib import Path
 
 import jinja2
-import pytest
 
 from . import utils
 from .test_projects import TestProject
 from .test_projects.c import SPAM_C_TEMPLATE
 
+TYPE_CHECKING = False
+if TYPE_CHECKING:
+    import pytest
+
 subdir_package_project = TestProject()
 
 subdir_package_project.files["src/spam/spam.c"] = jinja2.Template(SPAM_C_TEMPLATE)

test/test_testing.py

@@ -1,12 +1,17 @@
+from __future__ import annotations
+
 import inspect
 import subprocess
 import textwrap
-from pathlib import Path
 
 import pytest
 
 from . import test_projects, utils
 
+TYPE_CHECKING = False
+if TYPE_CHECKING:
+    from pathlib import Path
+
 project_with_a_test = test_projects.new_c_project(
     setup_cfg_add=textwrap.dedent(
         r"""

test/test_troubleshooting.py

@@ -1,11 +1,16 @@
+from __future__ import annotations
+
 import subprocess
-from pathlib import Path
 
 import pytest
 
 from . import utils
 from .test_projects import TestProject, new_c_project
 
+TYPE_CHECKING = False
+if TYPE_CHECKING:
+    from pathlib import Path
+
 SO_FILE_WARNING = "NOTE: Shared object (.so) files found in this project."
 
 

test/test_wheel_tag.py

@@ -1,9 +1,13 @@
-from pathlib import Path
+from __future__ import annotations
 
 import pytest
 
 from . import test_projects, utils
 
+TYPE_CHECKING = False
+if TYPE_CHECKING:
+    from pathlib import Path
+
 basic_project = test_projects.new_c_project()
 
 

test/utils.py

@@ -4,11 +4,12 @@ Utility functions used by the cibuildwheel tests.
 This file is added to the PYTHONPATH in the test runner at bin/run_test.py.
 """
 
+from __future__ import annotations
+
 import os
 import platform as pm
 import subprocess
 import sys
-from collections.abc import Generator, Mapping, Sequence
 from pathlib import Path
 from tempfile import TemporaryDirectory
 from typing import Final
@@ -20,6 +21,10 @@ from cibuildwheel.ci import CIProvider, detect_ci_provider
 from cibuildwheel.selector import EnableGroup
 from cibuildwheel.util.file import CIBW_CACHE_PATH
 
+TYPE_CHECKING = False
+if TYPE_CHECKING:
+    from collections.abc import Generator, Mapping, Sequence
+
 EMULATED_ARCHS: Final[list[str]] = sorted(
     arch.value for arch in (Architecture.all_archs("linux") - Architecture.auto_archs("linux"))
 )