refactor: upgrade type annotations to Python 3.10+ syntax

Replace Union[X, Y] with X | Y and add future annotations to version template.

Changes:
- vcs-versioning/src/vcs_versioning/_pyproject_reading.py:
  - GivenPyProjectResult: Union[...] -> ... | ... | None
  - Remove Union import

- vcs-versioning/src/vcs_versioning/_types.py:
  - PathT: Union[PathLike, str] -> PathLike | str
  - Remove Union import

- vcs-versioning/src/vcs_versioning/_dump_version.py:
  - Template: Union[int, str] -> int | str
  - Template: Union[str, None] -> str | None
  - Remove Tuple, Union imports from template
  - Add 'from __future__ import annotations' to generated .py template

Generated version files now include future annotations for backward compatibility
with Python 3.10+ pipe operator syntax.

Author: RonnyPfannschmidt

vcs-versioning/src/vcs_versioning/_dump_version.py

@@ -20,6 +20,7 @@
     ".py": """\
 # file generated by vcs-versioning
 # don't change, don't track in version control
+from __future__ import annotations
 
 __all__ = [
     "__version__",
@@ -32,11 +33,8 @@
 
 TYPE_CHECKING = False
 if TYPE_CHECKING:
-    from typing import Tuple
-    from typing import Union
-
-    VERSION_TUPLE = Tuple[Union[int, str], ...]
-    COMMIT_ID = Union[str, None]
+    VERSION_TUPLE = tuple[int | str, ...]
+    COMMIT_ID = str | None
 else:
     VERSION_TUPLE = object
     COMMIT_ID = object

vcs-versioning/src/vcs_versioning/_pyproject_reading.py

@@ -9,7 +9,7 @@
 from collections.abc import Sequence
 from dataclasses import dataclass
 from pathlib import Path
-from typing import TypeAlias, Union
+from typing import TypeAlias
 
 if sys.version_info >= (3, 11):
     from typing import Self
@@ -27,9 +27,9 @@
 DEFAULT_PYPROJECT_PATH = Path("pyproject.toml")
 
 # Testing injection type for configuration reading
-GivenPyProjectResult: TypeAlias = Union[
-    "PyProjectData", InvalidTomlError, FileNotFoundError, None
-]
+GivenPyProjectResult: TypeAlias = (
+    "PyProjectData" | InvalidTomlError | FileNotFoundError | None
+)
 
 
 @dataclass

vcs-versioning/src/vcs_versioning/_run_cmd.py

@@ -7,19 +7,10 @@
 import textwrap
 import warnings
 from collections.abc import Callable, Mapping, Sequence
-from typing import TYPE_CHECKING, TypeVar, overload
+from typing import TypeVar, overload
 
 from . import _types as _t
 
-if TYPE_CHECKING:
-    BaseCompletedProcess = subprocess.CompletedProcess[str]
-else:
-    BaseCompletedProcess = subprocess.CompletedProcess
-
-# pick 40 seconds
-# unfortunately github CI for windows sometimes needs
-# up to 30 seconds to start a command
-
 
 def _get_timeout(env: Mapping[str, str]) -> int:
     """Get subprocess timeout from override context or environment.
@@ -38,10 +29,10 @@ def _get_timeout(env: Mapping[str, str]) -> int:
 T = TypeVar("T")
 
 
-class CompletedProcess(BaseCompletedProcess):
+class CompletedProcess(subprocess.CompletedProcess[str]):
     @classmethod
     def from_raw(
-        cls, input: BaseCompletedProcess, strip: bool = True
+        cls, input: subprocess.CompletedProcess[str], strip: bool = True
     ) -> CompletedProcess:
         return cls(
             args=input.args,

vcs-versioning/src/vcs_versioning/_types.py

@@ -2,12 +2,12 @@
 
 import os
 from collections.abc import Callable, Sequence
-from typing import TYPE_CHECKING, TypeAlias, Union
+from typing import TYPE_CHECKING, TypeAlias
 
 if TYPE_CHECKING:
     from . import _version_schemes as version
 
-PathT: TypeAlias = Union["os.PathLike[str]", str]
+PathT: TypeAlias = "os.PathLike[str]" | str
 
 CMD_TYPE: TypeAlias = Sequence[PathT] | str