Use __future__ imports in scripts (#5301)

scripts/_utils.py

@@ -1,3 +1,5 @@
+from __future__ import annotations
+
 import re
 from pathlib import Path
 

scripts/add_plugin.py

@@ -8,6 +8,7 @@
         --url https://pypi.org/project/flake8-pie/
         --prefix PIE
 """
+from __future__ import annotations
 
 import argparse
 

scripts/add_rule.py

@@ -9,6 +9,7 @@
         --code 807 \
         --linter flake8-pie
 """
+from __future__ import annotations
 
 import argparse
 import subprocess

scripts/check_docs_formatted.py

@@ -1,17 +1,22 @@
 #!/usr/bin/env python3
 """Check code snippets in docs are formatted by black."""
+from __future__ import annotations
+
 import argparse
 import os
 import re
 import textwrap
-from collections.abc import Sequence
 from pathlib import Path
 from re import Match
+from typing import TYPE_CHECKING
 
 import black
 from black.mode import Mode, TargetVersion
 from black.parsing import InvalidInput
 
+if TYPE_CHECKING:
+    from collections.abc import Sequence
+
 TARGET_VERSIONS = ["py37", "py38", "py39", "py310", "py311"]
 SNIPPED_RE = re.compile(
     r"(?P<before>^(?P<indent> *)```\s*python\n)"

scripts/ecosystem_all_check.py

@@ -3,13 +3,14 @@
 
 It's a less elaborate, more hacky version of check_ecosystem.py
 """
+from __future__ import annotations
 
 import json
 import subprocess
 import sys
 from pathlib import Path
 from subprocess import CalledProcessError
-from typing import NamedTuple, Optional
+from typing import NamedTuple
 
 from tqdm import tqdm
 
@@ -19,7 +20,7 @@ class Repository(NamedTuple):
 
     org: str
     repo: str
-    ref: Optional[str]
+    ref: str | None
 
 
 def main() -> None:

scripts/generate_known_standard_library.py

@@ -5,6 +5,7 @@
 
 Only the generation of the file has been modified for use in this project.
 """
+from __future__ import annotations
 
 from pathlib import Path
 

scripts/generate_mkdocs.py

@@ -1,4 +1,6 @@
 """Generate an MkDocs-compatible `docs` and `mkdocs.yml` from the README.md."""
+from __future__ import annotations
+
 import argparse
 import re
 import shutil

scripts/pyproject.toml

@@ -2,7 +2,7 @@
 name = "scripts"
 version = "0.0.1"
 dependencies = ["sphinx"]
-requires-python = ">=3.9"
+requires-python = ">=3.8"
 
 [tool.black]
 line-length = 88
@@ -21,5 +21,8 @@ ignore = [
   "FBT",   # flake8-boolean-trap
 ]
 
+[tool.ruff.isort]
+required-imports = ["from __future__ import annotations"]
+
 [tool.ruff.pydocstyle]
 convention = "pep257"

scripts/transform_readme.py

@@ -4,6 +4,8 @@
 targets have different strategies for rendering light- and dark-mode images. This script
 adjusts the images in the README.md to support the given target.
 """
+from __future__ import annotations
+
 import argparse
 from pathlib import Path
 

scripts/update_ambiguous_characters.py

@@ -1,4 +1,6 @@
 """Generate the confusables.rs file from the VS Code ambiguous.json file."""
+from __future__ import annotations
+
 import json
 import subprocess
 from pathlib import Path

scripts/update_schemastore.py

@@ -4,6 +4,7 @@
 to a new branch tagged with the ruff git hash. You should see a URL to create the PR
 to schemastore in the CLI.
 """
+from __future__ import annotations
 
 import json
 from pathlib import Path